DependencyProperty.RegisterAttached Metódus

Definíció

Névtér:: System.Windows

Szerelvény:: WindowsBase.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Csatolt tulajdonság regisztrálása a tulajdonságrendszerben.

Túlterhelések

Name	Description
RegisterAttached(String, Type, Type)	Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal és tulajdonostípussal.
RegisterAttached(String, Type, Type, PropertyMetadata)	Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Regisztrál egy csatolt tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadataival és értékérvényesítési visszahívásával a tulajdonsághoz.

RegisterAttached(String, Type, Type)

Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal és tulajdonostípussal.

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

Paraméterek

name: String

A regisztrálandó függőségi tulajdonság neve.

propertyType: Type

A tulajdonság típusa.

ownerType: Type

A függőségi tulajdonságot regisztráló tulajdonostípus.

Válaszok

DependencyProperty

Függőségi tulajdonságazonosító, amelyet az osztály egy public static readonly mezőjének értékének beállításához kell használni. Ez az azonosító később hivatkozik a függőségi tulajdonságra olyan műveletek esetében, mint például az érték programozott beállítása vagy a metaadatok beszerzése.

Példák

Az alábbi példa egy csatolt tulajdonságot regisztrál egy absztrakt osztályon ezzel az RegisterAttached aláírással.

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

Megjegyzések

A csatolt tulajdonság az Extensible Application Markup Language (XAML) által meghatározott tulajdonságfogalom. WPF függőségi tulajdonságokként implementálja a csatolt tulajdonságokat. Mivel a WPF csatolt tulajdonságok függőségi tulajdonságok, olyan metaadatokat alkalmazhatnak, amelyeket az általános tulajdonságrendszer használhat olyan műveletekhez, mint a jelentési elrendezés jellemzői. További információ: Csatolt tulajdonságok áttekintése.

A függőségi tulajdonság regisztrációval kapcsolatos további információkért lásd: DependencyProperty.

Lásd még

A következőre érvényes:

RegisterAttached(String, Type, Type, PropertyMetadata)

Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.

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

Paraméterek

name: String

A regisztrálandó függőségi tulajdonság neve.

propertyType: Type

A tulajdonság típusa.

ownerType: Type

A függőségi tulajdonságot regisztráló tulajdonostípus.

defaultMetadata: PropertyMetadata

A függőségi tulajdonság tulajdonság metaadatai. Ez magában foglalhatja az alapértelmezett értéket és az egyéb jellemzőket is.

Válaszok

DependencyProperty

Megjegyzések

A függőségi tulajdonság regisztrációval kapcsolatos további információkért lásd: DependencyProperty.

A RegisterAttached használata értéköröklő függőségi tulajdonságokhoz

A függőségi tulajdonság RegisterAttached regisztrálásának egyik konkrét forgatókönyve a Register tulajdonságérték öröklésének támogatása helyett. Az értéköröklő függőségi tulajdonságokat RegisterAttached akkor is regisztrálnia kell, ha az osztály olyan tulajdonságburkoló tartozékokat határoz meg, amelyek elérhetővé teszik a függőségi tulajdonságot, és még akkor is, ha nem szeretné a Get* és a Set* statikus metódust elérhetővé tenni, hogy valódi csatolt tulajdonságtámogatási kiegészítőket biztosítson. Bár a tulajdonságérték öröklése úgy tűnhet, hogy nem gyorsítótárazott függőségi tulajdonságok esetében működik, a futtatókörnyezeti fa bizonyos elemhatárain keresztüli nem gyorsítótárazott tulajdonságok öröklési viselkedése nincs meghatározva. A tulajdonság csatolásként való regisztrálásával a csatolt tulajdonság globális tulajdonságtá válik a tulajdonságrendszerben, és biztosítja, hogy a tulajdonságérték öröklése az elemfa minden határán működik. Mindig használd a RegisterAttached-t olyan tulajdonságok regisztrálására, ahol Inherits-et határoztál meg a metaadatokban. További információ: Tulajdonságérték öröklése.

Lásd még

A következőre érvényes:

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

Regisztrál egy csatolt tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadataival és értékérvényesítési visszahívásával a tulajdonsághoz.

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

Paraméterek

name: String

A regisztrálandó függőségi tulajdonság neve.

propertyType: Type

A tulajdonság típusa.

ownerType: Type

A függőségi tulajdonságot regisztráló tulajdonostípus.

defaultMetadata: PropertyMetadata

A függőségi tulajdonság tulajdonság metaadatai. Ez magában foglalhatja az alapértelmezett értéket és az egyéb jellemzőket is.

validateValueCallback: ValidateValueCallback

Olyan visszahívásra való hivatkozás, amely a függőségi tulajdonság értékének bármely egyéni érvényesítését végrehajtja a tipikus típusérvényesítésen túl.

Válaszok

DependencyProperty

Példák

Az alábbi példa egy csatolt tulajdonságot regisztrál egy absztrakt osztályon ezzel az RegisterAttached aláírással. Ez a csatolt tulajdonság egy enumerálás típusú tulajdonság, és a regisztráció egy érvényesítési visszahívást ad hozzá annak ellenőrzéséhez, hogy a megadott érték az enumerálás értéke-e.

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

Megjegyzések

A függőségi tulajdonság regisztrációval kapcsolatos további információkért lásd: DependencyProperty.

A RegisterAttached használata értéköröklő függőségi tulajdonságokhoz

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?