BindingBase.StringFormat Propriété

Définition

Espace de noms:

System.Windows.Data

Assembly:

PresentationFramework.dll

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.

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.

Exemples

L’exemple suivant utilise la StringFormat propriété pour convertir Price, qui est une Doublechaîne qui représente une devise.

<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 inclut le Description et Price de chaque élément d’un 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é. Pour plus d’informations sur les formats de chaîne, consultez Types de mise en forme.

Si vous définissez les propriétés et StringFormat les Converter propriétés, le convertisseur est appliqué à la valeur de données en premier, puis il StringFormat est appliqué.

Lorsque vous définissez la StringFormat valeur sur un Binding format de chaîne composite, vous ne pouvez spécifier qu’un seul paramètre.

Lorsque vous utilisez un MultiBinding, la StringFormat propriété s’applique uniquement lorsqu’elle est définie sur le MultiBinding. La valeur de celle-ci StringFormat est définie sur tous les objets enfants Binding est ignorée. Le nombre de paramètres dans un format de chaîne composite ne peut pas dépasser le nombre d’objets enfants Binding dans le MultiBinding.

Lorsque vous utilisez un PriorityBinding, vous pouvez définir la valeur sur les StringFormat PriorityBindingobjets de liaison enfant ou les deux. Si la StringFormat valeur est définie sur la liaison enfant appliquée, cette valeur est utilisée. Si le StringFormat paramètre n’est pas défini sur la liaison enfant appliquée, celui-ci StringFormat PriorityBinding est appliqué s’il est défini.

Si la chaîne de format commence par le { caractère, l’analyseur XAML le confond pour une extension de balisage. Pour éviter cette ambiguïté, préfixez la chaîne de format avec un ensemble vide d’accolades.