WriteOnlyArrayAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices.WindowsRuntime

Zestaw:

System.Runtime.InteropServices.WindowsRuntime.dll

Po zastosowaniu do parametru tablicy w składniku środowiska wykonawczego systemu Windows określa zawartość tablicy, która jest przekazywana do tego parametru, są używane tylko dla danych wyjściowych. Obiekt wywołujący nie gwarantuje, że zawartość jest zainicjowana, a wywołana metoda nie powinna odczytywać zawartości.

public ref class WriteOnlyArrayAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class WriteOnlyArrayAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type WriteOnlyArrayAttribute = class
    inherit Attribute

Public NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

WriteOnlyArrayAttribute

Atrybuty

AttributeUsageAttribute

Uwagi

Jeśli parametr tablicy w składniku środowiska wykonawczego 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 środowiska uruchomieniowego systemu Windows w Centrum deweloperów systemu Windows.

Ważne

Parametry, które mają WriteOnlyArrayAttribute 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 (rozszerzeniami składników JavaScript lub Visual C++), wywołana metoda nie może założyć żadnych założeń dotyczących zawartości oryginalnej tablicy. Na przykład tablica odbierana przez metodę może nie zostać zainicjowana lub może zawierać wartości domyślne. Oczekuje się, że metoda ustawi wartości wszystkich elementów w tablicy.

Jeśli obiekt wywołujący jest kodem zarządzanym, oryginalna tablica obiektu wywołującego jest przekazywana do wywoływanej metody, tak jak w każdym wywołaniu metody w programie .NET Framework. Zawartość tablicy jest modyfikowalna w kodzie zarządzanym, więc metoda może selektywnie odczytywać i zmieniać te wartości. Należy pamiętać, że ma to wpływ na testy jednostkowe napisane dla składnika środowiska uruchomieniowego systemu Windows. Jeśli testy są napisane w kodzie zarządzanym, zawartość tablicy będzie prawdopodobnie modyfikowalna podczas testowania, a wyniki prawdopodobnie będą się różnić, jeśli metoda zostanie wywołana z kodu natywnego później.

Zastosowanie tego atrybutu do parametru out lub do parametru InAttribute , który ma atrybut powoduje błąd podczas eksportowania modułu. Zastosowanie atrybutu do parametru, który ma OutAttribute atrybut powoduje błąd, chyba że parametr ma również modyfikator Języka Visual Basic ByRef . W takim przypadku atrybut jest nadmiarowy, ale dozwolony.

Konstruktory

WriteOnlyArrayAttribute()

Inicjuje nowe wystąpienie klasy WriteOnlyArrayAttribute.

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ż

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