Binding.Path Properti

Definisi

Ruang nama:

System.Windows.Data

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur jalur ke properti sumber pengikatan.

public:
 property System::Windows::PropertyPath ^ Path { System::Windows::PropertyPath ^ get(); void set(System::Windows::PropertyPath ^ value); };

public System.Windows.PropertyPath Path { get; set; }

member this.Path : System.Windows.PropertyPath with get, set

Public Property Path As PropertyPath

Nilai Properti

PropertyPath

Jalur ke sumber pengikatan. Defaultnya adalah null.

Contoh

Contoh berikut menunjukkan pemicu gaya yang membuat yang ToolTip melaporkan pesan kesalahan validasi. Nilai setter mengikat ke konten kesalahan saat ini TextBox ( TextBox menggunakan gaya) menggunakan RelativeSource properti . Untuk informasi selengkapnya tentang contoh ini, lihat Cara: Menerapkan Validasi Pengikatan.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Keterangan

Setiap pengikatan biasanya memiliki empat komponen ini: objek target pengikatan, properti target, sumber pengikatan, dan jalur ke nilai di sumber pengikatan yang akan digunakan. Untuk informasi selengkapnya tentang konsep pengikatan data ini, lihat Gambaran Umum Pengikatan Data.

Path Gunakan properti untuk menentukan nilai sumber yang ingin Anda ikat:

• Dalam kasus paling sederhana, Path nilai properti adalah nama properti objek sumber yang akan digunakan untuk pengikatan, seperti Path=PropertyName.

• Subproperti properti dapat ditentukan oleh sintaks yang mirip dengan yang digunakan dalam C#. Misalnya, klausa Path=ShoppingCart.Order mengatur pengikatan ke subproperti Order objek atau properti ShoppingCart.

• Untuk mengikat properti terlampir, tempatkan tanda kurung di sekitar properti terlampir. Misalnya, untuk mengikat ke properti DockPanel.Dockterlampir , sintaksnya adalah Path=(DockPanel.Dock).

• Pengindeks properti dapat ditentukan dalam tanda kurung siku mengikuti nama properti tempat pengindeks diterapkan. Misalnya, klausa Path=ShoppingCart[0] mengatur pengikatan ke indeks yang sesuai dengan bagaimana pengindeksan internal properti Anda menangani string harfiah "0". Beberapa pengindeks juga didukung.

• Pengindeks dan subproperti dapat dicampur dalam Path klausul; misalnya, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Di dalam pengindeks, Anda dapat memiliki beberapa parameter pengindeks yang dipisahkan oleh koma (,). Jenis setiap parameter dapat ditentukan dengan tanda kurung. Misalnya, Anda dapat memiliki Path="[(sys:Int32)42,(sys:Int32)24]", di mana sys dipetakan ke System namespace layanan.

• Ketika sumber adalah tampilan koleksi, item saat ini dapat ditentukan dengan garis miring (/). Misalnya, klausa Path=/ mengatur pengikatan ke item saat ini dalam tampilan. Ketika sumber adalah koleksi, sintaks ini menentukan item saat ini dari tampilan koleksi default.

• Nama properti dan garis miring dapat dikombinasikan untuk melintasi properti yang merupakan koleksi. Misalnya, Path=/Offices/ManagerName menentukan item koleksi sumber saat ini, yang berisi Offices properti yang juga merupakan koleksi. Item saat ini adalah objek yang berisi ManagerName properti.

• Secara opsional, jalur titik (.) dapat digunakan untuk mengikat ke sumber saat ini. Misalnya, Text="{Binding}" setara dengan Text="{Binding Path=.}".

Untuk informasi tentang sintaks jalur, lihat Gambaran Umum Deklarasi Pengikatan atau Sintaks PropertyPath XAML.

Untuk pengikatan XML, lihat XPath properti .

Untuk mengikat ke seluruh objek, Anda tidak perlu menentukan Path properti . Untuk informasi selengkapnya, lihat "Menentukan Jalur ke Nilai" di Gambaran Umum Pengikatan Data.