Platform::StringReference-Klasse

  • Artikel

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.

Siehe auch

Platform::StringReference-Klasse