BindingBase.StringFormat Vlastnost

Definice

Obor názvů:

System.Windows.Data

Sestavení:

PresentationFramework.dll

Získá nebo nastaví řetězec, který určuje, jak formátovat vazbu, pokud zobrazí vázanou hodnotu jako řetězec.

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

Hodnota vlastnosti

String

Řetězec, který určuje, jak formátovat vazbu, pokud zobrazí vázanou hodnotu jako řetězec.

Příklady

Následující příklad používá vlastnost k převodu StringFormat Price, což je Double, na řetězec, který představuje měnu.

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

Následující příklad používá StringFormat vlastnost na sestavení MultiBinding řetězce, který obsahuje Description a Price každé položky v objektu 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>

Poznámky

StringFormat může být předdefinovaný, složený nebo vlastní formát řetězce. Další informace o formátech řetězců najdete v tématu Typy formátování.

Pokud nastavíte Converter a StringFormat vlastnosti, převaděč se nejprve použije na datnou hodnotu a použije se StringFormat .

Když nastavíte StringFormat Binding formát složeného řetězce na složeného řetězce, můžete zadat pouze jeden parametr.

Při použití MultiBinding, vlastnost platí pouze v případě, StringFormat že je nastavena na .MultiBinding Hodnota StringFormat , která je nastavena pro všechny podřízené Binding objekty, je ignorována. Počet parametrů ve složeného formátu řetězce nesmí překročit počet podřízených Binding objektů v souboru MultiBinding.

Když použijete příkaz , PriorityBindingmůžete nastavit na StringFormat podřízené PriorityBindingvazby objekty nebo obojí. Pokud je nastavena StringFormat na podřízenou vazbu, která se použije, použije se tato hodnota. StringFormat Pokud není nastavená podřízená vazba, která se použije, StringFormat PriorityBinding použije se v případě, že je nastavená.

Pokud řetězec formátu začíná znakem { , parser XAML ho zamění za rozšíření značek. Chcete-li se této nejednoznačnosti vyhnout, předpona řetězce formátu prázdnou sadou složených závorek.