PropertyMetadata Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 ()Si applica a
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.PropertyMetadataPublic 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
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.
Si applica a
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.PropertyMetadataPublic 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));
Si applica a
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.PropertyMetadataPublic 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
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.
Si applica a
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.PropertyMetadataPublic 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
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.
