Поделиться через


Класс Platform::StringReference

Тип оптимизации, который можно использовать для передачи строковых данных из входных параметров Platform::String^ в другие методы с минимальным числом операций копирования.

Синтаксис

class StringReference

Замечания

Участники

Открытые конструкторы

Имя Описание
StringReference::StringReference Два конструктора для создания экземпляров StringReference.

Открытые методы

Имя Описание
StringReference::D ata Возвращает строковые данные как массив значений char16.
StringReference::Length Возвращает число символов в строке.
StringReference::GetHSTRING Возвращает строковые данные как HSTRING.
StringReference::GetString Возвращает строковые данные как Platform::String^.

Открытые операторы

Имя Описание
StringReference::operator= Присваивает StringReference новому экземпляру StringReference .
StringReference::operator() Преобразует StringReference в Platform::String^.

Требования

Минимальный поддерживаемый клиент: Windows 8

Минимальный поддерживаемый сервер: Windows Server 2012

Пространство имен: Platform

Заголовок: vccorlib.h

Метод StringReference::Data

Возвращает содержимое этой строки StringReference как массив значений char16.

Синтаксис

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

Возвращаемое значение

Массив текстовых символов ЮНИКОДА char16.

Метод StringReference::GetHSTRING

Возвращает содержимое строки как __abi_HSTRING.

Синтаксис

__abi_HSTRING GetHSTRING() const;

Возвращаемое значение

Объект __abi_HSTRING, который содержит строковые данные.

Замечания

Метод StringReference::GetString

Возвращает содержимое строки как Platform::String^.

Синтаксис

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

Возвращаемое значение

Объект Platform::String^, который содержит строковые данные.

Метод StringReference::Length

Возвращает число символов в строке.

Синтаксис

unsigned int Length() const;

Возвращаемое значение

Целое число без знака, указывающее число символов в строке.

Замечания

Оператор StringReference::operator=

Присваивает указанный объект текущему объекту StringReference.

Синтаксис

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

Параметры

__fstrArg
Адрес объекта StringReference, используемый для инициализации текущего объекта StringReference.

__strArg
Указатель на массив значений char16, используемый для инициализации текущего объекта StringReference.

Возвращаемое значение

Ссылка на объект типа StringReference.

Замечания

Так как StringReference это стандартный класс C++ и не класс ссылок, он не отображается в браузере объектов.

Оператор StringReference::operator()

Преобразует объект StringReference в объект Platform::String^.

Синтаксис

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

Возвращаемое значение

Дескриптор для объекта типа Platform::String.

Конструктор StringReference::StringReference

Инициализирует новый экземпляр класса StringReference.

Синтаксис

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

Параметры

__fstrArg
Объект StringReference, данные которого используются для инициализации нового экземпляра.

__strArg
Указатель на массив значений char16, используемый для инициализации нового экземпляра.

__lenArg
Число элементов в __strArg.

Замечания

Первая версия этого конструктора является конструктором по умолчанию. Вторая версия инициализирует новый экземпляра класса StringReference из объекта, заданного параметром __fstrArg. Третья и четвертая перегрузки инициализируют новый экземпляр класса StringReference из массива значений char16. char16 представляет 16-разрядный текстовый символ ЮНИКОДА.

См. также

Класс Platform::StringReference