BindingBase.StringFormat Свойство

  • Ссылка

Определение

Пространство имен:
System.Windows.Data
Сборка:
PresentationFramework.dll

Возвращает или задает строку, указывающую способ форматирования привязки при отображении связанного значения в виде строки.

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

Значение свойства

String

Строка, указывающая способ форматирования привязки при отображении связанного значения в виде строки.

Примеры

В следующем примере свойство используется StringFormat для преобразования Price, являющегося строкой Double, представляющей валюту.

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

В следующем примере свойство используется StringFormat для MultiBinding построения строки, включающей Description и Price каждый элемент в элементе 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>

Комментарии

StringFormat может быть предопределенным, составным или настраиваемым форматом строки. Дополнительные сведения о строковых форматах см. в разделе "Типы форматирования".

Если заданы Converter свойства и StringFormat свойства, преобразователь сначала применяется к значению данных, а затем StringFormat применяется.

При установке StringFormat Binding для составного строкового формата можно указать только один параметр.

При использовании MultiBindingStringFormat свойства применяется только в том случае, если оно задано в .MultiBinding Значение, заданное StringFormat для всех дочерних Binding объектов, игнорируется. Число параметров в составном строковом формате не может превышать число дочерних Binding объектов в .MultiBinding

При использовании PriorityBindingобъекта можно задать для объектов привязки StringFormat дочерних PriorityBindingобъектов или обоих объектов. StringFormat Если задано для применяемой дочерней привязки, используется это значение. StringFormat Если он не задан для применяемой дочерней привязки, StringFormat PriorityBinding он применяется, если он задан.

Если строка форматирования начинается с символа { , средство синтаксического анализа XAML будет путать его с расширением разметки. Чтобы избежать неоднозначности, префиксируйте строку формата с пустым набором фигурных скобок.

Применяется к