BindingBase.StringFormat Eigenschaft

Definition

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Ruft eine Zeichenfolge ab, die angibt, wie die Bindung formatiert werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt, oder legt diese fest.

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

String

Eine Zeichenfolge, die angibt, wie die Bindung formatiert werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt.

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 Eigenschaft für eine MultiBinding Zeichenfolge verwendet, die die Description StringFormat einzelnen Price Elemente in einem ListBoxElement 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 StringFormat Eigenschaften festlegen, wird der Konverter zuerst auf den Datenwert angewendet und dann angewendet StringFormat .

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

Wenn Sie eine MultiBindingVerwendung verwenden, gilt die StringFormat Eigenschaft nur, wenn sie auf dem MultiBindingWert festgelegt ist. Der Wert, der StringFormat für alle untergeordneten Binding Objekte festgelegt ist, wird ignoriert. Die Anzahl der Parameter in einem zusammengesetzten Zeichenfolgenformat kann die Anzahl der untergeordneten Binding Objekte in der MultiBinding.

Wenn Sie eine PriorityBinding, sie verwenden, können Sie das StringFormat auf dem PriorityBinding, auf untergeordneten Bindungsobjekten oder beides festlegen. Wenn die StringFormat untergeordnete Bindung festgelegt ist, die angewendet wird, wird dieser Wert verwendet. Wenn die untergeordnete Bindung, die angewendet wird, nicht festgelegt ist, wird dies StringFormat StringFormat PriorityBinding angewendet, wenn sie festgelegt ist.

Wenn die Formatzeichenfolge mit dem { Zeichen beginnt, verwechselt der XAML-Parser ihn für eine Markuperweiterung. Um diese Unklarheit zu vermeiden, präfixieren Sie die Formatzeichenfolge mit einer leeren Gruppe von geschweiften Klammern.