Platform::WriteOnlyArray 類別
表示一維陣列。當呼叫端傳遞陣列讓方法填滿其中元素時，就會將這個陣列當做輸入參數來傳遞。
這個 ref 類別在 vccorlib.h 中是宣告為私用，因此不會在中繼資料內發出，而且只能從 C++ 使用。 這個類別只做為用來接收呼叫端所配置之陣列的輸入參數。 您無法從使用者程式碼建構這個類別。 它可以讓 C++ 方法直接在陣列中寫入資料，這就稱為「 FillArray 」模式。 如需詳細資訊，請參閱 Array和 WriteOnlyArray。
語法
private ref class WriteOnlyArray<T, 1>
成員
公用方法
這些方法的存取範圍都是 internal，也就是說，您只能在 C++ 應用程式或元件內存取這些方法。
| 名稱 | 描述 |
|---|---|
| WriteOnlyArray：：begin | 指向陣列中第一個元素的迭代器。 |
| WriteOnlyArray：:D ata | 資料緩衝區的指標。 |
| WriteOnlyArray：：end | 指向陣列中最後一個元素後加一的迭代器。 |
| WriteOnlyArray：：FastPass | 表示陣列是否可以使用 FastPass 機制，這是由系統悄悄執行的最佳化作業。 請勿在程式代碼中使用此專案 |
| WriteOnlyArray：：Length | 傳回陣列中的元素數目。 |
| WriteOnlyArray：：set | 為指定的元素設定指定的值。 |
繼承階層架構
WriteOnlyArray
需求
編譯器選項： /ZW
中繼資料： Platform.winmd
命名空間： Platform
WriteOnlyArray::begin 方法
傳回陣列中第一個元素的指標。
語法
T* begin() const;
傳回值
陣列中第一個元素的指標。
備註
這個迭代器可與 std::sort 這類 STL 演算法搭配使用，針對陣列元素執行作業。
WriteOnlyArray::Data 屬性
資料緩衝區的指標。
語法
property T* Data{
T* get() const;
}
傳回值
原始陣列位元組的指標。
WriteOnlyArray::end 方法
傳回陣列中最後一個元素後加一的指標。
語法
T* end() const;
傳回值
陣列中最後一個元素後加一的指標迭代器。
備註
這個迭代器可與 STL 演算法搭配使用，針對陣列元素執行像是 std::sort 這類作業。
WriteOnlyArray::FastPass 屬性
表示是否可以執行內部 FastPass 最佳化。 不適合由使用者程式碼所使用。
語法
property bool FastPass{
bool get() const;
}
傳回值
表示陣列是否為 FastPass 的布林值。
WriteOnlyArray::get 方法
傳回位於指定之索引處的元素。
語法
T& get(unsigned int indexArg) const;
參數
indexArg
要使用的索引。
傳回值
WriteOnlyArray::Length 屬性
傳回呼叫端配置之陣列中元素數目。
語法
property unsigned int Length{
unsigned int get() const;
}
傳回值
陣列中的項目數。
WriteOnlyArray::set 函式
在陣列中指定的索引處設定指定的值。
語法
T& set(
unsigned int indexArg,
T valueArg);
參數
indexArg
要設定之元素的索引。
valueArg
要在 indexArg 設定的值。
傳回值
剛才設定之元素的參考。
備註
如需如何解譯 HRESULT 值的詳細資訊，請參閱 COM 錯誤碼的結構。