ReadOnlyArrayAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices.WindowsRuntime

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.WindowsRuntime.dll

bir Windows Çalışma Zamanı 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, dizisinin çağrı tarafından değiştirilmemesini 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 Attribute

Public NotInheritable Class ReadOnlyArrayAttribute
Inherits Attribute

Devralma

Object

Attribute

ReadOnlyArrayAttribute

Öznitelikler

AttributeUsageAttribute

Açıklamalar

Windows Çalışma Zamanı bileşeninizdeki bir dizi parametresi değere (ByValVisual 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ı düşünüyorsanız özniteliğini uygulayın.

• WriteOnlyArrayAttribute Dizinin içeriğinin yalnızca çıkış için kullanılmasını amaçlı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. 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 ReadOnlyArrayAttribute yerel kodda mı yoksa yönetilen kodda mı yazıldığını 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 herhangi bir yöntem çağrısında olabileceğinden, çağrılan yöntem tarafından kullanılabilir. Dizi içeriği .NET Framework kodda değiştirilebilir, bu nedenle yöntemin dizide yaptığı tüm değişiklikler çağıran tarafından görülebilir. Bu, Windows Çalışma Zamanı bir bileşen için yazılmış birim testlerini etkilediği için unutulmamak gerekir. Testler yönetilen kodda yazılırsa, bir dizinin içeriği test sırasında değiştirilebilir gibi görünür.

Bu özniteliğin veya OutAttribute özniteliğine sahip bir parametreye InAttribute uygulanması, modül dışarı aktarıldığında hataya neden olur. Özniteliğin bir out parametreye uygulanması da hataya neden olur.

Oluşturucular

ReadOnlyArrayAttribute()

ReadOnlyArrayAttribute 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)

Ayrıca bkz.

• WriteOnlyArrayAttribute
• Winmdexp.exe (Windows Çalışma Zamanı Meta Veri Dışarı Aktarma Aracı)
• C# ve Visual Basic'te Windows Çalışma Zamanı Bileşenleri Oluşturma
• Dizileri bir Windows Çalışma Zamanı bileşenine geçirme