BindingBase.StringFormat Tulajdonság

Definíció

Névtér:

System.Windows.Data

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállít egy sztringet, amely meghatározza a kötés formázását, ha a kötött értéket sztringként jeleníti meg.

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

Tulajdonság értéke

String

Egy sztring, amely meghatározza, hogyan formázhatja a kötést, ha a kötött értéket sztringként jeleníti meg.

Példák

Az alábbi példa a tulajdonságot használja a StringFormat pénznemet képviselő sztringre való konvertáláshozPriceDouble.

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

Az alábbi példa az StringFormat a MultiBinding tulajdonságot használja egy olyan sztring létrehozására, amely tartalmazza az Description egyes elemeket Price egy 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>

Megjegyzések

StringFormat lehet előre definiált, összetett vagy egyéni sztringformátum. A sztringformátumokról további információt a Formázástípusok című témakörben talál.

Ha beállítja a tulajdonságokat és Converter a StringFormat tulajdonságokat, a konverter először az adatértékre lesz alkalmazva, majd a rendszer alkalmazza a StringFormat konvertert.

Ha összetett sztringformátumra StringFormat állítja be a Binding paramétert, csak egy paramétert adhat meg.

Ha egy tulajdonságot MultiBindinghasznál, a StringFormat tulajdonság csak akkor érvényes, ha az a MultiBinding. A gyermekobjektumokon StringFormat beállított érték Binding figyelmen kívül lesz hagyva. Az összetett sztringformátumban lévő paraméterek száma nem haladhatja meg a gyermekobjektumok Binding számát a MultiBinding.

Ha használ egy PriorityBinding, beállíthatja a StringFormat be- és a PriorityBindinggyermekkötési objektumokat, vagy mindkettőt. Ha az StringFormat alkalmazott gyermekkötésen van beállítva, a rendszer ezt az értéket használja. Ha az StringFormat alkalmazott gyermekkötés nincs beállítva, a StringFormat rendszer a gyermek kötését PriorityBinding alkalmazza, ha be van állítva.

Ha a formázási sztring a { karakterrel kezdődik, az XAML-elemző összezavarja azt egy korrektúrakiterjesztés esetében. A kétértelműség elkerülése érdekében helyezze el a formázási sztring elé egy üres kapcsos zárójelet.