DependencyProperty.RegisterAttached Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

WindowsBase.dll

Rejestruje dołączoną właściwość w systemie właściwości.

Przeciążenia

RegisterAttached(String, Type, Type)	Rejestruje dołączoną właściwość o określonej nazwie właściwości, typie właściwości i typie właściciela.
RegisterAttached(String, Type, Type, PropertyMetadata)	Rejestruje dołączoną właściwość z określoną nazwą właściwości, typem właściwości, typem właściciela i metadanymi właściwości.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Rejestruje dołączoną właściwość z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji wartości dla właściwości.

RegisterAttached(String, Type, Type)

Rejestruje dołączoną właściwość o określonej nazwie właściwości, typie właściwości i typie właściciela.

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

Parametry

name

String

Nazwa właściwości zależności do zarejestrowania.

propertyType

Type

Typ właściwości.

ownerType

Type

Typ właściciela rejestrujący właściwość zależności.

Zwraca

DependencyProperty

Identyfikator właściwości zależności, który powinien służyć do ustawiania wartości public static readonly pola w klasie. Ten identyfikator jest następnie używany do odwołowania się do właściwości zależności później w przypadku operacji, takich jak ustawienie jego wartości programowo lub uzyskiwanie metadanych.

Przykłady

Poniższy przykład rejestruje dołączoną właściwość w klasie abstrakcyjnej przy użyciu tego RegisterAttached podpisu.

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

Uwagi

Dołączona właściwość to koncepcja właściwości zdefiniowana przez język znaczników aplikacji rozszerzalnej (XAML). WPF implementuje dołączone właściwości jako właściwości zależności. Ponieważ dołączone właściwości WPF są właściwościami zależności, mogą mieć zastosowane metadane, które mogą być używane przez ogólny system właściwości dla operacji, takich jak właściwości układu raportowania. Aby uzyskać więcej informacji, zobacz Omówienie dołączonych właściwości.

Aby uzyskać więcej informacji na temat rejestracji właściwości zależności, zobacz DependencyProperty.

Zobacz też

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

RegisterAttached(String, Type, Type, PropertyMetadata)

Rejestruje dołączoną właściwość z określoną nazwą właściwości, typem właściwości, typem właściciela i metadanymi właściwości.

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

Parametry

name

String

Nazwa właściwości zależności do zarejestrowania.

propertyType

Type

Typ właściwości.

ownerType

Type

Typ właściciela rejestrujący właściwość zależności.

defaultMetadata

PropertyMetadata

Metadane właściwości dla właściwości zależności. Może to obejmować wartość domyślną, a także inne cechy.

Zwraca

DependencyProperty

Identyfikator właściwości zależności, który powinien służyć do ustawiania wartości public static readonly pola w klasie. Ten identyfikator jest następnie używany do odwołowania się do właściwości zależności później w przypadku operacji, takich jak ustawienie jego wartości programowo lub uzyskiwanie metadanych.

Uwagi

Dołączona właściwość to koncepcja właściwości zdefiniowana przez język znaczników aplikacji rozszerzalnej (XAML). WPF implementuje dołączone właściwości jako właściwości zależności. Ponieważ dołączone właściwości WPF są właściwościami zależności, mogą mieć zastosowane metadane, które mogą być używane przez ogólny system właściwości dla operacji, takich jak właściwości układu raportowania. Aby uzyskać więcej informacji, zobacz Omówienie dołączonych właściwości.

Aby uzyskać więcej informacji na temat rejestracji właściwości zależności, zobacz DependencyProperty.

Używanie funkcji RegisterAttached dla właściwości zależności dziedziczonej wartości

