ReadOnlyArrayAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices.WindowsRuntime

Zestaw:

System.Runtime.InteropServices.WindowsRuntime.dll

Po zastosowaniu do parametru tablicy w składniku środowisko wykonawcze systemu Windows określa zawartość tablicy, która jest przekazywana do tego parametru, są używane tylko dla danych wejściowych. Obiekt wywołujący oczekuje, że tablica pozostanie niezmieniona przez wywołanie.

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

Dziedziczenie

Object

Attribute

ReadOnlyArrayAttribute

Atrybuty

AttributeUsageAttribute

Uwagi

Jeśli parametr tablicy w składniku środowisko wykonawcze systemu Windows jest przekazywany przez wartość (ByVal w Visual Basic), należy zastosować do niego jeden z następujących atrybutów:

• Zastosuj atrybut, ReadOnlyArrayAttribute jeśli zawartość tablicy ma być używana tylko do wprowadzania.

• Zastosuj atrybut, WriteOnlyArrayAttribute jeśli zawartość tablicy ma być używana tylko do danych wyjściowych (czyli metoda ustawia zawartość tablicy, ale nie odczytuje ich).

Zastosowanie obu atrybutów do parametru powoduje błąd. Aby uzyskać więcej informacji, w tym standardowy wzorzec wprowadzania zmian w tablicy, zobacz Przekazywanie tablic do składnika środowisko wykonawcze systemu Windows w Centrum deweloperów systemu Windows.

Ważne

Parametry, które mają ReadOnlyArrayAttribute atrybut, zachowują się inaczej w zależności od tego, czy obiekt wywołujący jest napisany w kodzie natywnym, czy w kodzie zarządzanym. Jeśli obiekt wywołujący jest kodem natywnym (rozszerzenia składników Języka JavaScript lub Visual C++), tablica jest kopiowana po przekroczeniu granicy interfejsu binarnego aplikacji (ABI). Elementy są konwertowane w razie potrzeby. W związku z tym wszelkie przypadkowe zmiany wprowadzone przez metodę do tablicy tylko do wprowadzania nie są widoczne dla obiektu wywołującego.

Jeśli obiekt wywołujący jest kodem zarządzanym, tablica nie zostanie skopiowana. Oryginalna tablica jest dostępna dla wywoływanej metody, tak jak w każdym wywołaniu metody w .NET Framework. Zawartość tablicy jest modyfikowalna w kodzie .NET Framework, więc wszelkie zmiany wprowadzone w metodzie do tablicy są widoczne dla obiektu wywołującego. Należy pamiętać, że ma to wpływ na testy jednostkowe napisane dla składnika środowisko wykonawcze systemu Windows. Jeśli testy są napisane w kodzie zarządzanym, zawartość tablicy będzie wydawała się być modyfikowalna podczas testowania.

Zastosowanie tego atrybutu do parametru z InAttribute atrybutem lub OutAttribute powoduje błąd podczas eksportowania modułu. Zastosowanie atrybutu do parametru out powoduje również błąd.

Konstruktory

ReadOnlyArrayAttribute()

Inicjuje nowe wystąpienie klasy ReadOnlyArrayAttribute.

Właściwości

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• WriteOnlyArrayAttribute
• Winmdexp.exe (narzędzie do eksportowania metadanych środowisko wykonawcze systemu Windows)
• Tworzenie składników środowisko wykonawcze systemu Windows w językach C# i Visual Basic
• Przekazywanie tablic do składnika środowisko wykonawcze systemu Windows