Questa documentazione è stata archiviata e non viene gestita.

Metodo DependencyObject.SetValue (DependencyPropertyKey, Object)

Aggiornamento: novembre 2007

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificata dall'identificatore DependencyPropertyKey della proprietà di dipendenza.

Spazio dei nomi:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public void SetValue(
	DependencyPropertyKey key,
	Object value
)
public void SetValue(
	DependencyPropertyKey key,
	Object value
)
public function SetValue(
	key : DependencyPropertyKey, 
	value : Object
)
Non è possibile utilizzare metodi in XAML.

Parametri

key
Tipo: System.Windows.DependencyPropertyKey

Identificatore DependencyPropertyKey della proprietà da impostare.

value
Tipo: System.Object

Nuovo valore locale.

Questa firma viene utilizzata in genere quando si impostano valori per proprietà di dipendenza di sola lettura definite dalle classi personalizzate. Generalmente SetValue viene chiamato solo dal tipo che ha registrato la proprietà di dipendenza, con implementazione della logica interna che fornisce il valore determinato per la proprietà di dipendenza. Per ulteriori informazioni, vedere Proprietà di dipendenza di sola lettura.

Se il tipo fornito non corrisponde al tipo dichiarato per la proprietà di dipendenza registrata in origine, viene generata un'eccezione. È necessario specificare sempre il parametro value come tipo appropriato. Le condizioni dell'eccezione sono potenzialmente influenzate dal callback ValidateValueCallback esistente nell'identificatore della proprietà di dipendenza impostata.

Nell'esempio seguente viene definita una proprietà di dipendenza di sola lettura, insieme a una DependencyPropertypublic static readonly che fornisce l'esposizione di sola lettura necessaria agli utenti della proprietà e la funzione di accesso get per il wrapper CLR.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}


Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: