BindingBase.StringFormat Egenskap

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

Egenskapsvärde

En sträng som anger hur bindningen ska formateras om den visar det bundna värdet som en sträng.

Exempel

I följande exempel används StringFormat egenskapen för att konvertera Price, som är en Double, till en sträng som representerar en valuta.

<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>

I följande exempel används StringFormat egenskapen på en MultiBinding för att skapa en sträng som innehåller Description och Price för varje objekt i en 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>

Kommentarer

StringFormat kan vara ett fördefinierat, sammansatt eller anpassat strängformat. Mer information om strängformat finns i Formateringstyper.

Om du anger Converter egenskaperna och StringFormat tillämpas konverteraren först på datavärdet och sedan tillämpas den StringFormat .

När du ställer in StringFormat på ett Binding till ett sammansatt strängformat kan du bara ange en parameter.

När du använder en MultiBindinggäller egenskapen StringFormat endast när den har angetts för MultiBinding. Värdet för StringFormat detta anges på underordnade Binding objekt ignoreras. Antalet parametrar i ett sammansatt strängformat får inte överskrida antalet underordnade Binding objekt i MultiBinding.

När du använder en PriorityBindingkan du ange StringFormat på , PriorityBindingför underordnade bindningsobjekt eller båda. StringFormat Om anges för den underordnade bindning som tillämpas används det värdet. StringFormat Om inte har angetts för den underordnade bindning som tillämpas StringFormat tillämpas den PriorityBinding om den har angetts.

Om formatsträngen { börjar med tecknet förvirrar XAML-parsern det för ett markeringstillägg. För att undvika den här tvetydigheten prefixar du formatsträngen med en tom uppsättning klammerparenteser.