Cenni preliminari sulle proprietà di dipendenza

In questo argomento si presuppone che l'utente disponga di una conoscenza di base di CLR e della programmazione orientata a oggetti. Per seguire gli esempi di questo argomento, è necessaria inoltre conoscere XAML e la modalità di scrittura delle applicazioni WPF. Per ulteriori informazioni, vedere Procedura dettagliata: introduzione a WPF.

In WPF, le proprietà vengono generalmente esposte come proprietà Common Language Runtime (CLR). A un livello di base, si potrebbe interagire direttamente con queste proprietà senza sapere che vengono implementate come una proprietà di dipendenza. Tuttavia, è necessario acquisire familiarità con alcune o tutte le funzionalità del sistema di proprietà WPF, in modo da poterle sfruttare.

Lo scopo delle proprietà di dipendenza consiste nel fornire un modo per calcolare il valore di una proprietà in base al valore di altri input. Questi potrebbero includere proprietà del sistema, quali temi e preferenze dell'utente, meccanismi di determinazione della proprietà JIT, ad esempio associazione dati e animazionio storyboard, modelli multiuso, quali risorse e stili oppure valori noti tramite relazioni padre-figlio con altri elementi della struttura ad albero dell'elemento. Inoltre, una proprietà di dipendenza può essere implementata per fornire una convalida autonoma, valori predefiniti, callback per il monitoraggio delle modifiche di altre proprietà, nonché un sistema che può assegnare valori della proprietà mediante la coercizione in base a potenziali informazioni di runtime. Le classi derivate possono anche modificare alcune caratteristiche specifiche di una proprietà esistente, eseguendo l'override dei metadati della proprietà di dipendenza invece dell'override dell'implementazione effettiva delle proprietà esistenti oppure della creazione di nuove proprietà.

Nel riferimento SDK, è possibile identificare la proprietà di dipendenza grazie alla sezione Informazioni sulle proprietà di dipendenza, presente nella pagina di riferimento gestita per quella proprietà. Nella sezione sono inclusi un collegamento al campo dell'identificatore DependencyProperty per quella proprietà di dipendenza e un elenco delle opzioni dei metadati impostati per quella proprietà, informazioni sull'override per classe e altri dettagli.

Le proprietà di dipendenza e il sistema di proprietà WPF estendono le funzionalità della proprietà fornendo un tipo che supporta una proprietà, come implementazione alternativa al modello standard di supporto della proprietà con un campo privato. Questo tipo è denominato DependencyProperty. L'altro tipo importante che definisce il sistema di proprietà WPF è DependencyObject. L'oggetto DependencyObject definisce la classe base che può essere registrata ed essere proprietario di una proprietà di dipendenza.

Di seguito viene riportato un riepilogo della terminologia utilizzata in questa documentazione Software Development Kit (SDK) per la descrizione delle proprietà di dipendenza:

• Proprietà di dipendenza: una proprietà supportata da un oggetto DependencyProperty.

• Identificatore della proprietà di dipendenza: istanza di DependencyProperty, ottenuta come valore restituito quando si registra una proprietà di dipendenza, quindi archiviata come membro statico di una classe. Questo identificatore viene utilizzato come parametro per molte API che interagiscono con il sistema delle proprietà WPF.

• "Wrapper" CLR: le effettive implementazioni ottenute e impostate della proprietà. Queste implementazioni incorporano l'identificatore della proprietà di dipendenza utilizzandolo nelle chiamate agli oggetti GetValue e SetValue, fornendo in tal modo il supporto alla proprietà tramite il sistema di proprietà WPF.

Nell'esempio seguente viene definita la IsSpinning proprietà di dipendenza e illustrata la relazione dell'identificatore DependencyProperty con la proprietà supportata.

public static readonly DependencyProperty IsSpinningProperty = 
    DependencyProperty.Register(
    "IsSpinning", typeof(Boolean),


...


    );
public bool IsSpinning
{
    get { return (bool)GetValue(IsSpinningProperty); }
    set { SetValue(IsSpinningProperty, value); }
}

La convenzione di denominazione della proprietà e del relativo campo DependencyProperty di supporto è importante. Il nome del campo è sempre il nome della proprietà al quale viene aggiunto il suffisso Property. Per ulteriori informazioni su questa convenzione e i relativi motivi, vedere Proprietà Dependency personalizzate.

È possibile impostare le proprietà nel codice o in XAML.

Impostazione dei valori della proprietà in XAML

<Button Background="Red" Content="Button!"/>

<Button Content="Button!">
  <Button.Background>
    <ImageBrush ImageSource="wavy.jpg"/>
  </Button.Background>
</Button>

Impostazione delle proprietà nel codice

Button myButton = new Button();
myButton.Width = 200.0;

double whatWidth;
whatWidth = myButton.Width;

Una proprietà di dipendenza fornisce funzionalità che consentono di estendere la funzionalità di una proprietà, rispetto a una proprietà supportata da un campo. Spesso, ciascuna di queste funzionalità rappresenta o supporta una funzione specifica dell'intero set di funzioni WPF:

• Risorse

• Associazione dati

• Stili

• Animations

• Override dei metadati

• Ereditarietà del valore della proprietà

• Integrazione della finestra di Progettazione WPF

Risorse

Un valore della proprietà di dipendenza può essere impostato facendo riferimento a una risorsa. Le risorse vengono in genere specificate come valore della proprietà Resources di un elemento radice della pagina o dell'applicazione (questi percorsi consentono un accesso più semplice alla risorsa). Nell'esempio seguente viene illustrato come definire una risorsa SolidColorBrush.

XAML

Copia

<DockPanel.Resources>
  <SolidColorBrush x:Key="MyBrush" Color="Gold"/>
</DockPanel.Resources>

Una volta definita, è possibile fare riferimento alla risorsa e utilizzarla per fornire un valore della proprietà:

XAML

Copia

<Button Background="{DynamicResource MyBrush}" Content="I am gold" />

A questa risorsa particolare viene fatto riferimento come Estensione del markup DynamicResource (in XAML WPF è possibile utilizzare un riferimento di risorsa statica o dinamica). Per utilizzare un riferimento di risorsa dinamica, è necessario eseguire l'impostazione su una proprietà di dipendenza, in modo che il sistema di proprietà WPF attivi l'utilizzo spedifico del riferimento di risorsa dinamica. Per ulteriori informazioni, vedere Risorse XAML.

Nota
Le risorse vengono considerate come valore locale, per cui se si imposta un altro valore locale, il riferimento di risorsa sarà eliminato. Per ulteriori informazioni, vedere Precedenza del valore della proprietà di dipendenza.

Associazione dati

Una proprietà di dipendenza può fare riferimento a un valore tramite l'associazione dati. Quest'ultima funziona tramite una sintassi per estensione di markup specifica in XAML o nell'oggetto Binding nel codice. Con l'associazione dati, la determinazione del valore della proprietà finale viene rinviata fino al runtime, momento in cui il valore viene ottenuto da un'origine dati.

Nell'esempio seguente viene impostata la proprietà Content per un oggetto Button, utilizzando un'associazione dichiarata in XAML. L'associazione utilizza un contesto dati ereditato e un'origine dati XmlDataProvider (non visualizzata). L'associazione stessa specifica la proprietà di origine desiderata mediante l'oggetto XPath all'interno dell'origine dati.

XAML

Copia

<Button Content="{Binding XPath=Team/@TeamName}"/>

Nota
Le associazioni vengono considerate come valore locale, per cui se si imposta un altro valore locale, l'associazione sarà eliminata. Per informazioni dettagliate, vedere Precedenza del valore della proprietà di dipendenza.

Le proprietà di dipendenza o la classe DependencyObject non supportano in modo nativo l'oggetto INotifyPropertyChanged per la produzione delle notifiche delle modifiche del valore della proprietà di origine DependencyObject per le operazioni di associazione dati. Per ulteriori informazioni su come creare proprietà da utilizzare nell'associazione dati che consentano di segnalare modifiche di una destinazione di associazione dati, vedere Cenni preliminari sull'associazione dati.

Stili

<Style x:Key="GreenButtonStyle">
  <Setter Property="Control.Background" Value="Green"/>
</Style>

<Button Style="{StaticResource GreenButtonStyle}">I am green!</Button>

Animations

<Button>I am animated
  <Button.Background>
    <SolidColorBrush x:Name="AnimBrush"/>
  </Button.Background>
  <Button.Triggers>
    <EventTrigger RoutedEvent="Button.Loaded">
      <BeginStoryboard>
        <Storyboard>
          <ColorAnimation
            Storyboard.TargetName="AnimBrush" 
            Storyboard.TargetProperty="(SolidColorBrush.Color)"
            From="Red" To="Green" Duration="0:0:5" 
            AutoReverse="True" RepeatBehavior="Forever" />
        </Storyboard>
      </BeginStoryboard>
    </EventTrigger>
  </Button.Triggers>
</Button>

Override dei metadati

public class SpinnerControl : ItemsControl
{
    static SpinnerControl()
    {
        DefaultStyleKeyProperty.OverrideMetadata(
            typeof(SpinnerControl), 
            new FrameworkPropertyMetadata(typeof(SpinnerControl))
        );
    }
}

Ereditarietà del valore della proprietà

Un elemento può ereditare il valore di una proprietà di dipendenza dal relativo elemento padre nella struttura ad albero di oggetti.

Nota

Il comportamento dell'ereditarietà del valore della proprietà non viene abilitato a livello globale per tutte le proprietà di dipendenza, poiché il tempo di calcolo per l'ereditarietà influisce negativamente sulle prestazioni. In genere, l'ereditarietà del valore della proprietà viene abilitata solo per le proprietà in cui uno scenario particolare suggerisce che tale ereditarietà è appropriata. La possibilità di ereditare di una proprietà di dipendenza può essere determinata consultando la sezione relativa alle informazioni sulle proprietà di dipendenza per una determinata proprietà di dipendenza, nel riferimento SDK.

Nell'esempio seguente viene descritta un'associazione e impostata la proprietà DataContext che specifica l'origine dell'associazione, non illustrata nell'esempio di associazione precedente. Non è necessario che le associazioni successive negli oggetti figlio specifichino l'origine in quanto possono utilizzare il valore ereditato da DataContext nell'oggetto StackPanel padre. In alternativa, un oggetto figlio potrebbe invece specificare direttamente il relativo valore DataContext o Source nell'oggetto Binding e non utilizzare il valore ereditato per il contesto dati delle relative associazioni.

XAML

Copia

<StackPanel Canvas.Top="50" DataContext="{Binding Source={StaticResource XmlTeamsSource}}">
  <Button Content="{Binding XPath=Team/@TeamName}"/>
</StackPanel>

Per ulteriori informazioni, vedere Ereditarietà del valore della proprietà.

Integrazione della finestra di Progettazione WPF

Quando si ottiene il valore di una proprietà di dipendenza, si ottiene un valore che era stato impostato in quella proprietà tramite uno qualsiasi degli altri input basati sulla proprietà che partecipano al sistema di proprietà di WPF. La precedenza del valore della proprietà di dipendenza consente a una varietà di scenari relativi alla modalità di ottenimento dei valori da parte delle proprietà di interagire in modo prevedibile.

Prendere in considerazione l'esempio riportato di seguito. Nell'esempio viene incluso uno stile applicato a tutti i pulsanti e alle relative proprietà Background; tuttavia viene anche specificato un pulsante con un valore Background impostato localmente.

Nota
Nella documentazione SDK i termini "valore locale" o "valore impostato localmente" vengono utilizzati talvolta per la descrizione delle proprietà di dipendenza. Un valore impostato localmente è un valore di proprietà che viene impostato direttamente in un'istanza di oggetto nel codice o come attributo di un elemento in XAML.

In teoria, per il primo pulsante la proprietà viene impostata due volte, ma viene applicato un solo valore, quello con la precedenza più elevata. Un valore impostato localmente ha la massima precedenza (eccetto per un'animazione in esecuzione; tuttavia, in questo esempio non viene applicata nessuna animazione), pertanto per lo sfondo del primo pulsante viene utilizzato il valore impostato localmente anziché il valore del metodo di impostazione dello stile. Il secondo pulsante non dispone di un valore locale (e di nessun altro valore con precedenza più elevata rispetto a un metodo di impostazione dello stile), pertanto lo sfondo di quel pulsante proviene dal metodo di impostazione dello stile.

<StackPanel>
  <StackPanel.Resources>
    <Style x:Key="{x:Type Button}" TargetType="{x:Type Button}">
     <Setter Property="Background" Value="Red"/>
    </Style>
  </StackPanel.Resources>
  <Button Background="Green">I am NOT red!</Button>
  <Button>I am styled red</Button>
</StackPanel>

Ragioni dell'esistenza della precedenza della proprietà di dipendenza

In genere, non si desidera che gli stili vengano sempre applicati e che nascondano persino un valore impostato localmente di un singolo elemento (altrimenti sarebbe molto difficile utilizzare gli stili o gli elementi in generale). Pertanto, i valori che provengono dagli stili operano a un livello di precedenza inferiore rispetto a un valore impostato localmente. Per un elenco più completo delle proprietà di dipendenza e per la possibile provenienza di un valore effettivo di una proprietà di dipendenza, vedere Precedenza del valore della proprietà di dipendenza.

Nota

Molte proprietà definite negli elementi WPF non sono proprietà di dipendenza. In generale, le proprietà vengono implementate come proprietà di dipendenza solo quando è necessario supportare almeno uno degli scenari abilitati dal sistema di proprietà: associazione dati, applicazione degli stili, animazione, supporto del valore predefinito, ereditarietà, proprietà associate o annullamento della convalida.

• Una proprietà associata è un tipo di proprietà che supporta una sintassi specializzata in XAML. Una proprietà associata spesso non dispone di una corrispondenza 1:1 con una proprietà Common Language Runtime (CLR) e non è necessariamente una proprietà di dipendenza. Lo scopo tipico di una proprietà associata consiste nel consentire agli elementi figlio di segnalare i valori della proprietà a un elemento padre, anche se quest'ultimo e l'elemento figlio non possiedono tale proprietà, come parte degli elenchi dei membri della classe. Uno scenario principale prevede la possibilità per gli elementi figlio di informare l'elemento padre del modo in cui vengono presentati nell'interfaccia utente; per un esempio, vedere Dock o Left. Per informazioni dettagliate, vedere Cenni preliminari sulle proprietà associate.

• Gli sviluppatori di componenti o di applicazioni possono decidere di creare una proprietà di dipendenza personalizzata al fine di abilitare funzionalità quali l'associazione dati o il supporto degli stili oppure per il supporto dell'annullamento della convalida e della coercizione del valore. Per informazioni dettagliate, vedere Proprietà Dependency personalizzate.

• Generalmente, le proprietà di dipendenza devono essere considerate come proprietà pubbliche, accessibili o almeno individuabili da parte di qualsiasi chiamante con accesso a un'istanza. Per ulteriori informazioni, vedere Sicurezza della proprietà di dipendenza.

Concetti