Classe DependencyProperty (System.Windows)

Un oggetto DependencyProperty supporta le funzionalità seguenti in Windows Presentation Foundation (WPF):

• La proprietà può essere impostata in uno stile. Per ulteriori informazioni, vedere Styling and Templating.

• La proprietà può essere impostata attraverso l'associazione di dati. Per le ulteriori informazioni sulle proprietà di dipendenza con associazione dati, vedere How to: Bind the Properties of Two Controls.

• La proprietà può essere impostata mediante un riferimento a una risorsa dinamica. Per ulteriori informazioni, vedere Resources Overview.

• La proprietà può ereditare il suo valore automaticamente da un elemento padre nella struttura ad albero dell'elemento. Per ulteriori informazioni, vedere Property Value Inheritance.

• La proprietà può essere animata. Per ulteriori informazioni, vedere Animation Overview.

• La proprietà può creare un rapporto quando il valore precedente della proprietà è stato modificato e il valore della proprietà può essere assegnato. Per ulteriori informazioni, vedere Dependency Property Callbacks and Validation.

• La proprietà riporta informazioni a WPF, ad esempio segnala se la modifica di un valore di proprietà richiede che il sistema di layout ricomponga gli elementi visivi di un elemento.

• La proprietà riceve supporto in WPF Designer per Visual Studio. Ad esempio, la proprietà può essere modificata nella finestra Proprietà.

Per ulteriori informazioni sulle proprietà di dipendenza, vedere Dependency Properties Overview. Se si desidera che le proprietà sui tipi personalizzati supportino le funzionalità dell'elenco precedente, è necessario creare una proprietà di dipendenza. Per informazioni su come creare le proprietà di dipendenza personalizzate, vedere Custom Dependency Properties.

Una proprietà associata consente a qualsiasi oggetto di fornire informazioni sul tipo che definisce la proprietà stessa. In WPF qualsiasi tipo che eredita da DependencyObject può utilizzare una proprietà associata indipendentemente dal fatto che il tipo erediti o meno dal tipo che definisce la proprietà. Una proprietà associata è una funzionalità del linguaggio XAML. Per impostare una proprietà associata in XAML, utilizzare la sintassi ownerType.propertyName. Un esempio di proprietà associata è la proprietà DockPanel.Dock. Se si desidera creare una proprietà che può essere utilizzata su tutti i tipi DependencyObject, è necessario definire una proprietà associata. Per ulteriori informazioni sulle proprietà associate e su come crearle, vedere Attached Properties Overview.

This example shows how to back a common language runtime (CLR) property with a DependencyProperty field, thus defining a dependency property. When you define your own properties and want them to support many aspects of Windows Presentation Foundation (WPF) functionality, including styles, data binding, inheritance, animation, and default values, you should implement them as a dependency property.

The following example first registers a dependency property by calling the Register method. The name of the identifier field that you use to store the name and characteristics of the dependency property must be the Name you chose for the dependency property as part of the Register call, appended by the literal string Property. For instance, if you register a dependency property with a Name of Location, then the identifier field that you define for the dependency property must be named LocationProperty.

In this example, the name of the dependency property and its CLR accessor is State; the identifier field is StateProperty; the type of the property is Boolean; and the type that registers the dependency property is MyStateControl.

If you fail to follow this naming pattern, designers might not report your property correctly, and certain aspects of property system style application might not behave as expected.

You can also specify default metadata for a dependency property. This example registers the default value of the State dependency property to be false.

  Public Class MyStateControl
	  Inherits ButtonBase
	Public Sub New()
		MyBase.New()
	End Sub
	Public Property State() As Boolean
	  Get
		  Return CType(Me.GetValue(StateProperty), Boolean)
	  End Get
	  Set(ByVal value As Boolean)
		  Me.SetValue(StateProperty, value)
	  End Set
	End Property
	Public Shared ReadOnly StateProperty As DependencyProperty = DependencyProperty.Register("State", GetType(Boolean), GetType(MyStateControl),New PropertyMetadata(False))
  End Class

public class MyStateControl : ButtonBase
{
  public MyStateControl() : base() { }
  public Boolean State
  {
    get { return (Boolean)this.GetValue(StateProperty); }
    set { this.SetValue(StateProperty, value); } 
  }
  public static readonly DependencyProperty StateProperty = DependencyProperty.Register(
    "State", typeof(Boolean), typeof(MyStateControl),new PropertyMetadata(false));
}

For more information about how and why to implement a dependency property, as opposed to just backing a CLR property with a private field, see Dependency Properties Overview.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse