ReadOnlyArrayAttribute Sınıf
Tanım
Ö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.
bir Windows Runtime bileşenindeki bir dizi parametresine uygulandığında, bu parametreye geçirilen dizinin içeriğinin yalnızca giriş için kullanıldığını belirtir. Çağıran, çağrı tarafından dizi değişmesini bekler.
public ref class ReadOnlyArrayAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class ReadOnlyArrayAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type ReadOnlyArrayAttribute = class
inherit AttributePublic NotInheritable Class ReadOnlyArrayAttribute
Inherits Attribute- Devralma
- Öznitelikler
Açıklamalar
Windows Runtime bileşeninizdeki bir dizi parametresi değere (Visual Basic ByVal) geçirilirse, buna aşağıdaki özniteliklerden birini uygulamanız gerekir:
Dizinin içeriğinin ReadOnlyArrayAttribute yalnızca giriş için kullanılmasını istiyorsanız özniteliğini uygulayın.
WriteOnlyArrayAttribute Dizinin içeriğinin yalnızca çıkış için kullanılmasını planlıyorsanız özniteliğini uygulayın (yani, yöntemi dizinin içeriğini ayarlar ancak bunları okumaz).
Bir parametreye her iki özniteliğin de uygulanması hataya neden olur.
Önemli
Özniteliği olan parametreler, çağıranın ReadOnlyArrayAttribute yerel kodda mı yoksa yönetilen kodda mı yazdığına bağlı olarak farklı davranır. Çağıran yerel kodsa (JavaScript veya Visual C++ bileşen uzantıları), çağrı uygulama ikili arabirimi (ABI) sınırını aştığında dizi kopyalanır. Gerekirse öğeler dönüştürülür. Bu nedenle, yöntemin yalnızca giriş dizisine yaptığı yanlışlıkla yapılan değişiklikler çağıran tarafından görünmez.
Çağıran yönetilen kodsa, dizi kopyalanmaz. Özgün dizi, .NET Framework'teki herhangi bir yöntem çağrısında olabileceğinden çağrılan yöntem için kullanılabilir. Dizi içeriği .NET Framework kodunda değiştirilebilir, bu nedenle yöntemin dizide yaptığı tüm değişiklikler çağıran tarafından görülebilir. Bu, Windows Runtime bileşeni için yazılmış birim testlerini etkilediği için unutmamanız önemlidir. Testler yönetilen kodda yazılmışsa, test sırasında bir dizinin içeriği değişebilir gibi görünür.
Bu özniteliğin veya InAttribute özniteliğine sahip bir parametreye OutAttribute uygulanması, modül dışarı aktarıldığında hataya neden olur. Özniteliğin bir out parametreye uygulanması da hataya neden olur.
Oluşturucular
| Name | Description |
|---|---|
| ReadOnlyArrayAttribute() |
ReadOnlyArrayAttribute sınıfının yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| TypeId |
Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute) |
Yöntemler
| Name | Description |
|---|---|
| Equals(Object) |
Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute) |
| GetHashCode() |
Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute) |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| IsDefaultAttribute() |
Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute) |
| Match(Object) |
Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute) |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır. (Devralındığı yer: Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bir nesne tarafından kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute) |
