ReadOnlyArrayAttribute クラス

定義

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

注釈

Windows ランタイム コンポーネントの配列パラメーターが値 (ByVal Visual 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)

明示的なインターフェイスの実装

_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)

適用対象

こちらもご覧ください