Platform::StringReference-Klasse
Ein Optimierungstyp, den Sie verwenden können, um Zeichenfolgendaten in Platform::String^ Eingabeparametern mit minimalem Kopiervorgängen weitere Methoden zu übergeben.
Syntax
class StringReference
Hinweise
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| StringReference::StringReference | Zwei Konstruktoren für das Erstellen von Instanzen von StringReference. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| StringReference::D ata | Gibt die Zeichenfolgendaten als char16-Wertearray zurück. |
| StringReference::Length | Gibt die Anzahl der Zeichen in der Zeichenfolge zurück. |
| StringReference::GetHSTRING | Gibt die Zeichenfolgendaten als HSTRING zurück. |
| StringReference::GetString | Gibt die Zeichenfolgendaten als Platform::String^zurück. |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
| StringReference::operator= | Weist ein StringReference -Element einer neuen StringReference -Instanz zu. |
| StringReference::operator() | Konvertiert ein StringReference -Element in ein Platform::String^-Element. |
Anforderungen
Mindestens unterstützter Client: Windows 8
Mindestens unterstützter Server: Windows Server 2012
Namespace: Platform
Header: vccorlib.h
StringReference::Data-Methode
Gibt die Inhalte dieses StringReference als char16-Wertearray zurück.
Syntax
const ::default::char16 * Data() const;
Rückgabewert
Ein Array von char16-UNICODE-Textzeichen.
StringReference::GetHSTRING-Methode
Gibt den Inhalt der Zeichenfolge als __abi_HSTRING zurück.
Syntax
__abi_HSTRING GetHSTRING() const;
Rückgabewert
Ein __abi_HSTRING mit den eigentlichen Zeichenfolgedaten.
Hinweise
StringReference::GetString-Methode
Gibt den Inhalt der Zeichenfolge als Platform::String^ zurück.
Syntax
__declspec(no_release_return) __declspec(no_refcount)
::Platform::String^ GetString() const;
Rückgabewert
Ein Platform::String^, das die eigentlichen Zeichenfolgedaten enthält.
StringReference::Length-Methode
Gibt die Anzahl der Zeichen in der Zeichenfolge zurück.
Syntax
unsigned int Length() const;
Rückgabewert
Eine ganze Zahl ohne Vorzeichen, die die Anzahl von Zeichen in der Zeichenfolge angibt.
Hinweise
StringReference::operator=-Operator
Weist das angegebene Objekt dem aktuellen StringReference-Objekt zu.
Syntax
StringReference& operator=(const StringReference& __fstrArg);
StringReference& operator=(const ::default::char16* __strArg);
Parameter
__fstrArg
Die Adresse eines StringReference-Objekts, das zum Initialisieren des aktuellen StringReference-Objekts verwendet wird.
__strArg
Zeiger auf ein Array von char16-Werten das zum Initialisieren des aktuellen StringReference-Objekts verwendet wird.
Rückgabewert
Ein Verweis auf ein Objekt des Typs StringReference.
Hinweise
Da StringReference es sich um eine C++-Standardklasse und nicht um eine Verweisklasse handelt, wird sie nicht im Objektkatalog angezeigt.
StringReference::operator()-Operator
Konvertiert ein StringReference-Objekt in ein Platform::String^-Objekt.
Syntax
__declspec(no_release_return) __declspec(no_refcount)
operator ::Platform::String^() const;
Rückgabewert
Ein Handle für ein Objekt des Typs Platform::String
StringReference::StringReference-Konstruktor
Initialisiert eine neue Instanz der StringReference-Klasse.
Syntax
StringReference();
StringReference(const StringReference& __fstrArg);
StringReference(const ::default::char16* __strArg);
StringReference(const ::default::char16* __strArg, size_t __lenArg);
Parameter
__fstrArg
Der StringReference, dessen Daten zum Initialisieren der neuen Instanz verwendet werden.
__strArg
Zeiger auf ein char16-Wertearray, das zum Initialisieren der neuen Instanz verwendet wird.
__lenArg
Die Anzahl von Elementen in __strArg.
Hinweise
Die erste Version dieses Konstruktors ist der Standardkonstruktor. Die zweite Version initialisiert eine neue StringReference-Instanzklasse aus dem Objekt, das durch den __fstrArg-Parameter spezifiziert wird. Die dritten und vierten Überladungen initialisieren eine neue StringReference-Instanz aus einem char16-Wertearray. char16 stellt ein 16-Bit-UNICODE-Textzeichen dar.