DependencyProperty.Register Metodo
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.
Registra una proprietà di dipendenza con il nome della proprietà, il tipo di proprietà, il tipo di proprietario e i metadati delle proprietà specificati per la proprietà. Utilizzare questo metodo per definire o inizializzare una classe derivata DependencyObject proprietaria della proprietà di dipendenza registrata.
static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);
public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);
function register(name, propertyType, ownerType, typeMetadata)
Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty
Parametri
- name
-
String
winrt::hstring
Nome della proprietà di dipendenza da registrare.
Tipo della proprietà, come riferimento al tipo (System.Type per Microsoft .NET, uno struct helper TypeName per le estensioni del componente Visual C++ (C++/CX)).
Tipo di proprietario che registra la proprietà di dipendenza, come riferimento al tipo (System.Type per Microsoft .NET, uno struct helper TypeName per le estensioni del componente Visual C++ (C++/CX) .
- typeMetadata
- PropertyMetadata
Istanza dei metadati della proprietà. Può contenere un valore predefinito e un riferimento all'implementazione PropertyChangedCallback .
null
Il passaggio di questo parametro equivale a passare una nuova istanza PropertyMetadata creata chiamando PropertyMetadata.Create con null
come parametro valore predefinito.
Restituisce
Identificatore della proprietà di dipendenza archiviato in genere in un campo di sola lettura statico pubblico nella classe derivata DependencyObject . L'identificatore viene quindi usato sia dal codice che da qualsiasi codice utente di terze parti per fare riferimento alla proprietà di dipendenza in un secondo momento, per operazioni come l'impostazione del relativo valore a livello di codice o l'associazione di un binding nel codice.
Commenti
Come registrare una proprietà di dipendenza personalizzata è descritta in dettaglio (con esempi) nell'argomento Proprietà di dipendenza personalizzate.
La registrazione di una proprietà di dipendenza è in genere un'operazione eseguita solo quando un'app avvia per la prima volta o le classi derivate DependencyObject definite dal codice dell'app vengono usate per prime. Devi registrare le proprietà di dipendenza all'inizio della durata dell'app per garantire che altri codice e XAML nell'app non tentino di usare le proprietà di dipendenza prima che vengano registrate e disponibili. Esattamente come e quando registrare varia, in base al linguaggio di programmazione. Per C# o Microsoft Visual Basic è comune registrare le proprietà di dipendenza durante l'inizializzazione statica della classe proprietaria della proprietà di dipendenza. In questo modo, qualsiasi codice o XAML che inizializza l'istanza richiamerà la costruzione statica e registrerà la proprietà di dipendenza. Per le estensioni del componente Visual C++ (C++/CX), l'inizializzazione statica della classe non è una tecnica disponibile, quindi in genere è necessario definire un metodo helper a livello di app che registra tutte le proprietà di dipendenza personalizzate che l'app intende usare, come parte dell'inizializzazione dell'oggetto Application . Per esempi di come e quando registrare proprietà di dipendenza personalizzate, incluse alcune tecniche speciali necessarie per le estensioni del componente Visual C++ (C++/CX), vedere Proprietà di dipendenza personalizzate.