BindingBase.StringFormat Proprietà

Definizione

Spazio dei nomi:

System.Windows.Data

Assembly:

PresentationFramework.dll

Ottiene o imposta una stringa che specifica come formattare l'associazione se il valore associato viene visualizzato come stringa.

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à

String

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

Esempio

Nell'esempio seguente viene usata la StringFormat proprietà per convertire Price, ovvero , in una Doublestringa 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 usata la StringFormat proprietà in un oggetto per compilare una MultiBinding stringa che include e Description Price di ogni elemento in un ListBoxoggetto .

<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 stringa predefinito, composito o personalizzato. Per altre informazioni sui formati di stringa, vedere Tipi di formattazione.

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

Quando si imposta l'oggetto StringFormat su un Binding formato stringa composito, è possibile specificare un solo parametro.

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

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

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