Binding.Path Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Data

Ruft den Pfad zur Bindungsquelleneigenschaft fest ab oder legt diesen fest.

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

Eigenschaftswert

PropertyPath

Der Eigenschaftspfad für die Quelle der Bindung.

Beispiele

Der folgende XAML-Code veranschaulicht, wie der Pfad mithilfe der {Binding}-Markuperweiterung festgelegt wird. Eine vollständige Codeauflistung finden Sie im XAML-Datenbindungsbeispiel.

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

Der folgende XAML-Code veranschaulicht, wie der Pfad mithilfe von Ganzzahl- und Zeichenfolgenindexern festgelegt wird. Eine vollständige Codeauflistung finden Sie im XAML-Datenbindungsbeispiel.

Hinweis

Visual C++-Komponentenerweiterungen (C++/CX) unterstützen derzeit keine Indexerbindung. Eine Problemumgehung finden Sie im Beispiel.

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

Hinweise

Der Pfad kann eine direkte Eigenschaft des Quellobjekts oder untergeordnete Eigenschaften des Objekts sein, zu dem Sie mithilfe der Eigenschaftenpfadsyntax navigieren. Für Microsoft .NET-Datenquellen können Pfade auch eine Indexersyntax verwenden, um auf bestimmte Elemente in einer Sammlung zu verweisen. Ausführliche Informationen zum Format des Eigenschaftenpfads finden Sie unter Eigenschaftenpfadsyntax.

Um die Datenquelle auf das Source-Objekt festzulegen, muss der Pfad mit einer leeren Zeichenfolge ("") definiert werden.

Bei Verwendung der {Binding}-Markuperweiterung kann der Path-Wert mithilfe des Arguments festgelegt werden, das unmittelbar nach dem {Binding Teil der Erweiterungsverwendung folgt. Sie müssen nicht explizit einschließen Path=. Legt beispielsweise den Path-Wert dieser Bindung auf einen PropertyPath fest, {Binding Albums} der aus der Zeichenfolge "Alben" erstellt wird (es werden keine anderen Bindungseigenschaften festgelegt).

Bei den meisten Verwendungen von Path wird der Wert festgelegt. In Szenarien, in denen Sie den Wert abrufen, um die Eigenschaften einer vorhandenen Bindung zu untersuchen, enthält der PropertyPath.Path-Wert die Zeichenfolge, die den Pfad darstellt.

Sie können die Eigenschaftswerte eines Binding-Objekts nicht festlegen, nachdem diese Bindung an ein Zielelement und eine Zieleigenschaft angefügt wurde. Wenn Sie dies versuchen, erhalten Sie eine Laufzeit-Ausnahme.

Weitere Informationen

• PropertyPath
• XAML-Datenbindungsbeispiel
• Datenbindung im Detail