BindingBase.StringFormat Eigenschap

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

Waarde van eigenschap

Een tekenreeks die aangeeft hoe de binding moet worden opgemaakt als de afhankelijke waarde als een tekenreeks wordt weergegeven.

Voorbeelden

In het volgende voorbeeld wordt de StringFormat eigenschap gebruikt om , een Double, te converteren Pricenaar een tekenreeks die een valuta vertegenwoordigt.

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

In het volgende voorbeeld wordt de StringFormat eigenschap op een gebruikt MultiBinding om een tekenreeks te maken die het Description ene Price item in een ListBoxbevat.

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

Opmerkingen

StringFormat kan een vooraf gedefinieerde, samengestelde of aangepaste tekenreeksindeling zijn. Zie Opmaaktypen voor meer informatie over tekenreeksindelingen.

Als u de Converter en StringFormat eigenschappen instelt, wordt het conversieprogramma eerst toegepast op de gegevenswaarde en vervolgens wordt het StringFormat toegepast.

Wanneer u de StringFormat indeling op een Binding tekenreeks instelt op een samengestelde tekenreeks, kunt u slechts één parameter opgeven.

Wanneer u een MultiBinding, de StringFormat eigenschap is alleen van toepassing wanneer deze is ingesteld op de MultiBinding. De waarde van StringFormat die waarde wordt genegeerd voor onderliggende Binding objecten. Het aantal parameters in een samengestelde tekenreeksnotatie mag het aantal onderliggende Binding objecten in de MultiBindingtekenreeks niet overschrijden.

Wanneer u een PriorityBinding, kunt u het StringFormat instellen op de, op onderliggende PriorityBindingbindingsobjecten of beide. Als de StringFormat waarde is ingesteld op de onderliggende binding die wordt toegepast, wordt die waarde gebruikt. Als de StringFormat onderliggende binding niet is ingesteld op de toegepaste onderliggende binding, wordt de StringFormat van de PriorityBinding binding toegepast als deze is ingesteld.

Als de notatietekenreeks begint met het { teken, zal de XAML-parser deze verwarren voor een markeringsextensie. Om deze dubbelzinnigheid te voorkomen, kun je de notatiereeks laten voorafgaan door een lege set accolades.