Класс 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-разрядный текстовый символ ЮНИКОДА.