DependencyProperty.Register Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

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.

propertyType

TypeName Type

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)).

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 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

DependencyProperty

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.

Vedi anche

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