WriteOnlyArrayAttribute 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 Çalışma Zamanı bileşenindeki bir dizi parametresine uygulandığında, bu parametreye geçirilen dizinin içeriğinin yalnızca çıkış için kullanıldığını belirtir. Çağıran, içeriğin başlatıldığını garanti etmez ve çağrılan yöntemin içeriği okumaması gerekir.
public ref class WriteOnlyArrayAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class WriteOnlyArrayAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type WriteOnlyArrayAttribute = class
inherit Attribute
Public NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute
- Devralma
- Öznitelikler
Açıklamalar
Windows Çalışma Zamanı bileşeninizdeki bir dizi parametresi değere (ByVal
Visual Basic'te) geçirilirse, buna aşağıdaki özniteliklerden birini uygulamanız gerekir:
Dizinin içeriğinin ReadOnlyArrayAttribute yalnızca giriş için kullanılmasını amaçlıyorsanız özniteliğini uygulayın.
WriteOnlyArrayAttribute Dizinin içeriğinin yalnızca çıkış için kullanılmasını düşünüyorsanız özniteliğini uygulayın (diğer bir ifadeyle yöntem dizinin içeriğini ayarlar ancak bunları okumaz).
Bir parametreye her iki özniteliğin de uygulanması hataya neden olur. Dizide değişiklik yapmaya yönelik standart desen de dahil olmak üzere daha fazla bilgi için bkz. Windows Geliştirme Merkezi'nde dizileri Windows Çalışma Zamanı bileşenine geçirme .
Önemli
özniteliğine sahip parametreler, çağıranın WriteOnlyArrayAttribute 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ılan yöntem özgün dizinin içeriği hakkında herhangi bir varsayımda bulunamaz. Örneğin, yöntemin aldığı dizi başlatılamayabilir veya varsayılan değerler içerebilir. yönteminin dizideki tüm öğelerin değerlerini ayarlaması beklenir.
Çağıran yönetilen kodsa, çağıranın özgün dizisi .NET Framework'teki herhangi bir yöntem çağrısında olduğu gibi çağrılan yönteme geçirilir. Dizi içeriği yönetilen kodda değişebilir, bu nedenle yöntemi bu değerleri seçmeli olarak okuyabilir ve değiştirebilir. Bu, bir Windows Çalışma Zamanı bileşeni için yazılmış birim testlerini etkilediği için unutmamanız önemlidir. Testler yönetilen kodda yazılırsa, test sırasında dizinin içeriği değişebilir gibi görünür ve yöntem daha sonra yerel koddan çağrılırsa sonuçlar büyük olasılıkla farklı olacaktır.
Bu özniteliğin bir out
parametreye veya özniteliğine sahip bir parametreye InAttribute uygulanması, modül dışarı aktarıldığında hataya neden olur. Özniteliğin özniteliğini içeren OutAttribute bir parametreye uygulanması, parametrenin Visual Basic ByRef
değiştiricisi de yoksa bir hataya neden olur. Bu durumda, özniteliği yedeklidir ancak izin verilir.
Oluşturucular
WriteOnlyArrayAttribute() |
WriteOnlyArrayAttribute sınıfının yeni bir örneğini başlatır. |
Özellikler
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
Equals(Object) |
Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute) |
GetHashCode() |
Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute) |
GetType() |
Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
_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 sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute) |