DependencyProperty.RegisterAttached Yöntem

Tanım

Ad Alanı:: System.Windows

Bütünleştirilmiş Kod:: WindowsBase.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Ekli bir özelliği özellik sistemine kaydeder.

Aşırı Yüklemeler

Name	Description
RegisterAttached(String, Type, Type)	Belirtilen özellik adı, özellik türü ve sahip türüyle ekli bir özelliği kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata)	Eklenen özelliği belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Ekli bir özelliği belirtilen özellik türüne, sahip türüne, özellik meta verilerine ve özellik için değer doğrulama geri çağırmaya kaydeder.

RegisterAttached(String, Type, Type)

Belirtilen özellik adı, özellik türü ve sahip türüyle 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 ekli özellikleri bağımlılık özellikleri olarak uygular. WPF eklenen özellikler 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.

Şunlara uygulanır

RegisterAttached(String, Type, Type, PropertyMetadata)

Eklenen özelliği belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle 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

Açıklamalar

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

yerine ile bağımlılık özelliğini RegisterAttached Register kaydetmeye 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 desteği erişimcileri sağlamak için Get* ve Set* statik yöntemlerini kullanıma sunmayı amaçlamasanız bile, ile değer devralan bağımlılık özelliklerini RegisterAttached kaydetmeniz gerekir. Özellik değeri devralma, 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ğin özellik sistemine genel bir özellik olmasını sağlar ve özellik değeri devralma işleminin bir öğe ağacındaki tüm sınırlarda çalışmasını sağlar. Meta verilerde RegisterAttached belirtilmişse, özellikleri kaydetmek için her zaman Inherits kullanın. Daha fazla bilgi için bkz. Özellik Değeri Devralma.

Ayrıca bkz.

Şunlara uygulanır

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

Ekli bir özelliği belirtilen özellik türüne, sahip türüne, özellik meta verilerine ve özellik için değer doğrulama geri çağırmaya 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

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

Döndürülenler

DependencyProperty

Ö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

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

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?