DependencyProperty.RegisterAttached Methode

  • Referenz

Definition

Namespace:
System.Windows
Assembly:
WindowsBase.dll

Registriert eine angefügte Eigenschaft mit dem Eigenschaftensystem.

Überlädt

RegisterAttached(String, Type, Type)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp.
RegisterAttached(String, Type, Type, PropertyMetadata)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftenmetadaten.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und dem angegebenen Wertvalidierungsrückruf für die Eigenschaft.

RegisterAttached(String, Type, Type)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp.

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

Parameter

name
String

Der Name der zu registrierenden Abhängigkeitseigenschaft.

propertyType
Type

Den Typ der Eigenschaft.

ownerType
Type

Der Besitzertyp, von dem die Abhängigkeitseigenschaft registriert wird.

Gibt zurück

DependencyProperty

Ein Bezeichner für eine Abhängigkeitseigenschaft, der zum Festlegen des Werts eines public static readonly-Felds in der Klasse verwendet werden soll. Dieser Bezeichner wird dann später in Vorgängen (z. B. beim programmgesteuerten Festlegen des Werts oder beim Abrufen von Metadaten) zum Verweisen auf die Abhängigkeitseigenschaft verwendet.

Beispiele

Im folgenden Beispiel wird eine angefügte Eigenschaft in einer abstrakten Klasse mit dieser RegisterAttached Signatur registriert.

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

Hinweise

Eine angefügte Eigenschaft ist ein Eigenschaftskonzept, das von Extensible Application Markup Language (XAML) definiert ist. WPF implementiert angefügte Eigenschaften als Abhängigkeitseigenschaften. Da die angefügten WPF-Eigenschaften Abhängigkeitseigenschaften sind, können sie Metadaten anwenden, die vom allgemeinen Eigenschaftensystem für Vorgänge wie Berichtslayouteigenschaften verwendet werden können. Weitere Informationen finden Sie unter Übersicht über angefügte Eigenschaften.

Weitere Informationen zur Abhängigkeitseigenschaftsregistrierung finden Sie unter DependencyProperty.

Siehe auch

Gilt für

RegisterAttached(String, Type, Type, PropertyMetadata)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftenmetadaten.

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

Parameter

name
String

Der Name der zu registrierenden Abhängigkeitseigenschaft.

propertyType
Type

Den Typ der Eigenschaft.

ownerType
Type

Der Besitzertyp, von dem die Abhängigkeitseigenschaft registriert wird.

defaultMetadata
PropertyMetadata

Eigenschaftsmetadaten für die Abhängigkeitseigenschaft. Dies kann den Standardwert sowie andere Merkmale einschließen.

Gibt zurück

DependencyProperty

Ein Bezeichner für eine Abhängigkeitseigenschaft, der zum Festlegen des Werts eines public static readonly-Felds in der Klasse verwendet werden soll. Dieser Bezeichner wird dann später in Vorgängen (z. B. beim programmgesteuerten Festlegen des Werts oder beim Abrufen von Metadaten) zum Verweisen auf die Abhängigkeitseigenschaft verwendet.

Hinweise

Eine angefügte Eigenschaft ist ein Eigenschaftskonzept, das von Extensible Application Markup Language (XAML) definiert ist. WPF implementiert angefügte Eigenschaften als Abhängigkeitseigenschaften. Da die angefügten WPF-Eigenschaften Abhängigkeitseigenschaften sind, können sie Metadaten anwenden, die vom allgemeinen Eigenschaftensystem für Vorgänge wie Berichtslayouteigenschaften verwendet werden können. Weitere Informationen finden Sie unter Übersicht über angefügte Eigenschaften.

Weitere Informationen zur Abhängigkeitseigenschaftsregistrierung finden Sie unter DependencyProperty.

Verwenden von RegisterAttached für wertererbende Abhängigkeitseigenschaften

Ein bestimmtes Szenario für das Registrieren einer Abhängigkeitseigenschaft anstelle RegisterAttached der Register Unterstützung der Eigenschaftswertvererbung. Sie sollten Abhängigkeitseigenschaften mit wertererbenden Eigenschaften RegisterAttached registrieren, auch wenn die Klasse Eigenschaftenumbruchzugriffer definiert, die die Abhängigkeitseigenschaft verfügbar machen, und auch wenn Sie nicht beabsichtigen, Get* und Set* statische Methoden zur Bereitstellung von true angefügten Eigenschaftsunterstützungszugriffern bereitzustellen. Obwohl die Eigenschaftswertvererbung möglicherweise für nicht angefügte Abhängigkeitseigenschaften funktioniert, ist das Vererbungsverhalten für eine nicht angehaltene Eigenschaft durch bestimmte Elementgrenzen in der Laufzeitstruktur nicht definiert. Das Registrieren der Eigenschaft als angefügte Eigenschaft macht die angefügte Eigenschaft eine globale Eigenschaft im Eigenschaftssystem und stellt sicher, dass die Vererbung des Eigenschaftenwerts über alle Grenzen in einer Elementstruktur funktioniert. Verwenden Sie immer RegisterAttached, um Eigenschaften zu registrieren, bei denen Sie Inherits in den Metadaten angeben. Weitere Informationen finden Sie unter Vererbung von Eigenschaftswerten.

