WriteOnlyArrayAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows ランタイム コンポーネント中の配列パラメーターに適用された場合、このパラメーターに渡された配列の内容が出力のみに使用されることを指定します。 呼び出し元はコンテンツが初期化されることを保証せず、呼び出されたメソッドはコンテンツを読み取りません。
public ref class WriteOnlyArrayAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class WriteOnlyArrayAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type WriteOnlyArrayAttribute = class
inherit Attribute
Public NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute
- 継承
- 属性
注釈
Windows ランタイムコンポーネントの配列パラメーターが値 (Visual Basic) によって渡される場合は、 ByVal
次の属性のいずれかを適用する必要があります。
ReadOnlyArrayAttribute配列の内容が入力のみに使用されるようにする場合は、属性を適用します。
WriteOnlyArrayAttribute配列の内容が出力のみに使用されるようにする場合は、属性を適用します (つまり、メソッドは配列の内容を設定しますが、読み取ることはできません)。
パラメーターに両方の属性を適用すると、エラーが発生します。 配列を変更するための標準パターンを含む詳細については、「Windows デベロッパーセンターのWindows ランタイムコンポーネントへの配列の引き渡し」を参照してください。
重要
属性を持つパラメーターの WriteOnlyArrayAttribute 動作は、呼び出し元がネイティブコードとマネージコードのどちらで記述されているかによって異なります。 呼び出し元がネイティブコード (JavaScript または Visual C++ コンポーネント拡張) である場合、呼び出されたメソッドは元の配列の内容についての想定を行うことができません。 たとえば、メソッドが受け取る配列が初期化されていなかったり、既定の値が入っていたりする可能性があります。 メソッドには、配列内のすべての要素の値を設定することが期待されます。
呼び出し元がマネージコードの場合は、呼び出し元の配列が呼び出されたメソッドに渡されます。これは、.NET Framework のメソッド呼び出しの場合と同様です。 配列の内容はマネージコードで変更可能であるため、メソッドはその値を選択的に読み取り、変更できます。 これは、Windows ランタイムコンポーネント用に記述された単体テストに影響するため、注意することが重要です。 テストがマネージコードで記述されている場合は、テスト中に配列の内容が変更可能であるように見えるため、後でメソッドがネイティブコードから呼び出された場合、結果は異なる可能性があります。
この属性をパラメーターに適用する out
か、属性を持つパラメーターに適用する InAttribute と、モジュールのエクスポート時にエラーが発生します。 属性を持つパラメーターに属性を適用すると OutAttribute 、パラメーターにも Visual Basic 修飾子がある場合を除き、エラーが発生し ByRef
ます。 この場合、属性は冗長ですが、許可されます。
コンストラクター
WriteOnlyArrayAttribute() |
WriteOnlyArrayAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
TypeId |
派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute) |
メソッド
Equals(Object) |
このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute) |
GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 Attribute) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
IsDefaultAttribute() |
派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute) |
Match(Object) |
派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。 (継承元 Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。 (継承元 Attribute) |