Condividi tramite


Classe Platform::StringReference

Tipo di ottimizzazione che puoi usare per passare dati in formato stringa dai parametri di input di Platform::String^ ad altri metodi con un minimo di operazioni di copia.

Sintassi

class StringReference

Osservazioni:

Membri

Costruttori pubblici

Nome Descrizione
StringReference::StringReference Due costruttori per creare istanze di StringReference.

Metodi pubblici

Nome Descrizione
StringReference::D ata Restituisce i dati in formato stringa come matrice di valori char16.
StringReference::Length Restituisce il numero di caratteri della stringa.
StringReference::GetHSTRING Restituisce i dati in formato stringa come HSTRING.
StringReference::GetString Restituisce i dati in formato stringa come Platform::String^.

Operatori pubblici

Nome Descrizione
StringReference::operator= Assegna StringReference a una nuova istanza di StringReference .
StringReference::operator() Converte StringReference in Platform::String^.

Requisiti

Client minimo supportato: Windows 8

Server minimo supportato: Windows Server 2012

Spazio dei nomi: Platform

Intestazione: vccorlib.h

Metodo StringReference::Data

Restituisce i contenuti di questo StringReference come matrice di valori char16.

Sintassi

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

Valore restituito

Matrice di caratteri di testo UNICODE char16.

Metodo StringReference::GetHSTRING

Restituisce il contenuto della stringa come __abi_HSTRING.

Sintassi

__abi_HSTRING GetHSTRING() const;

Valore restituito

Oggetto __abi_HSTRING contenente i dati in formato stringa.

Osservazioni:

Metodo StringReference::GetString

Restituisce il contenuto della stringa come Platform::String^.

Sintassi

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

Valore restituito

Oggetto Platform::String^ contenente i dati in formato stringa.

Metodo StringReference::Length

Restituisce il numero di caratteri della stringa.

Sintassi

unsigned int Length() const;

Valore restituito

Intero senza segno che specifica il numero di caratteri nella stringa.

Osservazioni:

Operatore StringReference::operator=

Assegna l'oggetto specificato all'oggetto StringReference corrente.

Sintassi

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

Parametri

__fstrArg
Indirizzo di un oggetto StringReference utilizzato per inizializzare l'oggetto StringReference corrente.

__strArg
Puntatore a una matrice di valori char16 utilizzata per inizializzare l'oggetto StringReference corrente.

Valore restituito

Riferimento a un oggetto di tipo StringReference.

Osservazioni:

Poiché StringReference è una classe C++ standard e non una classe ref, non viene visualizzata nel Visualizzatore oggetti.

Operatore StringReference::operator()

Converte un oggetto StringReference in un oggetto Platform::String^.

Sintassi

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

Valore restituito

Handle a un oggetto di tipo Platform::String.

Costruttore StringReference::StringReference

Inizializza una nuova istanza della classe StringReference.

Sintassi

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

Parametri

__fstrArg
StringReference i cui dati vengono utilizzati per inizializzare la nuova istanza.

__strArg
Puntatore a una matrice di valori char16 utilizzata per inizializzare la nuova istanza.

__lenArg
Numero di elementi in __strArg.

Osservazioni:

La prima versione di questo costruttore rappresenta il costruttore predefinito. La seconda versione inizializza la nuova classe StringReference dell'istanza dall'oggetto specificato dal parametro __fstrArg. Il terzo e il quarto overload inizializzano una nuova istanza di StringReference da una matrice di valori char16. char16 rappresenta un carattere di testo UNICODE a 16 bit.

Vedi anche

Classe Platform::StringReference