BindingBase.StringFormat Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Data

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia ciąg, który określa sposób formatowania powiązania, jeśli wyświetla wartość powiązaną jako ciąg.

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

Wartość właściwości

String

Ciąg określający sposób formatowania powiązania, jeśli wyświetla wartość powiązaną jako ciąg.

Przykłady

W poniższym przykładzie użyto StringFormat właściwości , aby przekonwertować Priceelement , czyli Double, na ciąg reprezentujący walutę.

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

W poniższym przykładzie użyto StringFormat właściwości na obiekcie MultiBinding , aby skompilować ciąg zawierający i Description Price każdego elementu w obiekcie 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>

Uwagi

StringFormat może być wstępnie zdefiniowanym, złożonym lub niestandardowym formatem ciągu. Aby uzyskać więcej informacji na temat formatów ciągów, zobacz Typy formatowania.

Jeśli ustawisz Converter właściwości i StringFormat , konwerter zostanie najpierw zastosowany do wartości danych, a następnie StringFormat zostanie zastosowany.

Po ustawieniu StringFormat elementu on na Binding format ciągu złożonego można określić tylko jeden parametr.

Gdy używasz MultiBindingobiektu , StringFormat właściwość ma zastosowanie tylko wtedy, gdy jest ustawiona MultiBindingna obiekcie . Wartość tej StringFormat wartości jest ustawiana na dowolnych obiektach podrzędnych Binding jest ignorowana. Liczba parametrów w formacie ciągu złożonego nie może przekraczać liczby obiektów podrzędnych Binding w obiekcie MultiBinding.

W przypadku używania PriorityBindingobiektu można ustawić StringFormat dla obiektu w PriorityBindingobiekcie , w obiektach powiązania podrzędnego lub obu tych obiektów. Jeśli właściwość StringFormat jest ustawiona na zastosowanym powiązaniu podrzędnym, zostanie użyta ta wartość. Jeśli właściwość StringFormat nie jest ustawiona dla zastosowanego powiązania podrzędnego, StringFormat zostanie zastosowana wartość , PriorityBinding jeśli zostanie ustawiona.

Jeśli ciąg formatu rozpoczyna się od { znaku, analizator XAML zdezorientuje go dla rozszerzenia znaczników. Aby uniknąć tej niejednoznaczności, przedrostek ciągu formatu z pustym zestawem nawiasów klamrowych.