ReadOnlyArrayAttribute 类

定义

命名空间:

System.Runtime.InteropServices.WindowsRuntime

程序集:

System.Runtime.InteropServices.WindowsRuntime.dll

当应用于 Windows 运行时组件中的数组参数时，指定传递到该参数的数组的内容仅用于输入。 调用方期望此数组不因调用而更改。

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 运行时 组件中的数组参数由 Visual Basic) 中的值 (ByVal 传递，则必须向其应用下列属性之一：

• ReadOnlyArrayAttribute如果打算仅将数组的内容用于输入，请应用 属性。

• WriteOnlyArrayAttribute如果打算仅将数组的内容用于输出 (，则应用 属性，即，方法设置数组的内容，但不) 读取它们。

将这两个属性应用于参数会导致错误。 有关详细信息（包括对数组进行更改的标准模式），请参阅将数组传递到 Windows 开发人员中心中的Windows 运行时组件。

重要

具有 ReadOnlyArrayAttribute 特性的参数的行为方式不同，具体取决于调用方是用本机代码还是托管代码编写。 如果调用方是 JavaScript 或 Visual C++ 组件扩展 (本机代码) ，则当调用跨应用程序二进制接口 (ABI) 边界时，将复制数组。 元素在必要时会进行转换。 因此，方法对只可输入数组进行的任何意外更改都对调用方不可见。

如果调用方是托管代码，则不会复制数组。 原始数组可用于被调用的方法，就像在.NET Framework中的任何方法调用中一样。 数组内容在 .NET Framework 代码中是可变的，因此方法对数组进行的任何更改都对调用方可见。 请务必记住这一点，因为它会影响为Windows 运行时组件编写的单元测试。 如果在托管代码中编写测试，则数组的内容会在测试过程中似乎是可变的。

导出模块时，将此属性应用于具有 InAttribute 或 OutAttribute 属性的参数会导致错误。 将 特性应用于 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 运行时组件