DependencyProperty.RegisterAttached Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Ekli bir özelliği özellik sistemine kaydeder.

Aşırı Yüklemeler

RegisterAttached(String, Type, Type)	Belirtilen özellik adı, özellik türü ve sahip türü ile ekli bir özelliği kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata)	Belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle ekli bir özelliği kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Özelliğin belirtilen özellik türü, sahip türü, özellik meta verileri ve değer doğrulama geri çağırmasıyla ekli bir özelliği kaydeder.

RegisterAttached(String, Type, Type)

Belirtilen özellik adı, özellik türü ve sahip türü ile ekli bir özelliği kaydeder.

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

Parametreler

name

String

Kaydedilecek bağımlılık özelliğinin adı.

propertyType

Type

Özelliğin türü.

ownerType

Type

Bağımlılık özelliğini kaydeden sahip türü.

Döndürülenler

DependencyProperty

Sınıfınızdaki bir alanın değerini ayarlamak için kullanılması gereken bağımlılık public static readonly özelliği tanımlayıcısı. Bu tanımlayıcı daha sonra değerini program aracılığıyla ayarlama veya meta verileri alma gibi işlemler için bağımlılık özelliğine başvurmak için kullanılır.

Örnekler

Aşağıdaki örnek, bu RegisterAttached imzayı kullanarak soyut bir sınıfa ekli bir özelliği kaydeder.

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

Açıklamalar

Ekli özellik, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) tarafından tanımlanan bir özellik kavramıdır. WPF, bağımlılık özellikleri olarak ekli özellikleri uygular. WPF ekli özellikleri bağımlılık özellikleri olduğundan, raporlama düzeni özellikleri gibi işlemler için genel özellik sistemi tarafından kullanılabilecek meta veriler uygulanabilir. Daha fazla bilgi için bkz. Ekli Özelliklere Genel Bakış.

Bağımlılık özelliği kaydı hakkında daha fazla bilgi için bkz DependencyProperty. .

Ayrıca bkz.

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

RegisterAttached(String, Type, Type, PropertyMetadata)

Belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle ekli bir özelliği kaydeder.

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

Parametreler

name

String

Kaydedilecek bağımlılık özelliğinin adı.

propertyType

Type

Özelliğin türü.

ownerType

Type

Bağımlılık özelliğini kaydeden sahip türü.

defaultMetadata

PropertyMetadata

Bağımlılık özelliği için özellik meta verileri. Bu, varsayılan değerin yanı sıra diğer özellikleri de içerebilir.

Döndürülenler

DependencyProperty

Sınıfınızdaki bir alanın değerini ayarlamak için kullanılması gereken bağımlılık public static readonly özelliği tanımlayıcısı. Bu tanımlayıcı daha sonra değerini program aracılığıyla ayarlama veya meta verileri alma gibi işlemler için bağımlılık özelliğine başvurmak için kullanılır.

Açıklamalar

Ekli özellik, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) tarafından tanımlanan bir özellik kavramıdır. WPF, bağımlılık özellikleri olarak ekli özellikleri uygular. WPF ekli özellikleri bağımlılık özellikleri olduğundan, raporlama düzeni özellikleri gibi işlemler için genel özellik sistemi tarafından kullanılabilecek meta veriler uygulanabilir. Daha fazla bilgi için bkz. Ekli Özelliklere Genel Bakış.

Bağımlılık özelliği kaydı hakkında daha fazla bilgi için bkz DependencyProperty. .

Değer Devralan Bağımlılık Özellikleri için RegisterAttached Kullanma

bağımlılık özelliğinin yerine ile RegisterAttached Register kaydedilmesine yönelik belirli bir senaryo, özellik değeri devralmayı desteklemektir. Sınıf bağımlılık özelliğini kullanıma sunan özellik sarmalayıcı erişimcileri tanımlasa bile ve gerçek ekli özellik destek erişimcileri sağlamak için Get* ve Set* statik yöntemlerini kullanıma sunmayı amaçlamasanız bile, bağımlılık özelliklerini ile değer devralan bağımlılık özelliklerini RegisterAttached kaydetmeniz gerekir. Özellik değeri devralma işlemi eklenmemiş bağımlılık özellikleri için çalışıyor gibi görünse de, çalışma zamanı ağacındaki belirli öğe sınırları aracılığıyla eklenmemiş bir özelliğin devralma davranışı tanımlanmamıştır. Özelliğin etkin bir şekilde ekli olarak kaydedilmesi, ekli özelliği özellik sistemine genel bir özellik haline getirir ve özellik değeri devralma işleminin bir öğe ağacındaki tüm sınırlar boyunca çalışmasını sağlar. Meta verilerde belirttiğiniz Inherits özellikleri kaydetmek için her zaman kullanınRegisterAttached. Daha fazla bilgi için bkz . Özellik Değeri Devralma.

