BindingBase.StringFormat Properti

Definisi

Ruang nama:

System.Windows.Data

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur string yang menentukan cara memformat pengikatan jika menampilkan nilai terikat sebagai string.

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

Nilai Properti

String

String yang menentukan cara memformat pengikatan jika menampilkan nilai terikat sebagai string.

Contoh

Contoh berikut menggunakan StringFormat properti untuk mengonversi Price, yang merupakan Double, ke string yang mewakili mata uang.

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

Contoh berikut menggunakan StringFormat properti pada MultiBinding untuk membangun string yang menyertakan Description dan Price dari setiap item dalam 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>

Keterangan

StringFormat dapat berupa format string yang telah ditentukan, komposit, atau kustom. Untuk informasi selengkapnya tentang format string, lihat Jenis Pemformatan.

Jika Anda mengatur Converter properti dan StringFormat , konverter diterapkan ke nilai data terlebih dahulu, lalu StringFormat diterapkan.

Saat Anda mengatur StringFormat pada Binding format untai (karakter) ke komposit, Anda hanya dapat menentukan satu parameter.

Saat Anda menggunakan MultiBinding, StringFormat properti hanya berlaku saat diatur pada MultiBinding. Nilai StringFormat yang diatur pada objek anak Binding apa pun diabaikan. Jumlah parameter dalam format string komposit tidak boleh melebihi jumlah objek anak Binding di MultiBinding.

Saat Anda menggunakan PriorityBinding, Anda dapat mengatur StringFormat pada PriorityBinding, pada objek pengikatan anak, atau keduanya. StringFormat Jika diatur pada pengikatan anak yang diterapkan, nilai tersebut akan digunakan. StringFormat Jika tidak diatur pada pengikatan anak yang diterapkan, StringFormat dari PriorityBinding diterapkan jika diatur.

Jika string format dimulai dengan { karakter , pengurai XAML akan membingungkannya untuk ekstensi markup. Untuk menghindari ambiguitas ini, awali string format dengan sekumpulan kurung kurawal kosong.