WriteOnlyArrayAttribute Klasse

Definition

Bei Anwendung auf einem Arrayparameter in einer Komponente für Windows-Runtime wird angegeben, dass der Inhalt eines Arrays, das an diesen Parameter übergeben wird, nur für die Ausgabe verwendet wird. Der Aufrufer gewährleistet nicht, dass der Inhalt initialisiert wird, und die aufgerufene Methode soll den Inhalt nicht lesen.

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
Vererbung
WriteOnlyArrayAttribute
Attribute

Hinweise

Wenn ein Arrayparameter in Ihrer Windows-Runtime-Komponente als Wert (ByVal in Visual Basic) übergeben wird, müssen Sie eines der folgenden Attribute darauf anwenden:

  • Wenden Sie das ReadOnlyArrayAttribute Attribut an, wenn der Inhalt des Arrays nur für die Eingabe verwendet werden soll.

  • Wenden Sie das WriteOnlyArrayAttribute -Attribut an, wenn der Inhalt des Arrays nur für die Ausgabe verwendet werden soll (d. a. die -Methode legt den Inhalt des Arrays fest, liest sie jedoch nicht).

Das Anwenden beider Attribute auf einen Parameter verursacht einen Fehler. Weitere Informationen, einschließlich des Standardmusters zum Vornehmen von Änderungen an einem Array, finden Sie unter Übergeben von Arrays an eine Windows-Runtime-Komponente im Windows Dev Center.

Wichtig

Parameter mit dem WriteOnlyArrayAttribute -Attribut verhalten sich unterschiedlich, je nachdem, ob der Aufrufer in systemeigenem oder verwaltetem Code geschrieben ist. Wenn es sich bei dem Aufrufer um nativen Code (JavaScript- oder Visual C++-Komponentenerweiterungen) handelt, kann die aufgerufene Methode keine Annahmen über den Inhalt des ursprünglichen Arrays treffen. Beispielsweise ist das Array, das die Methode empfängt, möglicherweise nicht oder mit Standardwerten initialisiert. Von der Methode wird das Festlegen der Werte aller Elemente im Array erwartet.

Wenn der Aufrufer verwalteter Code ist, wird das ursprüngliche Array des Aufrufers an die aufgerufene Methode übergeben, wie es bei jedem Methodenaufruf in .NET Framework der Fall wäre. Arrayinhalte sind in verwaltetem Code veränderbar, sodass die Methode diese Werte selektiv lesen und ändern kann. Dies ist wichtig zu beachten, da es sich auf Komponententests auswirkt, die für eine Windows-Runtime-Komponente geschrieben wurden. Wenn die Tests in verwaltetem Code geschrieben werden, scheint der Inhalt eines Arrays während des Tests veränderlich zu sein, und die Ergebnisse sind wahrscheinlich anders, wenn die Methode später aus nativem Code aufgerufen wird.

Das Anwenden dieses Attributs auf einen out Parameter oder auf einen Parameter, der über das InAttribute -Attribut verfügt, verursacht beim Exportieren des Moduls einen Fehler. Das Anwenden des Attributs auf einen Parameter mit dem OutAttribute -Attribut verursacht einen Fehler, es sei denn, der Parameter verfügt ebenfalls über den Visual Basic-Modifizierer ByRef . In diesem Fall ist das Attribut redundant, aber zulässig.

Konstruktoren

WriteOnlyArrayAttribute()

Initialisiert eine neue Instanz der WriteOnlyArrayAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.

(Geerbt von Attribute)

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen