Plattform::StringReference-klass

En optimeringstyp som du kan använda för att skicka strängdata från Platform::String^ indataparametrar till andra metoder med minst kopieringsåtgärder.

Syntax

class StringReference

Members

Offentliga konstruktorer

Namn Description
StringReference::StringReference Två konstruktorer för att skapa instanser av StringReference.

Offentliga metoder

Namn Description
StringReference::D ata Returnerar strängdata som en matris med char16-värden.
StringReference::Length Returnerar antalet tecken i strängen.
StringReference::GetHSTRING Returnerar strängdata som en HSTRING.
StringReference::GetString Returnerar strängdata som en Platform::String^.

Offentliga operatörer

Namn Description
StringReference::operator= Tilldelar en StringReference till en ny StringReference instans.
StringReference::operator() Konverterar en StringReference till en Platform::String^.

Kravspecifikation

Lägsta klient som stöds: Windows 8

Lägsta server som stöds: Windows Server 2012

Namespace: Plattform

Rubrik: vccorlib.h

StringReference::D ata-metod

Returnerar innehållet i detta StringReference som en matris med char16-värden.

Syntax

const ::default::char16 * Data() const;

Returvärde

En matris med tecken16 UNICODE-texttecken.

StringReference::GetHSTRING-metod

Returnerar innehållet i strängen som en __abi_HSTRING.

Syntax

__abi_HSTRING GetHSTRING() const;

Returvärde

En __abi_HSTRING som innehåller strängdata.

StringReference::GetString-metod

Returnerar innehållet i strängen som en Platform::String^.

Syntax

__declspec(no_release_return) __declspec(no_refcount)
    ::Platform::String^ GetString() const;

Returvärde

En Platform::String^ som innehåller strängdata.

StringReference::Length-metod

Returnerar antalet tecken i strängen.

Syntax

unsigned int Length() const;

Returvärde

Ett osignerat heltal som anger antalet tecken i strängen.

StringReference::operator= Operator

Tilldelar det angivna objektet till det aktuella StringReference objektet.

Syntax

StringReference& operator=(const StringReference& __fstrArg);
StringReference& operator=(const ::default::char16* __strArg);

Parameterar

__fstrArg
Adressen till ett StringReference objekt som används för att initiera det aktuella StringReference objektet.

__strArg
Pekare till en matris med char16-värden som används för att initiera det aktuella StringReference objektet.

Returvärde

En referens till ett objekt av typen StringReference.

Anmärkningar

Eftersom StringReference är en C++-standardklass och inte en referensklass visas den inte i Objektläsaren.

StringReference::operator() Operator

Konverterar ett StringReference objekt till ett Platform::String^ objekt.

Syntax

__declspec(no_release_return) __declspec(no_refcount)
         operator ::Platform::String^() const;

Returvärde

Ett handtag till ett objekt av typen Platform::String.

StringReference::StringReference Constructor

Initierar en ny instans av StringReference klassen.

Syntax

StringReference();
StringReference(const StringReference& __fstrArg);
StringReference(const ::default::char16* __strArg);
StringReference(const ::default::char16* __strArg, size_t __lenArg);

Parameterar

__fstrArg
Vars StringReference data används för att initiera den nya instansen.

__strArg
Pekare till en matris med char16-värden som används för att initiera den nya instansen.

__lenArg
Antalet element i __strArg.

Anmärkningar

Den första versionen av konstruktorn är standardkonstruktorn. Den andra versionen initierar en ny StringReference instansklass från objektet som anges av parametern __fstrArg . Den tredje och fjärde överlagringen initierar en ny StringReference instans från en matris med char16-värden. char16 representerar ett 16-bitars UNICODE-texttecken.

Se även

Plattform::StringReference-klass