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 文字字元。

另請參閱

Platform::StringReference 類別