Siehe auch

Gilt für

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

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und dem angegebenen Wertvalidierungsrückruf für die Eigenschaft.

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

Parameter

name
String

Der Name der zu registrierenden Abhängigkeitseigenschaft.

propertyType
Type

Den Typ der Eigenschaft.

ownerType
Type

Der Besitzertyp, von dem die Abhängigkeitseigenschaft registriert wird.

defaultMetadata
PropertyMetadata

Eigenschaftsmetadaten für die Abhängigkeitseigenschaft. Dies kann den Standardwert sowie andere Merkmale einschließen.

validateValueCallback
ValidateValueCallback

Ein Verweis auf einen Rückruf, der eine beliebige benutzerdefinierte Validierung des Werts der Abhängigkeitseigenschaft über die normale Validierung hinaus durchführen soll.

Gibt zurück

DependencyProperty

Ein Bezeichner für eine Abhängigkeitseigenschaft, der zum Festlegen des Werts eines public static readonly-Felds in der Klasse verwendet werden soll. Dieser Bezeichner wird dann später in Vorgängen (z. B. beim programmgesteuerten Festlegen des Werts oder beim Abrufen von Metadaten) zum Verweisen auf die Abhängigkeitseigenschaft verwendet.

Beispiele

Im folgenden Beispiel wird eine angefügte Eigenschaft in einer abstrakten Klasse mit dieser RegisterAttached Signatur registriert. Diese angefügte Eigenschaft ist eine Enumerationstypeigenschaft, und die Registrierung fügt einen Überprüfungsrückruf hinzu, um zu überprüfen, ob der angegebene Wert ein Wert der Enumeration ist.

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

Hinweise

Eine angefügte Eigenschaft ist ein Eigenschaftskonzept, das von Extensible Application Markup Language (XAML) definiert ist. WPF implementiert angefügte Eigenschaften als Abhängigkeitseigenschaften. Da die angefügten WPF-Eigenschaften Abhängigkeitseigenschaften sind, können sie Metadaten anwenden, die vom allgemeinen Eigenschaftensystem für Vorgänge wie Berichtslayouteigenschaften verwendet werden können. Weitere Informationen finden Sie unter Übersicht über angefügte Eigenschaften.

Weitere Informationen zur Abhängigkeitseigenschaftsregistrierung finden Sie unter DependencyProperty.

Verwenden von RegisterAttached für wertererbende Abhängigkeitseigenschaften

Ein bestimmtes Szenario für das Registrieren einer Abhängigkeitseigenschaft anstelle RegisterAttached der Register Unterstützung der Eigenschaftswertvererbung. Sie sollten Abhängigkeitseigenschaften mit wertererbenden Eigenschaften RegisterAttached registrieren, auch wenn die Klasse Eigenschaftenumbruchzugriffer definiert, die die Abhängigkeitseigenschaft verfügbar machen, und auch wenn Sie nicht beabsichtigen, Get* und Set* statische Methoden zur Bereitstellung von true angefügten Eigenschaftsunterstützungszugriffern bereitzustellen. Obwohl die Eigenschaftswertvererbung möglicherweise für nicht angefügte Abhängigkeitseigenschaften funktioniert, ist das Vererbungsverhalten für eine nicht angehaltene Eigenschaft durch bestimmte Elementgrenzen in der Laufzeitstruktur nicht definiert. Das Registrieren der Eigenschaft als angefügte Eigenschaft macht die angefügte Eigenschaft eine globale Eigenschaft im Eigenschaftssystem und stellt sicher, dass die Vererbung des Eigenschaftenwerts über alle Grenzen in einer Elementstruktur funktioniert. Verwenden Sie immer RegisterAttached, um Eigenschaften zu registrieren, bei denen Sie Inherits in den Metadaten angeben. Weitere Informationen finden Sie unter Vererbung von Eigenschaftswerten.

Siehe auch

Gilt für