WriteOnlyArrayAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices.WindowsRuntime

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.WindowsRuntime.dll

Windows Runtime 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

Object

Attribute

WriteOnlyArrayAttribute

Öznitelikler

AttributeUsageAttribute

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 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, Windows Runtime 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 bir 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ğinin OutAttribute özniteliğine sahip bir parametreye uygulanması, parametrede Visual Basic ByRef değiştiricisi olmadığı sürece hataya neden olur. Bu durumda, özniteliği yedekli ancak izin verilir.

Oluşturucular

Name	Description
WriteOnlyArrayAttribute()	WriteOnlyArrayAttribute 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)

Ayrıca bkz.

• ReadOnlyArrayAttribute
• Winmdexp.exe (Windows Runtime Meta Veri Dışarı Aktarma Aracı)