Binding.Path Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Pfads zur Bindungsquelleigenschaft.
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
Der Eigenschaftspfad für die Quelle der Bindung.
Beispiele
Der folgende XAML-Code veranschaulicht, wie der Pfad mithilfe der {Binding}-Markuperweiterung festgelegt wird. Die 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 ganzzahligen Und Zeichenfolgenindexern festgelegt wird. Die vollständige Codeauflistung finden Sie im XAML-Datenbindungsbeispiel.
<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 Untereigenschaften dieses Objekts sein, die Sie mithilfe der Eigenschaftspfadsyntax durchlaufen. Für Microsoft .NET Datenquellen können Pfade auch eine Indexersyntax verwenden, um auf bestimmte Elemente in einer Auflistung zu verweisen. Ausführliche Informationen zum Eigenschaftspfadformat finden Sie unter Property-Path-Syntax.
Um die Datenquelle als Source-Objekt festzulegen, sollte der Pfad mit einer leeren Zeichenfolge ("") definiert werden.
Wenn Sie die {Binding}-Markuperweiterung verwenden, kann der Path-Wert mithilfe des Arguments festgelegt werden, das unmittelbar auf den {Binding Teil der Erweiterungsnutzung folgt, müssen Sie nicht explizit einschließen Path=. Legt z. B. den Pfadwert dieser Bindung auf einen PropertyPath fest, {Binding Albums} der aus der Zeichenfolge "Albums" erstellt wird (es werden keine anderen Bindungseigenschaften festgelegt).
Die meisten Verwendungen von Path umfassen das Festlegen des Werts. 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 versuchen, dies zu versuchen, erhalten Sie eine Laufzeit ausnahme.