Platform::StringReference (Clase)

Tipo de optimización que puedes usar para pasar datos de tipo String desde parámetros de entrada Platform::String^ a otros métodos con un mínimo de operaciones de copia.

Sintaxis

class StringReference

Comentarios

Miembros

Constructores públicos

Nombre	Descripción
StringReference::StringReference	Dos constructores para crear instancias de StringReference.

Métodos públicos

Nombre	Descripción
StringReference::Data	Devuelve los datos de tipo String como una matriz de valores char16.
StringReference::Length	Devuelve el número de caracteres de la cadena.
StringReference::GetHSTRING	Devuelve los datos de tipo String como HSTRING.
StringReference::GetString	Devuelve los datos de tipo String como Platform::String^.

Operadores públicos

Nombre	Descripción
StringReference::operator=	Asigna StringReference a una nueva instancia de StringReference .
StringReference::operator()	Convierte StringReference en Platform::String^.

Requisitos

Cliente mínimo compatible: Windows 8

Servidor mínimo compatible: Windows Server 2012

Espacio de nombres: Plataforma

Encabezado: vccorlib.h

StringReference::Data (Método)

Devuelve el contenido de este StringReference como matriz de valores char16.

Sintaxis

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

Valor devuelto

Matriz de caracteres de texto UNICODE char16.

StringReference::GetHSTRING (Método)

Devuelve el contenido de la cadena como __abi_HSTRING.

Sintaxis

__abi_HSTRING GetHSTRING() const;

Valor devuelto

__abi_HSTRING que contiene los datos de tipo String.

Comentarios

StringReference::GetString (Método)

Devuelve el contenido de la cadena como Platform::String^.

Sintaxis

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

Valor devuelto

Platform::String^ que contiene los datos de tipo String.

StringReference::Length (Método)

Devuelve el número de caracteres de la cadena.

Sintaxis

unsigned int Length() const;

Valor devuelto

Un entero sin signo que especifica la cantidad de caracteres de la cadena.

Comentarios

Operador StringReference::operator=

Asigna el objeto especificado al objeto StringReference actual.

Sintaxis

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

Parámetros

__fstrArg
Dirección de un objeto StringReference que se usa para inicializar el objeto StringReference actual.

__strArg
Puntero a una matriz de valores char16 que se usa para inicializar el objeto StringReference actual.

Valor devuelto

Referencia a un objeto de tipo StringReference.

Comentarios

Como StringReference es una clase estándar de C++ y no una clase de referencia, no aparece en el Explorador de objetos.

Operador StringReference::operator()

Convierte un objeto StringReference en un objeto Platform::String^.

Sintaxis

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

Valor devuelto

Identificador para un objeto de tipo Platform::String.

StringReference::StringReference (Constructor)

Inicializa una nueva instancia de la clase StringReference.

Sintaxis

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

Parámetros

__fstrArg
StringReference cuyos datos se usan para inicializar la nueva instancia.

__strArg
Puntero a una matriz de valores char16 que se emplea para inicializar la nueva instancia.

__lenArg
Número de elementos de __strArg.

Comentarios

La primera versión de este constructor es el constructor predeterminado. La segunda versión inicializa una nueva clase de instancia StringReference desde el objeto especificado por el parámetro __fstrArg. La tercera y la cuarta sobrecargas inicializan una nueva instancia de StringReference desde una matriz de valores char16. char16 representa un carácter de texto UNICODE de 16 bits.

Consulte también

Platform::StringReference (Clase)