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 StringFormatPrice, což je , Doublena ř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 objektu k MultiBinding sestavení řetězce, který obsahuje Description a Price z 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ů naleznete v tématu Typy formátování.

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

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

Pokud použijete MultiBindingvlastnost, použije se pouze v případě, StringFormat že je nastavena na objektu MultiBinding. Hodnota, která je nastavena StringFormat pro všechny podřízené Binding objekty je ignorována. Počet parametrů ve složeného řetězcovém formátu nesmí překročit počet podřízených Binding objektů v objektu MultiBinding.

Při použití objektu PriorityBinding, můžete nastavit StringFormat na PriorityBindingobjekty podřízené vazby , nebo obojí. Pokud je nastavena StringFormat na podřízenou vazbu, která se použije, použije se tato hodnota. StringFormat Pokud není nastavena na podřízenou vazbu, která je použita, StringFormat použije se, PriorityBinding pokud je nastavena.

Pokud formátovací řetězec začíná znakem { , analyzátor XAML ho zaměňuje za rozšíření značek. Abyste se této nejednoznačnosti vyhnuli, předpona řetězce formátu prázdnou sadou složených závorek.