BindingBase.StringFormat Proprietà

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

Valore della proprietà

Stringa che specifica come formattare l'associazione se visualizza il valore associato come stringa.

Esempio

Nell'esempio seguente viene utilizzata la StringFormat proprietà per convertire Price, ovvero , Doublein una stringa che rappresenta una valuta.

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

Nell'esempio seguente viene utilizzata la StringFormat proprietà di un MultiBinding oggetto per compilare una stringa che include e DescriptionPrice di ogni elemento in un oggetto 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>

Commenti

StringFormat può essere un formato di stringa predefinito, composito o personalizzato. Per altre informazioni sui formati stringa, vedere Formattazione dei tipi.

Se si impostano le Converter proprietà e StringFormat , il convertitore viene applicato prima al valore di dati e quindi viene applicato .StringFormat

Quando si imposta su StringFormat su un Binding formato stringa composita, è possibile specificare un solo parametro.

Quando si utilizza un MultiBindingoggetto , la StringFormat proprietà si applica solo quando è impostata su MultiBinding. Il valore di StringFormat impostato su qualsiasi oggetto figlio Binding viene ignorato. Il numero di parametri in un formato stringa composita non può superare il numero di oggetti figlio Binding in MultiBinding.

Quando si usa un PriorityBindingoggetto , è possibile impostare su StringFormatPriorityBinding, sugli oggetti di associazione figlio o su entrambi. Se l'oggetto StringFormat è impostato sull'associazione figlio applicata, viene utilizzato tale valore. Se l'oggetto StringFormat non è impostato sull'associazione figlio applicata, l'oggetto dell'oggetto StringFormatPriorityBinding viene applicato se è impostato.

Se la stringa di formato inizia con il { carattere , il parser XAML confonderà per un'estensione di markup. Per evitare questa ambiguità, anteporre alla stringa di formato un set vuoto di parentesi graffe.