WriteOnlyArrayAttribute Osztály

Definíció

Névtér:
System.Runtime.InteropServices.WindowsRuntime
Szerelvények:
mscorlib.dll, System.Runtime.InteropServices.WindowsRuntime.dll
Szerelvény:
mscorlib.dll

Ha egy Windows-futtatókörnyezet összetevő tömbparaméterére van alkalmazva, azt határozza meg, hogy az adott paraméternek átadott tömb tartalma csak a kimenethez legyen használva. A hívó nem garantálja a tartalom inicializálását, és a hívott metódus nem olvassa be a tartalmat.

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
Öröklődés
Object
Attribute
WriteOnlyArrayAttribute
Attribútumok
AttributeUsageAttribute

Megjegyzések

Ha a Windows-futtatókörnyezet összetevő egyik tömbparaméterét érték adja át (ByVal Visual Basic), az alábbi attribútumok egyikét kell alkalmaznia rá:

  • Alkalmazza az ReadOnlyArrayAttribute attribútumot, ha a tömb tartalmát csak bemenetként szeretné használni.

  • Alkalmazza az WriteOnlyArrayAttribute attribútumot, ha a tömb tartalmát csak a kimenethez kívánja használni (vagyis a metódus beállítja a tömb tartalmát, de nem olvassa be őket).

Ha mindkét attribútumot egy paraméterre alkalmazza, az hibát okoz. További információkért, beleértve a tömbök módosításának szabványos mintáját is, tekintse meg a Tömbök Windows-futtatókörnyezet összetevőre való váltását a Windows Fejlesztői központban.

Important

Az attribútummal rendelkező WriteOnlyArrayAttribute paraméterek eltérően viselkednek attól függően, hogy a hívó natív kódban vagy felügyelt kódban van-e megírva. Ha a hívó natív kód (JavaScript vagy Visual C++ összetevőbővítmények), a hívott metódus nem tud feltételezni az eredeti tömb tartalmát. Előfordulhat például, hogy a metódus által kapott tömb nincs inicializálva, vagy alapértelmezett értékeket tartalmazhat. A metódus várhatóan a tömb összes elemének értékeit állítja be.

Ha a hívó felügyelt kód, a hívó eredeti tömbje át lesz adva a hívott metódusnak, ahogyan az a .NET-keretrendszer bármely metódushívásában szerepelne. A tömb tartalma módosítható a felügyelt kódban, így a metódus szelektíven olvashatja és módosíthatja ezeket az értékeket. Ez azért fontos, mert hatással van egy Windows-futtatókörnyezet összetevőhöz írt egységtesztekre. Ha a tesztek felügyelt kódban vannak megírva, a tömb tartalma a tesztelés során mutablenak tűnik, és az eredmények valószínűleg eltérnek, ha a metódust később natív kódból hívják meg.

Ha ezt az attribútumot egy out paraméterre vagy egy olyan paraméterre alkalmazza, amely rendelkezik az InAttribute attribútummal, hibát okoz a modul exportálásakor. Ha az attribútumot a OutAttribute attribútummal rendelkező paraméterre alkalmazza, hibát okoz, kivéve, ha a paraméter Visual Basic ByRef módosítóval is rendelkezik. Ebben az esetben az attribútum redundáns, de engedélyezett.

Konstruktorok

Name Description
WriteOnlyArrayAttribute()

Inicializálja a WriteOnlyArrayAttribute osztály új példányát.

Tulajdonságok

Name Description
TypeId

Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap.

(Öröklődés forrása Attribute)

Metódusok

Name Description
Equals(Object)

Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal.

(Öröklődés forrása Attribute)
GetHashCode()

A példány kivonatkódját adja vissza.

(Öröklődés forrása Attribute)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
IsDefaultAttribute()

Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke.

(Öröklődés forrása Attribute)
Match(Object)

Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e.

(Öröklődés forrása Attribute)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

Explicit interfész-implementációk

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Névkészletet képez le a küldési azonosítók megfelelő készletére.

(Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók.

(Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1).

(Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz.

(Öröklődés forrása Attribute)

A következőre érvényes:

Lásd még