DependencyProperty.Register Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Registra una proprietà di dipendenza con il nome della proprietà specificato, il tipo di proprietà, il tipo di proprietario e i metadati delle proprietà per la proprietà. Usare questo metodo durante la definizione o l'inizializzazione di una classe derivata DependencyObject che possiede la 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.

propertyType

TypeName Type

Tipo della proprietà, come riferimento al tipo (System.Type per Microsoft .NET, uno struct helper TypeName per le estensioni dei componenti visual C++ (C++/CX)).

ownerType

TypeName Type

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 dei componenti visual C++ (C++/CX)).

typeMetadata

PropertyMetadata

Istanza dei metadati delle proprietà. Può contenere un valore predefinito e un riferimento all'implementazione PropertyChangedCallback . null Il passaggio per questo parametro equivale a passare una nuova istanza PropertyMetadata creata chiamando PropertyMetadata.Create con null come parametro valore predefinito.

Restituisce

DependencyProperty

Identificatore di proprietà di dipendenza archiviato in genere in un campo di sola lettura statico pubblico nella classe derivata DependencyObject . L'identificatore viene quindi usato dal proprio codice e da qualsiasi codice utente di terze parti per fare riferimento alla proprietà di dipendenza in un secondo momento, per operazioni come l'impostazione del valore a livello di codice o l'associazione di un'associazione nel codice.

Commenti

Come registrare una proprietà di dipendenza personalizzata è descritta in dettaglio (con esempi) nell'argomento Proprietà di dipendenza personalizzata.

La registrazione di una proprietà di dipendenza è in genere un elemento che viene eseguito solo quando un'app inizia per la prima volta o le classi derivate di DependencyObject definite dal codice dell'app vengono usate per la prima volta. È necessario 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à delle dipendenze durante l'inizializzazione statica della classe che possiede la proprietà di dipendenza. In questo modo, qualsiasi codice o XAML che inizializza l'istanza richiama tale costruzione statica e registra la proprietà di dipendenza. Per le estensioni dei componenti visual C++ (C++/CX), l'inizializzazione della classe statica non è una tecnica disponibile, pertanto 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 dei componenti visual C++ (C++/CX), vedere Proprietà di dipendenza personalizzate.

Vedi anche

• Proprietà di dipendenza personalizzate
• Panoramica delle proprietà di dipendenza
• Esempio di controlli utente e personalizzati XAML