Binding.RelativeSource Tulajdonság

Definíció

Névtér:
System.Windows.Data
Szerelvény:
PresentationFramework.dll

Lekéri vagy beállítja a kötési forrást a kötési cél helyéhez viszonyított helyének megadásával.

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

Tulajdonság értéke

RelativeSource

Egy RelativeSource objektum, amely megadja a használni kívánt kötésforrás relatív helyét. Az alapértelmezett érték a null.

Példák

Az alábbi példa egy stílusindítót mutat be, amely érvényesítési hibaüzenetet ToolTip küld. A beállító értéke az aktuális TextBox hibatartalomhoz (a TextBox stílus használatával) kötődik a RelativeSource tulajdonság használatával. A példával kapcsolatos további információkért lásd: Kötésérvényesítés implementálása.

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

A teljes példát a Binding Validation Sample című cikkben tekintheti meg.

Megjegyzések

Ezt a tulajdonságot általában arra használják, hogy egy objektum egyik tulajdonságát ugyanahhoz az objektumhoz egy másik tulajdonsághoz kösse, vagy hogy stílusban vagy sablonban definiáljon kötést.

Alapértelmezés szerint a kötések öröklik a tulajdonság által DataContext megadott adatkörnyezetet, ha be van állítva. A tulajdonság azonban az egyik módja annak, RelativeSource hogy explicit módon beállítsa a forrást Binding , és felülbírálja az örökölt adatkörnyezetet. További információ : Útmutató: A kötés forrásának megadása.

A Binding.ElementName tulajdonságok lehetővé Binding.Source teszik a kötés forrásának explicit beállítását is. Az egyes kötésekhez azonban csak a három tulajdonság ElementNameSourceRelativeSourceegyikét kell beállítani, vagy ütközés léphet fel. Ez a tulajdonság kivételt eredményez, ha kötési forrásütközés van.

Az XAML-információkért lásd: RelativeSource MarkupExtension.

A következőre érvényes:

Lásd még