ReadOnlyArrayAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- 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é
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat Problémy GitHubu jako mechanismus zpětné vazby pro obsah a nahradíme ho novým systémem zpětné vazby. Další informace najdete tady:Odeslat a zobrazit názory pro