Partager via


Platform::StringReference, classe

Type d'optimisation que vous pouvez utiliser pour passer des données de type chaîne des paramètres d'entrée Platform::String^ à d'autres méthodes avec un minimum d'opérations de copie.

Syntaxe

class StringReference

Notes

Membres

Constructeurs publics

Nom Description
StringReference ::StringReference Deux constructeurs pour créer des instances de StringReference.

Méthodes publiques

Nom Description
StringReference ::D ata Retourne des données de type chaîne en tant que tableau de valeurs char16.
StringReference ::Length Retourne le nombre de caractères de la chaîne.
StringReference ::GetHSTRING Retourne des données de type chaîne en tant que HSTRING.
StringReference ::GetString Retourne des données de type chaîne en tant que Platform::String^.

Opérateurs publics

Nom Description
StringReference ::operator= Assigne une StringReference à une nouvelle instance de StringReference .
StringReference ::operator() Convertit une StringReference en une Platform::String^.

Spécifications

Client minimum pris en charge : Windows 8

Serveur minimum pris en charge : Windows Server 2012

Espace de noms : Platform

En-tête : vccorlib.h

StringReference::Data, méthode

Retourne le contenu de ce StringReference sous forme de tableau de valeurs char16.

Syntaxe

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

Valeur de retour

Tableau de caractères de texte UNICODE char16.

StringReference::GetHSTRING, méthode

Retourne le contenu de la chaîne en tant que __abi_HSTRING.

Syntaxe

__abi_HSTRING GetHSTRING() const;

Valeur de retour

__abi_HSTRING contenant les données de type chaîne.

Notes

StringReference::GetString, méthode

Retourne le contenu de la chaîne en tant que Platform::String^.

Syntaxe

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

Valeur de retour

Platform::String^ contenant les données de type chaîne.

StringReference::Length, méthode

Retourne le nombre de caractères de la chaîne.

Syntaxe

unsigned int Length() const;

Valeur de retour

Entier non signé qui Spécifie le nombre de caractères de la chaîne.

Notes

StringReference::operator=, opérateur

Assigne l'objet spécifié à l'objet StringReference actif.

Syntaxe

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

Paramètres

__fstrArg
Adresse d'un objet StringReference utilisé pour initialiser l'objet StringReference actif.

__strArg
Pointeur vers un tableau de valeurs char16 utilisé pour initialiser l'objet StringReference actif.

Valeur de retour

Référence à un objet de type StringReference.

Notes

Étant donné qu’il StringReference s’agit d’une classe C++ standard et non d’une classe ref, elle n’apparaît pas dans l’Explorateur d’objets.

StringReference::operator(), opérateur

Convertit un objet StringReference en un objet Platform::String^.

Syntaxe

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

Valeur de retour

Handle d'un objet de type Platform::String.

StringReference::StringReference, constructeur

Initialise une nouvelle instance de la classe StringReference.

Syntaxe

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

Paramètres

__fstrArg
StringReference dont les données sont utilisées pour initialiser la nouvelle instance.

__strArg
Pointeur vers un tableau de valeurs char16 utilisé pour initialiser la nouvelle instance.

__lenArg
Nombre d'éléments de __strArg.

Notes

La première version de ce constructeur est le constructeur par défaut. La deuxième version initialise une nouvelle classe d'instance StringReference de l'objet spécifié par le paramètre __fstrArg. Les troisième et quatrième surcharges initialisent une nouvelle instance de StringReference à partir d’un tableau de valeurs char16. char16 représente un caractère de texte UNICODE 16 bits.

Voir aussi

Platform::StringReference, classe