BindingBase.StringFormat Özellik

Tanım

Ad Alanı:

System.Windows.Data

Bütünleştirilmiş Kod:

PresentationFramework.dll

İlişkili değeri dize olarak görüntülerse bağlamanın nasıl biçimlendirildiğini belirten bir dize alır veya ayarlar.

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

Özellik Değeri

String

Bağlı değeri dize olarak görüntülerse bağlamanın nasıl biçimlendirildiğini belirten dize.

Örnekler

Aşağıdaki örnek, özelliğini kullanarak StringFormat bir para birimini temsil eden bir Doubledize olan öğesini dönüştürürPrice.

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

Aşağıdaki örnek, içindeki MultiBinding her öğenin ListBoxve Price öğesini içeren Description bir dize oluşturmak için üzerindeki özelliğini kullanırStringFormat.

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

Açıklamalar

StringFormat önceden tanımlanmış, bileşik veya özel bir dize biçimi olabilir. Dize biçimleri hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

ve StringFormat özelliklerini ayarlarsanızConverter, dönüştürücü önce veri değerine uygulanır ve ardından StringFormat uygulanır.

üzerinde Binding değerini StringFormat bileşik dize biçimine ayarladığınızda, yalnızca bir parametre belirtebilirsiniz.

kullandığınızda MultiBinding, StringFormat özelliği yalnızca üzerinde MultiBindingayarlandığında uygulanır. Herhangi bir alt Binding nesnede ayarlanan değeri StringFormat yoksayılır. Bileşik dize biçimindeki parametre sayısı, içindeki MultiBindingalt Binding nesne sayısını aşamaz.

kullandığınızdaPriorityBinding, alt bağlama nesnelerinde PriorityBindingveya her ikisinde de öğesini ayarlayabilirsinizStringFormat. StringFormat uygulanan alt bağlamada ayarlanırsa, bu değer kullanılır. StringFormat uygulanan alt bağlamada ayarlanmazsa, StringFormat ayarlandıysa öğesinin PriorityBinding öğesi uygulanır.

Biçim dizesi karakterle { başlıyorsa, XAML ayrıştırıcısı biçimlendirme uzantısıyla karıştırır. Bu belirsizliği önlemek için biçim dizesine boş bir küme ayracı kümesi ekleyin.