Binding.Path Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Data

Mendapatkan atau mengatur jalur ke properti sumber pengikatan.

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

PropertyPath Path();

void Path(PropertyPath value);

public PropertyPath Path { get; set; }

var propertyPath = binding.path;
binding.path = propertyPath;

Public Property Path As PropertyPath

<Binding Path="propertyPath"/>

Nilai Properti

PropertyPath

Jalur properti untuk sumber pengikatan.

Contoh

XAML berikut menunjukkan cara mengatur Jalur menggunakan ekstensi markup {Binding}. Untuk daftar kode lengkap, lihat sampel pengikatan data XAML.

<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. -->
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

XAML berikut menunjukkan cara mengatur Jalur menggunakan bilangan bulat dan pengindeks string. Untuk daftar kode lengkap, lihat sampel pengikatan data XAML.

Catatan

Ekstensi komponen Visual C++ (C++/CX) saat ini tidak mendukung pengikatan pengindeks. Lihat sampel untuk solusinya.

<StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team name:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3].Name}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5" />

  </StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team manager:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3][Gaffer]}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5"/>

  </StackPanel>

</StackPanel>

Keterangan

Jalur dapat menjadi properti langsung dari objek sumber, atau sub-properti objek yang Anda lalui menggunakan sintaks jalur properti. Untuk sumber data Microsoft .NET, jalur juga dapat menggunakan sintaks pengindeks untuk mereferensikan item tertentu dalam koleksi. Untuk detail tentang format jalur properti, lihat Sintaks jalur properti.

Untuk mengatur sumber data menjadi objek Sumber , jalur harus ditentukan dengan string kosong ("").

Saat menggunakan ekstensi markup {Binding}, nilai Jalur dapat diatur menggunakan argumen segera setelah {Binding bagian dari penggunaan ekstensi, Anda tidak perlu secara eksplisit menyertakan Path=. Misalnya, {Binding Albums} mengatur nilai Jalur pengikatan tersebut menjadi PropertyPath yang dibangun dari string "Albums" (tidak ada properti Pengikatan lain yang diatur).

Sebagian besar penggunaan Path melibatkan pengaturan nilainya. Untuk skenario di mana Anda mendapatkan nilai untuk memeriksa properti pengikatan yang ada, nilai PropertyPath.Path berisi string yang mewakili jalur.

Anda tidak dapat mengatur nilai properti objek Pengikatan setelah pengikatan tersebut dilampirkan ke elemen target dan properti target. Jika Anda mencoba ini, Anda akan mendapatkan pengecualian run-time.

Lihat juga

• PropertyPath
• Sampel pengikatan data XAML
• Pengikatan data secara mendalam