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
Comentários
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: Platform
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.
Comentários
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.
Comentários
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 de retorno
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.