Classe Platform::StringReference

Um tipo de otimização que você pode usar para transmitir dados de cadeia de caracteres dos parâmetros de entrada Platform::String^ a outros métodos com um mínimo de operações de cópia.

Sintaxe

class StringReference

Membros

Construtores públicos

Nome	Descrição
StringReference::StringReference	Dois construtores para criar instâncias de StringReference.

Métodos públicos

Nome	Descrição
StringReference::Data	Retorna os dados da cadeia de caracteres como uma matriz de valores char16.
StringReference::Length	Retorna o número de caracteres na cadeia de caracteres.
StringReference::GetHSTRING	Retorna os dados da cadeia de caracteres como um HSTRING.
StringReference::GetString	Retorna os dados da cadeia de caracteres como uma Platform::String^.

Operadores públicos

Nome	Descrição
StringReference::operator=	Atribui uma StringReference a uma nova instância de StringReference .
StringReference::operator()	Converte uma StringReference em uma Platform::String^.

Requisitos

Cliente com suporte mínimo: Windows 8

Servidor com suporte mínimo: Windows Server 2012

Namespace: Plataforma

Cabeçalho: vccorlib.h

Método StringReference::Data

Retorna o conteúdo desse StringReference como uma matriz de valores char16.

Sintaxe

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

Valor retornado

Uma matriz de caracteres de texto UNICODE char16.

Método StringReference::GetHSTRING

Retorna o conteúdo da cadeia de caracteres como __abi_HSTRING.

Sintaxe

__abi_HSTRING GetHSTRING() const;

Valor retornado

Uma __abi_HSTRING que contém os dados da cadeia de caracteres.

Método StringReference::GetString

Retorna o conteúdo da cadeia de caracteres como uma Platform::String^.

Sintaxe

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

Valor retornado

Uma Platform::String^ que contém os dados da cadeia de caracteres.

Método StringReference::Length

Retorna o número de caracteres na cadeia de caracteres.

Sintaxe

unsigned int Length() const;

Valor retornado

Um inteiro sem sinal que especifica o número de caracteres na cadeia de caracteres.

Operador StringReference::operator=

Atribui o objeto especificado ao objeto StringReference atual.

Sintaxe

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

Parâmetros

__fstrArg
O endereço de um objeto StringReference que é usado para inicializar o objeto StringReference atual.

__strArg
Ponteiro para uma matriz de valores char16 usado para inicializar o objeto StringReference atual.

Valor retornado

Referência a um objeto do tipo StringReference.

Comentários

Como StringReference é uma classe C++ padrão e não uma classe de referência, ela não aparece no Pesquisador de Objetos.

Operador StringReference::operator()

Converte um objeto StringReference em um objeto Platform::String^.

Sintaxe

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

Valor retornado

Um identificador de um objeto do tipo Platform::String.

Construtor StringReference::StringReference

Inicializa uma nova instância da classe StringReference.

Sintaxe

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

Parâmetros

__fstrArg
A StringReference cujos dados são usados para inicializar a nova instância.

__strArg
Ponteiro para uma matriz de valores char16 usado para inicializar a nova instância.

__lenArg
O número de elementos em __strArg.

Comentários

A primeira versão desse construtor é o construtor padrão. A segunda versão inicializa uma nova classe da instância de StringReference do objeto especificado pelo parâmetro __fstrArg. As terceira e quarta sobrecargas inicializam uma nova instância de StringReference de uma matriz de valores char16. char16 representa um caractere de texto UNICODE de 16 bits.

Confira também

Classe Platform::StringReference