Ayrıca bkz.

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

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

Özelliğin belirtilen özellik türü, sahip türü, özellik meta verileri ve değer doğrulama geri çağırmasıyla ekli bir özelliği kaydeder.

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

Parametreler

name

String

Kaydedilecek bağımlılık özelliğinin adı.

propertyType

Type

Özelliğin türü.

ownerType

Type

Bağımlılık özelliğini kaydeden sahip türü.

defaultMetadata

PropertyMetadata

Bağımlılık özelliği için özellik meta verileri. Bu, varsayılan değerin yanı sıra diğer özellikleri de içerebilir.

validateValueCallback

ValidateValueCallback

Tipik tür doğrulamasının ötesinde bağımlılık özelliği değerinin herhangi bir özel doğrulamasını gerçekleştirmesi gereken bir geri çağırma başvurusu.

Döndürülenler

DependencyProperty

Sınıfınızdaki bir alanın değerini ayarlamak için kullanılması gereken bağımlılık public static readonly özelliği tanımlayıcısı. Bu tanımlayıcı daha sonra değerini program aracılığıyla ayarlama veya meta verileri alma gibi işlemler için bağımlılık özelliğine başvurmak için kullanılır.

Örnekler

Aşağıdaki örnek, bu RegisterAttached imzayı kullanarak soyut bir sınıfa ekli bir özelliği kaydeder. Bu ekli özellik bir numaralandırma türü özelliğidir ve kayıt, sağlanan değerin sabit listesi değeri olduğunu doğrulamak için bir doğrulama geri çağırması ekler.

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

Açıklamalar

Ekli özellik, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) tarafından tanımlanan bir özellik kavramıdır. WPF, bağımlılık özellikleri olarak ekli özellikleri uygular. WPF ekli özellikleri bağımlılık özellikleri olduğundan, raporlama düzeni özellikleri gibi işlemler için genel özellik sistemi tarafından kullanılabilecek meta veriler uygulanabilir. Daha fazla bilgi için bkz. Ekli Özelliklere Genel Bakış.

Bağımlılık özelliği kaydı hakkında daha fazla bilgi için bkz DependencyProperty. .

Değer Devralan Bağımlılık Özellikleri için RegisterAttached Kullanma

bağımlılık özelliğinin yerine ile RegisterAttached Register kaydedilmesine yönelik belirli bir senaryo, özellik değeri devralmayı desteklemektir. Sınıf bağımlılık özelliğini kullanıma sunan özellik sarmalayıcı erişimcileri tanımlasa bile ve gerçek ekli özellik destek erişimcileri sağlamak için Get* ve Set* statik yöntemlerini kullanıma sunmayı amaçlamasanız bile, bağımlılık özelliklerini ile değer devralan bağımlılık özelliklerini RegisterAttached kaydetmeniz gerekir. Özellik değeri devralma işlemi eklenmemiş bağımlılık özellikleri için çalışıyor gibi görünse de, çalışma zamanı ağacındaki belirli öğe sınırları aracılığıyla eklenmemiş bir özelliğin devralma davranışı tanımlanmamıştır. Özelliğin etkin bir şekilde ekli olarak kaydedilmesi, ekli özelliği özellik sistemine genel bir özellik haline getirir ve özellik değeri devralma işleminin bir öğe ağacındaki tüm sınırlar boyunca çalışmasını sağlar. Meta verilerde belirttiğiniz Inherits özellikleri kaydetmek için her zaman kullanınRegisterAttached. Daha fazla bilgi için bkz . Özellik Değeri Devralma.

Ayrıca bkz.

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