PropertyMetadata Costruttori

Definizione

Spazio dei nomi:

System.Windows

Assembly:

WindowsBase.dll

Inizializza una nuova istanza della classe PropertyMetadata.

Overload

PropertyMetadata()	Inizializza una nuova istanza della classe PropertyMetadata.
PropertyMetadata(Object)	Inizializza una nuova istanza della classe PropertyMetadata con un valore predefinito specificato per la proprietà di dipendenza a cui verranno applicati i metadati.
PropertyMetadata(PropertyChangedCallback)	Inizializza una nuova istanza della classe PropertyMetadata con il riferimento all'implementazione di PropertyChangedCallback specificato.
PropertyMetadata(Object, PropertyChangedCallback)	Inizializza una nuova istanza della classe PropertyMetadata con il valore predefinito e il riferimento all'implementazione di PropertyChangedCallback specificati.
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Inizializza una nuova istanza della classe PropertyMetadata, con il valore predefinito e i callback specificati.

PropertyMetadata()

Inizializza una nuova istanza della classe PropertyMetadata.

public:
 PropertyMetadata();

public PropertyMetadata ();

Public Sub New ()

PropertyMetadata(Object)

Inizializza una nuova istanza della classe PropertyMetadata con un valore predefinito specificato per la proprietà di dipendenza a cui verranno applicati i metadati.

public:
 PropertyMetadata(System::Object ^ defaultValue);

public PropertyMetadata (object defaultValue);

new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object)

Parametri

defaultValue

Object

Valore predefinito da specificare per una proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

Eccezioni

ArgumentException

defaultValue non può essere impostato sul valore UnsetValue.

Esempio

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. La mancata corrispondenza tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione (la mancata corrispondenza genererà un'eccezione di runtime).

Sebbene sia l'impostazione predefinita per il costruttore senza parametri, non è possibile specificare un defaultValue valore di UnsetValue . Se si tenta di eseguire questa operazione, verrà generata un'eccezione.

PropertyMetadata(PropertyChangedCallback)

Inizializza una nuova istanza della classe PropertyMetadata con il riferimento all'implementazione di PropertyChangedCallback specificato.

public:
 PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parametri

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà a ogni modifica del valore effettivo della proprietà.

Esempio

static PropertyMetadata pm;

pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

PropertyMetadata(Object, PropertyChangedCallback)

Inizializza una nuova istanza della classe PropertyMetadata con il valore predefinito e il riferimento all'implementazione di PropertyChangedCallback specificati.

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà a ogni modifica del valore effettivo della proprietà.

Eccezioni

ArgumentException

defaultValue non può essere impostato sul valore UnsetValue.

Esempio

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Commenti

Il tipo del valore specificato defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. La mancata corrispondenza tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione (la mancata corrispondenza genererà un'eccezione di runtime).

Sebbene sia l'impostazione predefinita per il costruttore senza parametri, non è possibile specificare un defaultValue valore di UnsetValue . Se si tenta di eseguire questa operazione, verrà generata un'eccezione.

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inizializza una nuova istanza della classe PropertyMetadata, con il valore predefinito e i callback specificati.

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà a ogni modifica del valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Riferimento a un'implementazione del gestore che verrà chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) per la proprietà.

Eccezioni

ArgumentException

defaultValue non può essere impostato sul valore UnsetValue.

Esempio

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Commenti

Se si desidera specificare un CoerceValueCallback oggetto ma non un PropertyChangedCallback, è possibile passare null per il propertyChangedCallback parametro .

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. La mancata corrispondenza tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione (la mancata corrispondenza genererà un'eccezione di runtime).

Sebbene sia l'impostazione predefinita per il costruttore senza parametri, non è possibile specificare un defaultValue valore di UnsetValue . Se si tenta di eseguire questa operazione, verrà generata un'eccezione.