ReadOnlyArrayAttribute Třída

Definice

Obor názvů:

System.Runtime.InteropServices.WindowsRuntime

Sestavení:

System.Runtime.InteropServices.WindowsRuntime.dll

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

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ě prostředí Windows Runtime předán hodnotou (ByValv jazyce Visual Basic), musíte na něj použít jeden z následujících atributů:

• Použijte atribut, ReadOnlyArrayAttribute 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 provádění změn pole, najdete v tématu Předání polí komponentě prostředí Windows Runtime ve Windows Dev Center.

Důležité

Parametry s atributem ReadOnlyArrayAttribute 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 JavaScriptu nebo Visual C++), pole se zkopíruje, když volání překročí hranici binárního rozhraní aplikace (ABI). V případě potřeby se prvky převedou. Proto žádné náhodné změny, které metoda provede v poli pouze vstup, nejsou pro volající viditelné.

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

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 také způsobí 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()	Získá aktuální Type instanci. (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)

Viz také

• WriteOnlyArrayAttribute
• Winmdexp.exe (nástroj pro export metadat prostředí Windows Runtime)
• Vytváření komponent prostředí Windows Runtime v jazyce C# a Visual Basic
• Předání polí komponentě prostředí Windows Runtime