Jednym z konkretnych scenariuszy rejestrowania właściwości zależności z RegisterAttached zamiast Register obsługi dziedziczenia wartości właściwości. Należy zarejestrować właściwości zależności dziedziczone przez wartość RegisterAttached nawet wtedy, gdy klasa definiuje metody otoki właściwości, które uwidaczniają właściwość zależności, a nawet jeśli nie zamierzasz uwidocznić metod statycznych Get* i Set* w celu zapewnienia dostępu do prawdziwej dołączonej właściwości. Mimo że dziedziczenie wartości właściwości może działać dla właściwości zależności nieprzyłączonej, zachowanie dziedziczenia dla właściwości nieprzyłączonej przez niektóre granice elementów w drzewie środowiska uruchomieniowego jest niezdefiniowane. Zarejestrowanie właściwości jako dołączonej skutecznie sprawia, że dołączona właściwość globalna do systemu właściwości i zapewnia, że dziedziczenie wartości właściwości działa we wszystkich granicach w drzewie elementów. Zawsze używaj polecenia RegisterAttached , aby zarejestrować właściwości określone Inherits w metadanych. Aby uzyskać więcej informacji, zobacz Dziedziczenie wartości właściwości.

Zobacz też

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

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Rejestruje dołączoną właściwość z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji wartości dla właściwości.

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

Parametry

name

String

Nazwa właściwości zależności do zarejestrowania.

propertyType

Type

Typ właściwości.

ownerType

Type

Typ właściciela rejestrujący właściwość zależności.

defaultMetadata

PropertyMetadata

Metadane właściwości dla właściwości zależności. Może to obejmować wartość domyślną, a także inne cechy.

validateValueCallback

ValidateValueCallback

Odwołanie do wywołania zwrotnego, które powinno wykonać niestandardową walidację wartości właściwości zależności poza typową weryfikacją typu.

Zwraca

DependencyProperty

Identyfikator właściwości zależności, który powinien służyć do ustawiania wartości public static readonly pola w klasie. Ten identyfikator jest następnie używany do odwołowania się do właściwości zależności później w przypadku operacji, takich jak ustawienie jego wartości programowo lub uzyskiwanie metadanych.

Przykłady

Poniższy przykład rejestruje dołączoną właściwość w klasie abstrakcyjnej przy użyciu tego RegisterAttached podpisu. Ta dołączona właściwość jest właściwością typu wyliczenia, a rejestracja dodaje wywołanie zwrotne weryfikacji, aby sprawdzić, czy podana wartość jest wartością wyliczenia.

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

Uwagi

Dołączona właściwość to koncepcja właściwości zdefiniowana przez język znaczników aplikacji rozszerzalnej (XAML). WPF implementuje dołączone właściwości jako właściwości zależności. Ponieważ dołączone właściwości WPF są właściwościami zależności, mogą mieć zastosowane metadane, które mogą być używane przez ogólny system właściwości dla operacji, takich jak właściwości układu raportowania. Aby uzyskać więcej informacji, zobacz Omówienie dołączonych właściwości.

Aby uzyskać więcej informacji na temat rejestracji właściwości zależności, zobacz DependencyProperty.

Używanie funkcji RegisterAttached dla właściwości zależności dziedziczonej wartości

Jednym z konkretnych scenariuszy rejestrowania właściwości zależności z RegisterAttached zamiast Register obsługi dziedziczenia wartości właściwości. Należy zarejestrować właściwości zależności dziedziczone przez wartość RegisterAttached nawet wtedy, gdy klasa definiuje metody otoki właściwości, które uwidaczniają właściwość zależności, a nawet jeśli nie zamierzasz uwidocznić metod statycznych Get* i Set* w celu zapewnienia dostępu do prawdziwej dołączonej właściwości. Mimo że dziedziczenie wartości właściwości może działać dla właściwości zależności nieprzyłączonej, zachowanie dziedziczenia dla właściwości nieprzyłączonej przez niektóre granice elementów w drzewie środowiska uruchomieniowego jest niezdefiniowane. Zarejestrowanie właściwości jako dołączonej skutecznie sprawia, że dołączona właściwość globalna do systemu właściwości i zapewnia, że dziedziczenie wartości właściwości działa we wszystkich granicach w drzewie elementów. Zawsze używaj polecenia RegisterAttached , aby zarejestrować właściwości określone Inherits w metadanych. Aby uzyskać więcej informacji, zobacz Dziedziczenie wartości właściwości.

Zobacz też

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