DependencyProperty.RegisterAttachedReadOnly Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Salt okunur bir ekli özelliği kaydeder.

Aşırı Yüklemeler

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Belirtilen özellik türü, sahip türü ve özellik meta verileriyle salt okunur bir ekli özelliği kaydeder.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Belirtilen özellik türü, sahip türü, özellik meta verileri ve doğrulama geri çağırmasıyla salt okunur bir ekli özelliği kaydeder.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

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

public:
 static System::Windows::DependencyPropertyKey ^ RegisterAttachedReadOnly(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);

public static System.Windows.DependencyPropertyKey RegisterAttachedReadOnly (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);

static member RegisterAttachedReadOnly : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyPropertyKey

Public Shared Function RegisterAttachedReadOnly (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyPropertyKey

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.

Döndürülenler

DependencyPropertyKey

Sınıfınızdaki statik bir salt okunur alanın değerini ayarlamak için kullanılması gereken ve daha sonra bağımlılık özelliğine başvurmak için kullanılacak bağımlılık özellik anahtarı.

Açıklamalar

Bu yöntem türünü DependencyPropertyKeydöndürürken RegisterAttached , türünü DependencyPropertydöndürür. Genellikle, salt okunur özellikleri temsil eden anahtarlar genel yapılmaz, çünkü anahtarlar çağrılarak SetValue(DependencyPropertyKey, Object)bağımlılık özelliği değerini ayarlamak için kullanılabilir. Sınıf tasarımınız gereksinimlerinizi etkiler, ancak bunların erişimini ve görünürlüğünü kodunuzun DependencyPropertyKey yalnızca bu bağımlılık özelliğini sınıf veya uygulama mantığının bir parçası olarak ayarlamak için gerekli olan bölümleriyle sınırlamanız önerilir. Ayrıca, değerini sınıfınızda bir alan olarak kullanıma sunarak salt okunur bağımlılık özelliği için bağımlılık public static readonly özelliği tanımlayıcısını DependencyPropertyKey.DependencyProperty kullanıma sunmanız önerilir.

Ekli bir özelliğin birincil senaryosu XAML'de kullanılması olduğundan salt okunur ekli özellikler nadir bir senaryodur. Ortak ayarlayıcı olmadan, ekli özellik XAML söz diziminde ayarlanamaz.

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ğini ekli olarak 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 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.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Belirtilen özellik türü, sahip türü, özellik meta verileri ve doğrulama geri çağırmasıyla salt okunur bir ekli özelliği kaydeder.

public:
 static System::Windows::DependencyPropertyKey ^ RegisterAttachedReadOnly(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

public static System.Windows.DependencyPropertyKey RegisterAttachedReadOnly (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);

static member RegisterAttachedReadOnly : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyPropertyKey

Public Shared Function RegisterAttachedReadOnly (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyPropertyKey

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.

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, kullanıcı tarafından oluşturulan bir geri çağırma başvurusu.

Döndürülenler

DependencyPropertyKey

Sınıfınızdaki statik bir salt okunur alanın değerini ayarlamak için kullanılması gereken bağımlılık özellik anahtarı, bağımlılık özelliğine başvurmak için kullanılır.

Açıklamalar

Bu yöntem türünü DependencyPropertyKeydöndürürken RegisterAttached , türünü DependencyPropertydöndürür. Genellikle, türünü DependencyPropertytemsil eden anahtarlar. Genellikle, salt okunur özellikleri temsil eden anahtarlar genel yapılmaz, çünkü anahtarlar çağrılarak SetValue(DependencyPropertyKey, Object)bağımlılık özelliği değerini ayarlamak için kullanılabilir. Sınıf tasarımınız gereksinimlerinizi etkiler, ancak bunların erişimini ve görünürlüğünü kodunuzun DependencyPropertyKey yalnızca bu bağımlılık özelliğini sınıf veya uygulama mantığının bir parçası olarak ayarlamak için gerekli olan bölümleriyle sınırlamanız önerilir. Ayrıca, değerini sınıfınızda bir alan olarak kullanıma sunarak salt okunur bağımlılık özelliği için bağımlılık public static readonly özelliği tanımlayıcısını DependencyPropertyKey.DependencyProperty kullanıma sunmanız önerilir.

Ekli bir özelliğin birincil senaryosu XAML'de kullanılması olduğundan salt okunur ekli özellikler nadir bir senaryodur. Ortak ayarlayıcı olmadan, ekli özellik XAML söz diziminde ayarlanamaz.

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 ekli Register olarak 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.