WriteOnlyArrayAttribute クラス

定義

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
継承
WriteOnlyArrayAttribute
属性

注釈

Windows ランタイム コンポーネントの配列パラメーターが値 (ByVal Visual Basic の場合) で渡される場合は、次のいずれかの属性を適用する必要があります。

  • 配列の内容を 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)

適用対象

こちらもご覧ください