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 錯誤碼 的結構。

另請參閱

平臺命名空間
在 C++ 中建立 Windows 執行階段元件