WriteOnlyArrayAttribute クラス

定義

名前空間:

System.Runtime.InteropServices.WindowsRuntime

アセンブリ:

System.Runtime.InteropServices.WindowsRuntime.dll

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

継承

Object

Attribute

WriteOnlyArrayAttribute

属性

AttributeUsageAttribute

注釈

Windows ランタイム コンポーネントの配列パラメーターが値渡しされる場合 (ByValVisual 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)

こちらもご覧ください

• ReadOnlyArrayAttribute
• Winmdexp.exe (Windows ランタイム メタデータのエクスポート ツール)
• C# および Visual Basic での Windows ランタイム コンポーネントの作成
• Windows ランタイム コンポーネントに配列を渡す