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 Runtime元件中的陣列參數被傳遞值（ByVal Visual Basic），你必須對其套用以下其中一個屬性：

• 如果你打算將陣列內容只用於輸入，則套用該 ReadOnlyArrayAttribute 屬性。

• 如果你打算將陣列內容只用於輸出（也就是說，方法設定陣列內容但不讀取），則套用該 WriteOnlyArrayAttribute 屬性。

將兩個屬性套用到參數上會產生錯誤。

這很重要

帶有屬性的 ReadOnlyArrayAttribute 參數會根據呼叫者是用原生程式碼還是受管理程式碼撰寫而行為不同。 若呼叫者為原生程式碼（JavaScript 或 Visual C++ 元件擴充），當呼叫跨越應用程式二進位介面（ABI）邊界時，陣列會被複製。 必要時會轉換元素。 因此，方法對僅輸入陣列所做的任何意外變更，呼叫者都看不到。

若呼叫者為管理程式碼，陣列不會被複製。 原始陣列可供被調用的方法使用，就像 .NET 框架中任何方法呼叫一樣。 陣列內容在 .NET Framework 程式碼中是可變的，因此方法對陣列所做的任何變更都能被呼叫者看到。 這點很重要，因為它影響為 Windows Runtime 元件所撰寫的單元測試。 若測試以受管理程式碼撰寫，陣列內容在測試時會看起來是可變的。

將此屬性套用於具有 InAttribute 或 OutAttribute 屬性的參數時，當模組匯出時會發生錯誤。 將屬性套用到 out 參數上也會產生錯誤。

建構函式

名稱	Description
ReadOnlyArrayAttribute()	初始化 ReadOnlyArrayAttribute 類別的新執行個體。

屬性

名稱	Description
TypeId	在衍生類別中實作時，取得這個 Attribute的唯一標識碼。 (繼承來源 Attribute)

方法

名稱	Description
Equals(Object)	傳回值，這個值表示這個實例是否等於指定的物件。 (繼承來源 Attribute)
GetHashCode()	傳回這個實例的哈希碼。 (繼承來源 Attribute)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，指出這個實例的值是否為衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，傳回值，指出這個實例是否等於指定的物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• WriteOnlyArrayAttribute
• Winmdexp.exe（Windows Runtime元資料匯出工具）