BindingBase.StringFormat Propriété

Définition

Obtient ou définit une chaîne qui spécifie comment mettre en forme la liaison si elle affiche la valeur liée en tant que chaîne.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

Valeur de propriété

String

Chaîne qui spécifie comment mettre en forme la liaison si elle affiche la valeur liée en tant que chaîne.A string that specifies how to format the binding if it displays the bound value as a string.

Exemples

L’exemple suivant utilise la StringFormat propriété pour convertir Price , qui est un Double , en une chaîne qui représente une devise.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>

L’exemple suivant utilise la StringFormat propriété sur un MultiBinding pour générer une chaîne qui comprend le Description et Price de chaque élément dans un 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>

Remarques

StringFormat peut être un format de chaîne prédéfini, composite ou personnalisé.StringFormat can be a predefined, composite, or custom string format. Pour plus d’informations sur les formats de chaîne, consultez mise en forme des types.For more information about string formats, see Formatting Types.

Si vous définissez les Converter StringFormat Propriétés et, le convertisseur est appliqué en premier à la valeur de données, puis StringFormat est appliqué.If you set the Converter and StringFormat properties, the converter is applied to the data value first, and then the StringFormat is applied.

Lorsque vous affectez StringFormat à un Binding au format de chaîne composite, vous ne pouvez spécifier qu’un seul paramètre.When you set the StringFormat on a Binding to a composite string format, you can specify only one parameter.

Lorsque vous utilisez un MultiBinding , la StringFormat propriété s’applique uniquement quand elle est définie sur le MultiBinding .When you use a MultiBinding, the StringFormat property applies only when it is set on the MultiBinding. La valeur de StringFormat définie pour tous les objets enfants Binding est ignorée.The value of StringFormat that is set on any child Binding objects is ignored. Le nombre de paramètres dans un format de chaîne composite ne peut pas dépasser le nombre d' Binding objets enfants dans le MultiBinding .The number of parameters in a composite string format cannot exceed the number of child Binding objects in the MultiBinding.

Lorsque vous utilisez un PriorityBinding , vous pouvez définir le StringFormat sur le PriorityBinding , sur les objets de liaison enfants, ou les deux.When you use a PriorityBinding, you can set the StringFormat on the PriorityBinding, on child binding objects, or both. Si le StringFormat est défini sur la liaison enfant appliquée, cette valeur est utilisée.If the StringFormat is set on the child binding that is applied, that value is used. Si StringFormat n’est pas défini sur la liaison enfant appliquée, le StringFormat du PriorityBinding est appliqué s’il est défini.If the StringFormat is not set on the child binding that is applied, the StringFormat of the PriorityBinding is applied if it is set.

S’applique à