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
| Nome | Descrizione |
|---|---|
| PropertyMetadata() |
Inizializza una nuova istanza della classe PropertyMetadata. |
| PropertyMetadata(Object) |
Inizializza una nuova istanza della PropertyMetadata classe con un valore predefinito specificato per la proprietà di dipendenza a cui verranno applicati questi metadati. |
| PropertyMetadata(PropertyChangedCallback) |
Inizializza una nuova istanza della PropertyMetadata classe con il riferimento all'implementazione specificato PropertyChangedCallback . |
| PropertyMetadata(Object, PropertyChangedCallback) |
Inizializza una nuova istanza della PropertyMetadata classe con il valore predefinito e PropertyChangedCallback il riferimento all'implementazione specificati. |
| PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inizializza una nuova istanza della PropertyMetadata classe 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 PropertyMetadata classe con un valore predefinito specificato per la proprietà di dipendenza a cui verranno applicati questi 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. Le mancate corrispondenze 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 il valore predefinito 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 PropertyMetadata classe con il riferimento all'implementazione specificato PropertyChangedCallback .
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 deve essere chiamata dal sistema di proprietà ogni volta che cambia il 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 PropertyMetadata classe con il valore predefinito e PropertyChangedCallback il riferimento all'implementazione 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 deve essere chiamata dal sistema di proprietà ogni volta che cambia il 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. Le mancate corrispondenze 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 il valore predefinito 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 PropertyMetadata classe 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 deve essere chiamata dal sistema di proprietà ogni volta che cambia il valore effettivo della proprietà.
- coerceValueCallback
- CoerceValueCallback
Riferimento a un'implementazione del gestore che deve essere chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) su questa 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 oggetto CoerceValueCallback 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. Le mancate corrispondenze 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 il valore predefinito per il costruttore senza parametri, non è possibile specificare un defaultValue valore di UnsetValue . Se si tenta di eseguire questa operazione, verrà generata un'eccezione.
