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 UNICODE 文字字元陣列。
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
用來初始化目前 StringReference 物件之 char16 值陣列的指標。
傳回值
類型為 StringReference 之物件的參考。
備註
因為 StringReference 是標準C++類別，而不是 ref 類別，所以不會出現在 物件瀏覽器中。
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 執行個體類別。 第三和第四個多載會從 char16 值的陣列初始化新的 StringReference 執行個體。 char16 表示 16 位元的 UNICODE 文字字元。