BindingBase.StringFormat Właściwość

Definicja

Pobiera lub ustawia ciąg określający sposób formatowania powiązania w przypadku wyświetlenia wartości powiązanej jako ciągu.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

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 w przypadku wyświetlenia wartości powiązanej jako ciągu.A string that specifies how to format the binding if it displays the bound value as a string.

Przykłady

W poniższym przykładzie zastosowano StringFormat Właściwość do konwersji Price , czyli Double do ciągu, który reprezentuje walutę.The following example uses the StringFormat property to convert Price, which is a Double, to a string that represents a currency.

<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 zastosowano StringFormat Właściwość w MultiBinding celu skompilowania ciągu, który zawiera Description i Price dla każdego elementu w ListBox .The following example uses the StringFormat property on a MultiBinding to build a string that includes the Description and Price of each item in a 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 to być wstępnie zdefiniowany, kompozytowy lub niestandardowy format ciągu.StringFormat can be a predefined, composite, or custom string format. Aby uzyskać więcej informacji na temat formatów ciągów, zobacz Typy formatowania.For more information about string formats, see Formatting Types.

Jeśli ustawisz Converter właściwości i StringFormat , konwerter zostanie zastosowany do wartości danych jako pierwszy, a następnie StringFormat zostanie zastosowany.If you set the Converter and StringFormat properties, the converter is applied to the data value first, and then the StringFormat is applied.

Po ustawieniu na wartość w StringFormat Binding formacie ciągu złożonego, można określić tylko jeden parametr.When you set the StringFormat on a Binding to a composite string format, you can specify only one parameter.

Gdy używasz MultiBinding , StringFormat Właściwość ma zastosowanie tylko wtedy, gdy jest ustawiona na MultiBinding .When you use a MultiBinding, the StringFormat property applies only when it is set on the MultiBinding. Wartość StringFormat , która jest ustawiona na dowolnym obiekcie podrzędnym, Binding jest ignorowana.The value of StringFormat that is set on any child Binding objects is ignored. Liczba parametrów w formacie złożonego ciągu nie może przekraczać liczby Binding obiektów podrzędnych w elemencie MultiBinding .The number of parameters in a composite string format cannot exceed the number of child Binding objects in the MultiBinding.

W przypadku użycia PriorityBinding , można ustawić StringFormat na PriorityBinding , w obiektach powiązania podrzędnego lub w obu tych elementach.When you use a PriorityBinding, you can set the StringFormat on the PriorityBinding, on child binding objects, or both. Jeśli StringFormat jest ustawiona dla powiązania podrzędnego, które jest stosowane, ta wartość jest używana.If the StringFormat is set on the child binding that is applied, that value is used. Jeśli StringFormat nie jest ustawiona w powiązaniu podrzędnym, które jest stosowane, StringFormat PriorityBinding jest stosowana, jeśli jest ustawiona.If the StringFormat is not set on the child binding that is applied, the StringFormat of the PriorityBinding is applied if it is set.

Dotyczy