ReadOnlyArrayAttribute Třída

Definice

Při použití parametru pole v komponentě prostředí Windows Runtime určuje, že obsah pole, který je předán ho parametru, se použije pouze pro vstup. Volající očekává, že pole se nezmění voláním.

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
Dědičnost
ReadOnlyArrayAttribute
Atributy

Poznámky

Pokud je parametr pole v komponentě prostředí Windows Runtime předán hodnotou (ByVal v jazyce Visual Basic), musíte na něj použít jeden z následujících atributů:

  • ReadOnlyArrayAttribute Použijte atribut , pokud chcete obsah pole použít pouze pro vstup.

  • WriteOnlyArrayAttribute Použijte atribut , pokud chcete obsah pole použít pouze pro výstup (to znamená, že metoda nastaví obsah pole, ale nečte ho).

Použití obou atributů na parametr způsobí chybu. Další informace, včetně standardního vzoru pro provádění změn pole, najdete v tématu Předávání polí komponentě prostředí Windows Runtime na webu Windows Dev Center.

Důležité

Parametry, které mají ReadOnlyArrayAttribute atribut , se chovají odlišně v závislosti na tom, jestli je volající napsaný v nativním nebo spravovaném kódu. Pokud je volající nativní kód (rozšíření komponent Jazyka JavaScript nebo Visual C++), pole se zkopíruje, když volání překročí hranici binárního rozhraní aplikace (ABI). Prvky jsou v případě potřeby převedeny. Proto žádné náhodné změny, které metoda provede v poli pouze vstup, nejsou viditelné volajícímu.

Pokud je volající spravovaný kód, pole se nekopíruje. Původní pole je k dispozici pro volanou metodu, stejně jako v jakémkoli volání metody v rozhraní .NET Framework. Obsah pole je v kódu rozhraní .NET Framework měnitelný, takže všechny změny provedené metodou v poli jsou viditelné volajícímu. To je důležité si uvědomit, protože ovlivňuje testy jednotek napsané pro prostředí Windows Runtime komponentu. Pokud jsou testy napsané ve spravovaném kódu, obsah pole se bude zdát během testování měnitelný.

Použití tohoto atributu na parametr, který má InAttribute atribut nebo OutAttribute způsobí chybu při exportu modulu. Použití atributu na out parametr způsobí také chybu.

Konstruktory

ReadOnlyArrayAttribute()

Inicializuje novou instanci ReadOnlyArrayAttribute třídy .

Vlastnosti

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu .

(Zděděno od Attribute)

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

(Zděděno od Attribute)
GetHashCode()

Vrátí hodnotu hash pro tuto instanci.

(Zděděno od Attribute)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro

Viz také