Freigeben über

Platform::WriteOnlyArray-Klasse

  • Artikel

Stellt ein eindimensionales Array dar, das als Eingabeparameter verwendet wird, wenn der Aufrufer ein Array für die zu füllende Methode übergibt.

Diese Verweisklasse wird als privat in vccorlib.h deklariert. Daher wird sie nicht in Metadaten ausgegeben und kann nur von C++ verwendet werden. Diese Klasse ist nur zur Verwendung als Eingabeparameter vorgesehen, der ein Array empfängt, das der Aufrufer zugeordnet hat. Sie ist nicht vom Benutzercode konstruierbar. Sie ermöglicht es einer C++-Methode, direkt in dieses Array zu schreiben – ein Muster, das als FillArray -Muster bezeichnet wird. Weitere Informationen finden Sie unter Array und WriteOnlyArray.

Syntax

private ref class WriteOnlyArray<T, 1>

Member

Öffentliche Methoden

Diese Methoden verfügen über interne Zugreifbarkeit, das heißt, sie sind nur innerhalb der C++-App oder -Komponente zugänglich.

Name Beschreibung
WriteOnlyArray::begin Ein Iterator, der auf das erste Element des Arrays zeigt.
WriteOnlyArray::D ata Ein Zeiger auf den Datenpuffer.
WriteOnlyArray::end Ein Iterator, der auf einen Punkt hinter dem letzten Element im Array zeigt.
WriteOnlyArray::FastPass Gibt an, ob das Array den FastPass-Mechanismus verwenden kann. Dieser stellt eine Optimierung dar, die transparent vom System ausgeführt wird. Verwenden Sie dies nicht in Ihrem Code.
WriteOnlyArray::Length Gibt die Anzahl der Elemente des Arrays zurück.
WriteOnlyArray::set Legt das angegebene Element auf den angegebenen Wert fest.

Vererbungshierarchie

WriteOnlyArray

Anforderungen

Compileroption: /ZW

Metadaten: platform.winmd

Namespace: Platform

WriteOnlyArray::begin-Methode

Gibt einen Zeiger auf das erste Element im Array zurück.

Syntax

T* begin() const;

Rückgabewert

Ein Zeiger auf das erste Element im Array.

Hinweise

Dieser Iterator kann mit STL-Algorithmen wie std::sort verwendet werden, um Vorgänge auf Elemente im Array auszuführen.

WriteOnlyArray::Data-Eigenschaft

Zeiger auf den Datenpuffer.

Syntax

property T* Data{
   T* get() const;
}

Rückgabewert

Ein Zeiger auf unformatierte Arraybytes.

WriteOnlyArray::end-Methode

Gibt einen Zeiger auf einen Punkt hinter dem letzten Element im Array zurück.

Syntax

T* end() const;

Rückgabewert

Ein Zeigeriterator auf einen Punkt hinter dem letzten Element im Array.

Hinweise

Dieser Iterator kann mit STL-Algorithmen verwendet werden, um Vorgänge wie std::sort auf die Array-Elemente auszuführen.

WriteOnlyArray::FastPass-Eigenschaft

Gibt an, ob die interne FastPass-Optimierung ausgeführt werden kann. Ist nicht für die Verwendung in Benutzercode bestimmt.

Syntax

property bool FastPass{
   bool get() const;
}

Rückgabewert

Boolescher Wert, der angibt, ob das Array FastPass ist.

WriteOnlyArray::get-Methode

Gibt das Element am angegebenen Index zurück.

Syntax

T& get(unsigned int indexArg) const;

Parameter

indexArg
Der zu verwendende Index.

Rückgabewert

WriteOnlyArray::Length-Eigenschaft

Gibt die Anzahl der Elemente im vom Aufrufer reservierten Array zurück.

Syntax

property unsigned int Length{
   unsigned int get() const;
}

Rückgabewert

Die Anzahl der -Elemente im Array.

WriteOnlyArray::set-Funktion

Legt den angegebenen Wert am angegebenen Index im Array fest.

Syntax

T& set(
   unsigned int indexArg,
   T valueArg);

Parameter

indexArg
Der Index des festzulegenden Elements.

valueArg
Der bei indexArg festzulegende Wert.

Rückgabewert

Ein Verweis auf das Element, das gerade festgelegt wurde.

Hinweise

Weitere Informationen zum Interpretieren des HRESULT-Werts finden Sie unter Struktur der COM-Fehlercodes.

Siehe auch

Plattformnamespace
Erstellen von Komponenten für Windows-Runtime in C++