DependencyProperty.RegisterAttached Metodo

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType);

static member RegisterAttached : string * Type * Type -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type) As DependencyProperty

Parametri

Restituisce

DependencyProperty

Identificatore della proprietà di dipendenza da usare per impostare il valore di un campo public static readonly nella classe. Tale identificatore viene quindi usato per fare riferimento in un secondo momento alla proprietà di dipendenza, per operazioni come l'impostazione del valore a livello di codice o per ottenere i metadati.

Esempio

Nell'esempio seguente viene registrata una proprietà associata in una classe astratta utilizzando questa RegisterAttached firma.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Commenti

Una proprietà associata è un concetto di proprietà definito da Extensible Application Markup Language (XAML). WPF implementa le proprietà associate come proprietà di dipendenza. Poiché le proprietà associate WPF sono proprietà di dipendenza, possono avere metadati applicati che possono essere usati dal sistema di proprietà generale per operazioni come le caratteristiche del layout dei report. Per altre informazioni, vedere Cenni preliminari sulle proprietà associate.

Per altre informazioni sulla registrazione delle proprietà di dipendenza, vedere DependencyProperty.

Vedi anche

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

Parametri

Restituisce

DependencyProperty

Identificatore della proprietà di dipendenza da usare per impostare il valore di un campo public static readonly nella classe. Tale identificatore viene quindi usato per fare riferimento in un secondo momento alla proprietà di dipendenza, per operazioni come l'impostazione del valore a livello di codice o per ottenere i metadati.

Commenti

Una proprietà associata è un concetto di proprietà definito da Extensible Application Markup Language (XAML). WPF implementa le proprietà associate come proprietà di dipendenza. Poiché le proprietà associate WPF sono proprietà di dipendenza, possono avere metadati applicati che possono essere usati dal sistema di proprietà generale per operazioni come le caratteristiche del layout dei report. Per altre informazioni, vedere Cenni preliminari sulle proprietà associate.

Per altre informazioni sulla registrazione delle proprietà di dipendenza, vedere DependencyProperty.

Usare RegisterAttached per le proprietà di dipendenza che ereditano valore

Uno scenario specifico per la registrazione di una proprietà di dipendenza con RegisterAttached anziché consiste nel supportare l'ereditarietà del valore della Register proprietà. È necessario registrare le proprietà di dipendenza che ereditano valori con RegisterAttached anche se la classe definisce le funzioni di accesso wrapper della proprietà che espongono la proprietà di dipendenza e, anche se non si intende esporre metodi statici Get* e Set* per fornire funzioni di accesso true di supporto delle proprietà associate. Anche se l'ereditarietà dei valori di proprietà potrebbe funzionare per le proprietà di dipendenza non associate, il comportamento di ereditarietà per una proprietà non collegata attraverso determinati limiti di elemento nell'albero di runtime non è definito. La registrazione della proprietà come associata rende effettivamente la proprietà associata una proprietà globale nel sistema di proprietà e garantisce che l'ereditarietà dei valori di proprietà funzioni in tutti i limiti di un albero degli elementi. Usare RegisterAttached sempre per registrare le proprietà in cui si specificano Inherits nei metadati. Per altre informazioni, vedere Ereditarietà del valore della proprietà.

Vedi anche

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyProperty

Parametri

Restituisce

DependencyProperty

Identificatore della proprietà di dipendenza da usare per impostare il valore di un campo public static readonly nella classe. Tale identificatore viene quindi usato per fare riferimento in un secondo momento alla proprietà di dipendenza, per operazioni come l'impostazione del valore a livello di codice o per ottenere i metadati.

Esempio

Nell'esempio seguente viene registrata una proprietà associata in una classe astratta utilizzando questa RegisterAttached firma. Questa proprietà associata è una proprietà del tipo di enumerazione e la registrazione aggiunge un callback di convalida per verificare che il valore specificato sia un valore dell'enumerazione .

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Commenti

Una proprietà associata è un concetto di proprietà definito da Extensible Application Markup Language (XAML). WPF implementa le proprietà associate come proprietà di dipendenza. Poiché le proprietà associate WPF sono proprietà di dipendenza, possono avere metadati applicati che possono essere usati dal sistema di proprietà generale per operazioni come le caratteristiche del layout dei report. Per altre informazioni, vedere Cenni preliminari sulle proprietà associate.

Per altre informazioni sulla registrazione delle proprietà di dipendenza, vedere DependencyProperty.

Usare RegisterAttached per le proprietà di dipendenza che ereditano valore

Uno scenario specifico per la registrazione di una proprietà di dipendenza con RegisterAttached anziché consiste nel supportare l'ereditarietà del valore della Register proprietà. È necessario registrare le proprietà di dipendenza che ereditano valori con RegisterAttached anche se la classe definisce le funzioni di accesso wrapper della proprietà che espongono la proprietà di dipendenza e, anche se non si intende esporre metodi statici Get* e Set* per fornire funzioni di accesso true di supporto delle proprietà associate. Anche se l'ereditarietà dei valori di proprietà potrebbe funzionare per le proprietà di dipendenza non associate, il comportamento di ereditarietà per una proprietà non collegata attraverso determinati limiti di elemento nell'albero di runtime non è definito. La registrazione della proprietà come associata rende effettivamente la proprietà associata una proprietà globale nel sistema di proprietà e garantisce che l'ereditarietà dei valori di proprietà funzioni in tutti i limiti di un albero degli elementi. Usare RegisterAttached sempre per registrare le proprietà in cui si specificano Inherits nei metadati. Per altre informazioni, vedere Ereditarietà del valore della proprietà.

Vedi anche

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)