Binding.Path Proprietà

Definizione

Ottiene o imposta il percorso della proprietà di origine di associazione.Gets or sets the path to the binding source property.

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

Valore della proprietà

PropertyPath

Percorso dell'origine di associazione.The path to the binding source. Il valore predefinito è null.The default is null.

Esempio

Nell'esempio seguente viene illustrato un trigger di stile che crea un oggetto ToolTip che segnala un messaggio di errore di convalida.The following example shows a style trigger that creates a ToolTip that reports a validation error message. Il valore del setter viene associato al contenuto dell'errore dell'oggetto corrente TextBox ( TextBox utilizzando lo stile) utilizzando la RelativeSource Proprietà.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Per altre informazioni su questo esempio, vedere procedura: implementare la convalida dell'associazione.For more information on this example, see How to: Implement Binding Validation.

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

Commenti

Ogni Binding dispone in genere di questi quattro componenti: un oggetto di destinazione del binding, una proprietà di destinazione, un'origine di associazione e un percorso del valore nell'origine di associazione da utilizzare.Each binding typically has these four components: a binding target object, a target property, a binding source, and a path to the value in the binding source to use. Per ulteriori informazioni su questi data binding concetti, vedere Cenni preliminari sul data binding.For more information about these data binding concepts, see Data Binding Overview.

Utilizzare la Path proprietà per specificare il valore di origine a cui si desidera eseguire il binding:Use the Path property to specify the source value you want to bind to:

  • Nel caso più semplice, il Path valore della proprietà è il nome della proprietà dell'oggetto di origine da usare per l'associazione, ad esempio Path=PropertyName .In the simplest case, the Path property value is the name of the property of the source object to use for the binding, such as Path=PropertyName.

  • Le sottoproprietà di una proprietà possono essere specificate da una sintassi simile a quella usata in C#.Subproperties of a property can be specified by a syntax similar to that used in C#. Ad esempio, la clausola Path=ShoppingCart.Order imposta l'associazione sulla sottoproprietà Order dell'oggetto o la proprietà ShoppingCart.For instance, the clause Path=ShoppingCart.Order sets the binding to the subproperty Order of the object or property ShoppingCart.

  • Per eseguire l'associazione a una proprietà associata, racchiuderla tra parentesi.To bind to an attached property, place parentheses around the attached property. Ad esempio, per eseguire l'associazione alla proprietà associata DockPanel.Dock , la sintassi è Path=(DockPanel.Dock) .For example, to bind to the attached property DockPanel.Dock, the syntax is Path=(DockPanel.Dock).

  • Gli indicizzatori di una proprietà possono essere specificati all'interno di parentesi quadre dopo il nome della proprietà in cui viene applicato l'indicizzatore.Indexers of a property can be specified within square brackets following the property name where the indexer is applied. La clausola Path=ShoppingCart[0] ad esempio imposta l'associazione all'indice corrispondente al modo in cui l'indicizzazione interna della proprietà gestisce la stringa letterale "0".For instance, the clause Path=ShoppingCart[0] sets the binding to the index that corresponds to how your property's internal indexing handles the literal string "0". Sono supportati anche più indicizzatori.Multiple indexers are also supported.

  • Indicizzatori e sottoproprietà possono essere combinati in una clausola Path, ad esempio,Path=ShoppingCart.ShippingInfo[MailingAddress,Street].Indexers and subproperties can be mixed in a Path clause; for example, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • All'interno degli indicizzatori è possibile specificare più parametri di indicizzatore separati da virgole (,).Inside indexers you can have multiple indexer parameters separated by commas (,). È possibile specificare tra parentesi il tipo di ogni parametro.The type of each parameter can be specified with parentheses. È possibile ad esempio avere Path="[(sys:Int32)42,(sys:Int32)24]", dove è stato eseguito il mapping di sys allo spazio dei nomi System.For example, you can have Path="[(sys:Int32)42,(sys:Int32)24]", where sys is mapped to the System namespace.

  • Quando l'origine è una visualizzazione di raccolta, è possibile specificare l'elemento corrente con una barra (/).When the source is a collection view, the current item can be specified with a slash (/). La clausola Path=/ ad esempio imposta l'associazione all'elemento corrente nella visualizzazione.For example, the clause Path=/ sets the binding to the current item in the view. Quando l'origine è una raccolta, questa sintassi specifica l'elemento corrente della visualizzazione di raccolta predefinita.When the source is a collection, this syntax specifies the current item of the default collection view.

  • Barre e nomi di proprietà possono essere combinate per attraversare le proprietà che sono raccolte.Property names and slashes can be combined to traverse properties that are collections. Path=/Offices/ManagerName ad esempio specifica l'elemento corrente della raccolta di origine, che contiene una proprietà Offices che è anche una raccolta.For example, Path=/Offices/ManagerName specifies the current item of the source collection, which contains an Offices property that is also a collection. L'elemento corrente è un oggetto che contiene una proprietà ManagerName.Its current item is an object that contains a ManagerName property.

  • È possibile usare facoltativamente un percorso con il punto (.) per eseguire l'associazione all'origine corrente.Optionally, a period (.) path can be used to bind to the current source. Ad esempio, Text="{Binding}" equivale a Text="{Binding Path=.}".For example, Text="{Binding}" is equivalent to Text="{Binding Path=.}".

Per informazioni sulla sintassi del percorso, vedere Cenni preliminari sulle dichiarazioni di associazione o sintassi XAML di PropertyPath.For information about path syntax, see Binding Declarations Overview or PropertyPath XAML Syntax.

Per XMLXML le associazioni, vedere la XPath Proprietà.For XMLXML bindings, see the XPath property.

Per eseguire l'associazione a un intero oggetto, non è necessario specificare la Path Proprietà.To bind to an entire object, you do not need to specify the Path property. Per ulteriori informazioni, vedere "specifica del percorso del valore" in Cenni preliminari sul data binding.For more information, see "Specifying the Path to the Value" in Data Binding Overview.

Si applica a