BindingBase.StringFormat BindingBase.StringFormat BindingBase.StringFormat BindingBase.StringFormat Property

Definition

Ruft eine Zeichenfolge ab, die angibt, wie die Bindung formatiert werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt, oder legt diese fest.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

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 werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt.A string that specifies how to format the binding if it displays the bound value as a string.

Beispiele

Im folgenden Beispiel wird StringFormat Doubledie-Eigenschaft verwendet Price, um in eine Zeichenfolge zu konvertieren, die eine Währung darstellt.The following example uses the StringFormat property to convert Price, which is a Double, to a string that represents a currency.

<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 auf MultiBinding einem verwendet, um eine Zeichenfolge Description zu Price erstellen, die die und ListBoxder einzelnen Elemente in einem enthält.The following example uses the StringFormat property on a MultiBinding to build a string that includes the Description and Price of each item in a ListBox.

<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

StringFormatkann ein vordefiniertes, zusammengesetztes oder benutzerdefiniertes Zeichen folgen Format sein.StringFormat can be a predefined, composite, or custom string format. Weitere Informationen zu Zeichen folgen Formaten finden Sie unter Formatieren von Typen.For more information about string formats, see Formatting Types.

Wenn Sie die- Converter Eigenschaft StringFormat und die-Eigenschaft festlegen, wird der Konverter zuerst auf den Datenwert angewendet StringFormat , und dann wird der angewendet.If you set the Converter and StringFormat properties, the converter is applied to the data value first, and then the StringFormat is applied.

Wenn Sie für ein StringFormat -Format Binding für ein zusammengesetztes Zeichen folgen Format festlegen, können Sie nur einen Parameter angeben.When you set the StringFormat on a Binding to a composite string format, you can specify only one parameter.

Wenn Sie einen MultiBindingverwenden, wird StringFormat die-Eigenschaft nur angewendet, wenn MultiBindingSie für festgelegt ist.When you use a MultiBinding, the StringFormat property applies only when it is set on the MultiBinding. Der Wert von StringFormat , der für Binding alle untergeordneten Objekte festgelegt wird, wird ignoriert.The value of StringFormat that is set on any child Binding objects is ignored. Die Anzahl von Parametern in einem zusammengesetzten Zeichen folgen Format darf die Anzahl Binding der untergeordneten MultiBindingObjekte in der nicht überschreiten.The number of parameters in a composite string format cannot exceed the number of child Binding objects in the MultiBinding.

Wenn Sie einen PriorityBindingverwenden, können Sie StringFormat für die PriorityBinding, für untergeordnete Bindungs Objekte oder für beides festlegen.When you use a PriorityBinding, you can set the StringFormat on the PriorityBinding, on child binding objects, or both. Wenn für die angewendete untergeordnete Bindung festgelegt wird,wirddieserWertverwendet.StringFormatIf the StringFormat is set on the child binding that is applied, that value is used. Wenn für die angewendete untergeordnete Bindung nicht festgelegt StringFormat PriorityBindingist, wird der von angewendet, wenn er festgelegt ist. StringFormatIf the StringFormat is not set on the child binding that is applied, the StringFormat of the PriorityBinding is applied if it is set.

Gilt für: