ReadOnlyArrayAttribute クラス

定義

名前空間:

System.Runtime.InteropServices.WindowsRuntime

アセンブリ:

System.Runtime.InteropServices.WindowsRuntime.dll

Windows Runtime コンポーネント中の配列パラメーターに適用された場合、このパラメーターに渡された配列の内容が入力のみに使用されることを指定します。 呼び出し元は、配列が呼び出しによって変更されるのを防ぐ必要があります。

public ref class ReadOnlyArrayAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class ReadOnlyArrayAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type ReadOnlyArrayAttribute = class
    inherit Attribute

Public NotInheritable Class ReadOnlyArrayAttribute
Inherits Attribute

継承

Object

Attribute

ReadOnlyArrayAttribute

属性

AttributeUsageAttribute

注釈

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

• 配列の内容を ReadOnlyArrayAttribute 入力のみに使用する場合は、 属性を適用します。

• 配列の WriteOnlyArrayAttribute 内容を出力のみに使用する場合 (つまり、メソッドは配列の内容を設定しますが、読み取らない) 場合は、 属性を適用します。

パラメーターに両方の属性を適用すると、エラーが発生します。 配列に変更を加える標準パターンなど、詳細については、「Windows デベロッパー センターでWindows ランタイム コンポーネントに配列を渡す」を参照してください。

重要

属性を ReadOnlyArrayAttribute 持つパラメーターは、呼び出し元がネイティブ コードまたはマネージド コードで記述されているかどうかによって動作が異なります。 呼び出し元がネイティブ コード (JavaScript または Visual C++ コンポーネント拡張機能) の場合、呼び出しがアプリケーション バイナリ インターフェイス (ABI) 境界を越えたときに配列がコピーされます。 要素は必要に応じて変換されます。 そのため、誤ってメソッドによって入力専用配列に変更が加えられたとしても、呼び出し元からは見えません。

呼び出し元がマネージド コードの場合、配列はコピーされません。 元の配列は、呼び出されたメソッドで使用できます。これは、.NET Framework内の任意のメソッド呼び出しの場合と同様です。 配列の内容は .NET Framework コードで変更可能なので、配列に対してメソッドによって行われる変更は呼び出し元から見えます。 これは、Windows ランタイム コンポーネント用に記述された単体テストに影響を与えるので、覚えておく必要があります。 マネージド コードでテストが作成される場合、配列の内容はテスト中に変更可能であることが示されます。

または OutAttribute 属性を持つInAttributeパラメーターにこの属性を適用すると、モジュールのエクスポート時にエラーが発生します。 パラメーターに 属性を out 適用すると、エラーも発生します。

コンストラクター

ReadOnlyArrayAttribute()

ReadOnlyArrayAttribute クラスの新しいインスタンスを初期化します。

プロパティ

TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)

メソッド

Equals(Object)	このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute)
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 Attribute)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute)
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

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