Binding.RelativeSource Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví zdroj vazby zadáním jeho umístění vzhledem k pozici cíle vazby.
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
Hodnota vlastnosti
Objekt RelativeSource určující relativní umístění zdroje vazby, který se má použít. Výchozí hodnota je null.
Příklady
Následující příklad ukazuje trigger stylu, který vytvoří ToolTip zprávu o chybě ověření. Hodnota setter se binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Další informace o tomto příkladu naleznete v tématu Postupy: Implementace ověřování vazby.
<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>
Pokud chcete zobrazit úplný příklad, podívejte se na ukázku ověření vazby.
Poznámky
Tato vlastnost se běžně používá k vytvoření vazby jedné vlastnosti objektu na jinou vlastnost stejného objektu nebo k definování vazby ve stylu nebo šabloně.
Vazby ve výchozím nastavení dědí kontext dat určený DataContext vlastností, pokud byla nastavena. Vlastnost je však jedním ze způsobů, RelativeSource jak explicitně nastavit zdroj Binding a přepsat zděděný kontext dat. Další informace naleznete v tématu Postupy: Určení zdroje vazby.
Binding.Source Vlastnosti Binding.ElementName také umožňují explicitně nastavit zdroj vazby. Pro každou vazbu by však měla být nastavena pouze jedna ze tří vlastností, ElementNameSourceRelativeSourcea to nebo může dojít ke konfliktu. Tato vlastnost vyvolá výjimku, pokud existuje konflikt zdroje vazby.
Informace o XAML naleznete v tématu RelativeSource MarkupExtension.