Binding.RelativeSource Properti

Definisi

Ruang nama:

System.Windows.Data

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur sumber pengikatan dengan menentukan lokasinya relatif terhadap posisi target pengikatan.

public:
 property System::Windows::Data::RelativeSource ^ RelativeSource { System::Windows::Data::RelativeSource ^ get(); void set(System::Windows::Data::RelativeSource ^ value); };

public System.Windows.Data.RelativeSource RelativeSource { get; set; }

member this.RelativeSource : System.Windows.Data.RelativeSource with get, set

Public Property RelativeSource As RelativeSource

Nilai Properti

RelativeSource

Objek RelativeSource yang menentukan lokasi relatif sumber pengikatan yang akan digunakan. 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>

Untuk melihat contoh lengkapnya, lihat Sampel Validasi Pengikatan.

Keterangan

Properti ini biasanya digunakan untuk mengikat satu properti objek ke properti lain dari objek yang sama, atau untuk menentukan pengikatan dalam gaya atau templat.

Secara default, pengikatan mewarisi konteks data yang ditentukan oleh DataContext properti , jika telah ditetapkan. Namun, RelativeSource properti adalah salah satu cara Anda dapat secara eksplisit mengatur sumber Binding dan mengambil alih konteks data yang diwariskan. Untuk informasi selengkapnya, lihat Cara: Menentukan Sumber Pengikatan.

Properti Binding.ElementName dan Binding.Source juga memungkinkan Anda mengatur sumber pengikatan secara eksplisit. Namun, hanya salah satu dari tiga properti, , ElementName, Sourcedan RelativeSource, yang harus diatur untuk setiap pengikatan, atau konflik yang dapat terjadi. Properti ini melemparkan pengecualian jika ada konflik sumber pengikatan.

Untuk informasi XAML, lihat RelativeSource MarkupExtension.

Lihat juga

• Source