BindingBase.StringFormat Özellik

Tanım

Ad Alanı:

System.Windows.Data

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bağlı değeri bir 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 bir dize olarak görüntülerse bağlamanın nasıl biçimlendirildiğini belirten bir dize.

Örnekler

Aşağıdaki örnek StringFormat özelliğini kullanarak bir olan değerini Doublepara birimini temsil eden bir dizeye 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 değerini 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ızdaMultiBindingStringFormat, ö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 değerini ayarlayabilirsinizStringFormat. StringFormat uygulanan alt bağlamada ayarlanırsa, bu değer kullanılır. StringFormat uygulanan alt bağlamada ayarlanmadıysa, StringFormat ayarlandıysa öğesinin PriorityBinding öğesi uygulanır.

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