WriteOnlyArrayAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows Runtime コンポーネントの配列パラメーターに適用する場合、そのパラメーターに渡される配列の内容が出力にのみ使用されるように指定します。 呼び出し元はコンテンツが初期化されることを保証せず、呼び出されたメソッドはコンテンツを読み取るべきではありません。
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 AttributePublic NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute- 継承
- 属性
注釈
Windows Runtime コンポーネント内の配列パラメーターが値渡し (Visual Basic ByVal) の場合は、次のいずれかの属性を適用する必要があります。
配列の内容を入力にのみ使用する場合は、 ReadOnlyArrayAttribute 属性を適用します。
配列の内容を出力にのみ使用する場合は、 WriteOnlyArrayAttribute 属性を適用します (つまり、メソッドは配列の内容を設定しますが、読み取りません)。
パラメーターに両方の属性を適用すると、エラーが発生します。
Important
WriteOnlyArrayAttribute属性を持つパラメーターの動作は、呼び出し元がネイティブ コードとマネージド コードのどちらで記述されているかによって異なります。 呼び出し元がネイティブ コード (JavaScript または Visual C++ コンポーネント拡張機能) の場合、呼び出されたメソッドは元の配列の内容について何も想定できません。 たとえば、メソッドが受け取る配列が初期化されていないか、既定値が含まれている可能性があります。 このメソッドは、配列内のすべての要素の値を設定することが期待されます。
呼び出し元がマネージド コードの場合、呼び出し元の元の配列は、.NET Framework の任意のメソッド呼び出しの場合と同様に、呼び出し元のメソッドに渡されます。 配列の内容はマネージド コードで変更できるため、メソッドはそれらの値を選択的に読み取って変更できます。 これは、Windows Runtime コンポーネント用に記述された単体テストに影響するため、覚えておく必要があります。 テストがマネージド コードで記述されている場合、テスト中に配列の内容が変更可能であるように見えます。メソッドが後でネイティブ コードから呼び出されると、結果が異なる可能性があります。
この属性を 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) |
