Platform::StringReference Classe

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

Sintaxe

class StringReference

Members

Construtores Públicos

Nome	Description
StringReference::StringReference	Dois construtores para criar instâncias de StringReference.

Métodos Públicos

Nome	Description
StringReference::D ata	Retorna os dados da cadeia de caracteres como uma matriz de valores char16.
StringReference::Comprimento	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 um Platform::String^arquivo .

Operadores Públicos

Nome	Description
StringReference::operator=	Atribui um StringReference a uma nova StringReference instância.
StringReference::operator()	Converte a StringReference em um Platform::String^arquivo .

Requerimentos

Cliente mínimo suportado: Janelas 8

Servidor mínimo suportado: Windows Server 2012

Espaço de nomes: Plataforma

Cabeçalho: vccorlib.h

Método StringReference::D ata

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

Sintaxe

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

Valor de retorno

Uma matriz de caracteres de texto char16 UNICODE.

Método StringReference::GetHSTRING

Retorna o conteúdo da cadeia de caracteres como um __abi_HSTRINGarquivo .

Sintaxe

__abi_HSTRING GetHSTRING() const;

Valor de retorno

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

Método StringReference::GetString

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

Sintaxe

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

Valor de retorno

A 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 de retorno

Um inteiro não assinado que especifica o número de caracteres na cadeia de caracteres.

StringReference::operator= Operador

Atribui o objeto especificado ao objeto atual StringReference .

Sintaxe

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

Parâmetros

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

__strArg
Ponteiro para uma matriz de valores char16 que é usada para inicializar o objeto atual StringReference .

Valor de retorno

Uma referência a um objeto do tipo StringReference.

Observações

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

StringReference::operador operator()

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

Sintaxe

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

Valor de retorno

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

StringReference::StringReference Construtor

Inicializa uma nova instância da StringReference classe.

Sintaxe

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

Parâmetros

__fstrArg
Os StringReference dados de quem são usados para inicializar a nova instância.

__strArg
Ponteiro para uma matriz de valores char16 que é usada para inicializar a nova instância.

__lenArg
O número de elementos em __strArg.

Observações

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

Consulte também

Platform::StringReference Classe