ReadOnlyArrayAttribute Třída

Definice

Obor názvů:

System.Runtime.InteropServices.WindowsRuntime

Sestavení:

System.Runtime.InteropServices.WindowsRuntime.dll

Při použití na parametr pole v komponentě Windows Runtime určuje, že obsah pole, který se předá ho ho parametru, se používá pouze pro vstup. Volající očekává, že se pole 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

Object

Attribute

ReadOnlyArrayAttribute

Atributy

AttributeUsageAttribute

Poznámky

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

• ReadOnlyArrayAttribute Atribut použijte, 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 je).

Použití obou atributů u parametru způsobí chybu.

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 kódu nebo spravovaném kódu. Pokud je volající nativní kód (rozšíření komponent Jazyka JavaScript nebo Visual C++), pole se zkopíruje při volání přes hranice binárního rozhraní aplikace (ABI). Prvky se v případě potřeby převedou. Proto všechny náhodné změny provedené metodou v poli jen pro vstup nejsou viditelné volajícímu.

Pokud je volající spravovaný kód, pole se nezkopíruje. Původní pole je k dispozici pro volanou metodu, protože by byla v jakémkoli volání metody v .NET Framework. Obsah pole je v kódu .NET Framework proměnlivý, takže všechny změny, které metoda provede v poli, jsou viditelné volajícímu. Je důležité si uvědomit, protože ovlivňuje testy jednotek napsané pro komponentu Windows Runtime. Pokud jsou testy napsané ve spravovaném kódu, obsah pole bude během testování proměnlivý.

Použití tohoto atributu na parametr s atributem InAttribute nebo OutAttribute atributem způsobí chybu při exportu modulu. Použití atributu na out parametr také způsobí chybu.

Konstruktory

Name	Description
ReadOnlyArrayAttribute()	Inicializuje novou instanci ReadOnlyArrayAttribute třídy.

Vlastnosti

Name	Description
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je 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á určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• WriteOnlyArrayAttribute
• Winmdexp.exe (nástroj pro export metadat Windows Runtime)