DependencyProperty.RegisterAttached Methode

Definition

Registriert eine angefügte Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftennamen, Eigenschaftentyp, Besitzertyp und Eigenschaftsmetadaten für die Eigenschaft.

 static DependencyProperty RegisterAttached(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& defaultMetadata);
public static DependencyProperty RegisterAttached(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata defaultMetadata);
function registerAttached(name, propertyType, ownerType, defaultMetadata)
Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

Parameter

name
String

winrt::hstring

Der Name der zu registrierenden Abhängigkeitseigenschaft.

propertyType
TypeName Type

Der Typ der Eigenschaft als Typverweis.

ownerType
TypeName Type

Der Besitzertyp, der die Abhängigkeitseigenschaft registriert, als Typverweis.

defaultMetadata
PropertyMetadata

Eine Eigenschaftsmetadateninstanz. Dies kann einen PropertyChangedCallback-Implementierungsverweis enthalten.

Gibt zurück

Ein Abhängigkeitseigenschaftsbezeichner, der zum Festlegen des Werts eines öffentlichen statischen schreibgeschützten Felds in Ihrer Klasse verwendet werden soll. Dieser Bezeichner wird dann verwendet, um später auf die angefügte Eigenschaft zu verweisen, für Vorgänge wie das programmgesteuerte Festlegen des Werts oder das Anfügen einer Bindung.

Beispiele

In diesem Beispiel wird eine Klasse definiert, die von DependencyObject abgeleitet wird, und eine angefügte Eigenschaft zusammen mit dem Bezeichnerfeld definiert. Das Szenario für diese Klasse besteht darin, dass es sich um eine Dienstklasse handelt, die eine angefügte Eigenschaft deklariert, die andere UI-Elemente in XAML festlegen können, und der Dienst wirkt potenziell auf die Werte der angefügten Eigenschaft für diese UI-Elemente zur Laufzeit. Weitere Beispiele finden Sie unter "Benutzerdefinierte angefügte Eigenschaften".

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy { Floats, Sinks, Drifts }

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

Gilt für:

Weitere Informationen