BindingBase.StringFormat Eigenschaft

public:
 property System::String ^ StringFormat { System::String ^ get(); void set(System::String ^ value); };

public string StringFormat { get; set; }

member this.StringFormat : string with get, set

Public Property StringFormat As String

Eigenschaftswert

Eine Zeichenfolge, die angibt, wie die Bindung formatiert wird, wenn der gebundene Wert als Zeichenfolge angezeigt wird.

Beispiele

Im folgenden Beispiel wird die StringFormat Eigenschaft verwendet, um eine Zeichenfolge zu konvertieren Price, die Doubleeine Währung darstellt.

<ListView ItemsSource="{StaticResource MyData}">
  <ListView.View>
    <GridView>
      <GridViewColumn DisplayMemberBinding="{Binding Path=Description}"/>
      <GridViewColumn DisplayMemberBinding="{Binding Path=Price, StringFormat=Now {0:c}!}"/>
    </GridView>
  </ListView.View>
</ListView>

Im folgenden Beispiel wird die StringFormat Eigenschaft für ein MultiBinding Objekt verwendet, um eine Zeichenfolge zu erstellen, die die Description einzelnen Price Elemente in einer ListBoxZeichenfolge enthält.

<ListBox ItemsSource="{StaticResource MyData}">

  <ListBox.ItemTemplate>
    <DataTemplate>
      <TextBlock>
        <TextBlock.Text>
          <MultiBinding  StringFormat="{}{0} -- Now only {1:C}!">
            <Binding Path="Description"/>
            <Binding Path="Price"/>
          </MultiBinding>
        </TextBlock.Text>
      </TextBlock>
    </DataTemplate>
  </ListBox.ItemTemplate>
</ListBox>

Hinweise

StringFormat kann ein vordefiniertes, zusammengesetztes oder benutzerdefiniertes Zeichenfolgenformat sein. Weitere Informationen zu Zeichenfolgenformaten finden Sie unter "Formatierungstypen".

Wenn Sie die Converter Werte und StringFormat Eigenschaften festlegen, wird der Konverter zuerst auf den Datenwert angewendet, und dann wird er StringFormat angewendet.

Wenn Sie die StringFormat Option auf Binding ein zusammengesetztes Zeichenfolgenformat festlegen, können Sie nur einen Parameter angeben.

Wenn Sie eine MultiBindingEigenschaft verwenden, gilt die StringFormat Eigenschaft nur, wenn sie für die MultiBinding. Der Wert, der StringFormat für alle untergeordneten Binding Objekte festgelegt ist, wird ignoriert. Die Anzahl der Parameter in einem zusammengesetzten Zeichenfolgenformat darf die Anzahl der untergeordneten Binding Objekte in der MultiBindingZeichenfolge nicht überschreiten.

Wenn Sie ein PriorityBindingObjekt verwenden, können Sie das Element für untergeordnete StringFormatPriorityBindingBindungsobjekte oder beides festlegen. Wenn die StringFormat für die angewendete untergeordnete Bindung festgelegt ist, wird dieser Wert verwendet. Wenn die StringFormat untergeordnete Bindung, die angewendet wird, nicht festgelegt ist, wird die StringFormat der Angewendeten PriorityBinding angewendet, wenn sie festgelegt ist.

Wenn die Formatzeichenfolge mit dem { Zeichen beginnt, verwechselt der XAML-Parser sie für eine Markuperweiterung. Um diese Mehrdeutigkeit zu vermeiden, stellen Sie der Formatzeichenfolge eine leere Gruppe von geschweiften geschweiften Klammern voran.