Binding.Path Tulajdonság

Definíció

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

Lekéri vagy beállítja a kötés forrástulajdonságának elérési útját.

public:
 property System::Windows::PropertyPath ^ Path { System::Windows::PropertyPath ^ get(); void set(System::Windows::PropertyPath ^ value); };
public System.Windows.PropertyPath Path { get; set; }
member this.Path : System.Windows.PropertyPath with get, set
Public Property Path As PropertyPath

Tulajdonság értéke

PropertyPath

A kötési forrás elérési útja. 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>

Megjegyzések

Minden kötésnek általában ez a négy összetevője van: egy kötési célobjektum, egy céltulajdonság, egy kötési forrás és a használni kívánt kötésforrás értékének elérési útja. További információ ezekről az adatkötési fogalmakról: Adatkötés áttekintése.

Path A tulajdonsággal adja meg a forrásértéket, amelyhez a következőhöz szeretne kapcsolódni:

  • A legegyszerűbb esetben a Path tulajdonság értéke a kötéshez használandó forrásobjektum tulajdonságának neve, például Path=PropertyName.

  • A tulajdonság altulajdonságait a C#-ban használthoz hasonló szintaxissal adhatja meg. A záradék Path=ShoppingCart.Order például az objektum vagy tulajdonság Orderaltulajdonságához ShoppingCart állítja be a kötést.

  • A csatolt tulajdonsághoz való kötéshez zárójeleket helyezzen a csatolt tulajdonság köré. A csatolt tulajdonsághoz DockPanel.Dockvaló kötéshez például a szintaxis a következő Path=(DockPanel.Dock): .

  • Egy tulajdonság indexelői szögletes zárójelben adhatók meg az indexelőt alkalmazó tulajdonságnév után. A záradék Path=ShoppingCart[0] például beállítja a kötést az indexhez, amely megfelel annak, hogy a tulajdonság belső indexelése hogyan kezeli a "0" literális sztringet. Több indexelő is támogatott.

  • Az indexelők és az altulajdonságok vegyesek lehetnek egy Path záradékban, például Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • Az indexelőkben több indexelő paraméter is lehet vesszővel (,) elválasztva. Az egyes paraméterek típusa zárójelekkel adható meg. Megadhatja Path="[(sys:Int32)42,(sys:Int32)24]"például, hogy hol sys van leképezve a System névtér.

  • Ha a forrás gyűjteménynézet, az aktuális elem megadható perjellel (/). A záradék Path=/ például az aktuális elemhez állítja a kötést a nézetben. Ha a forrás gyűjtemény, ez a szintaxis az alapértelmezett gyűjteménynézet aktuális elemét adja meg.

  • A tulajdonságnevek és perjelek egyesíthetők a gyűjtemények által használt tulajdonságokkal. Megadja például Path=/Offices/ManagerName a forrásgyűjtemény aktuális elemét, amely egy szintén gyűjteménynek számító Offices tulajdonságot tartalmaz. Az aktuális elem egy tulajdonságot ManagerName tartalmazó objektum.

  • Ha szükséges, egy pont (.) elérési út is használható az aktuális forráshoz való kötéshez. Például a Text="{Binding}" egyenértékű a következővel: Text="{Binding Path=.}".

Az elérési út szintaxisáról további információt a Kötési deklarációk áttekintése vagy a PropertyPath XAML szintaxisa című témakörben talál.

XML-kötések esetén tekintse meg a tulajdonságot XPath .

A teljes objektumhoz való kötéshez nem kell megadnia a tulajdonságot Path . További információ: "Az érték elérési útjának megadása" az adatkötés áttekintésében.

A következőre érvényes: