DependencyProperty.RegisterAttachedReadOnly 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.

Salt okunur ekli özelliği kaydeder.

Aşırı Yüklemeler

Name	Description
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ı ile salt okunur ekli bir ö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 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 ortak 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 herhangi birinin DependencyPropertyKey erişimini ve görünürlüğünü 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 kod 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 DependencyPropertyKey.DependencyProperty özelliği tanımlayıcısını public static readonly kullanıma sunmanız önerilir.

Ekli bir özelliğin birincil senaryosu XAML'de kullanımı olduğundan salt okunur ekli özellikler nadir bir senaryodur. Genel ayarlayıcı olmadan, ekli bir ö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 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.

Şunlara uygulanır

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

Belirtilen özellik türü, sahip türü, özellik meta verileri ve doğrulama geri çağırması ile salt okunur ekli bir ö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

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

Döndürülenler

DependencyPropertyKey

Sınıfınızdaki statik salt okunur bir alanın değerini ayarlamak için kullanılması gereken ve ardından bağımlılık özelliğine başvurmak için kullanılan 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, türünü DependencyPropertytemsil eden anahtarlar. Genellikle, salt okunur özellikleri temsil eden anahtarlar ortak 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 herhangi birinin DependencyPropertyKey erişimini ve görünürlüğünü 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 kod 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 DependencyPropertyKey.DependencyProperty özelliği tanımlayıcısını public static readonly kullanıma sunmanız önerilir.

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 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.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?