WriteOnlyArrayAttribute 类

定义

命名空间:

System.Runtime.InteropServices.WindowsRuntime

程序集:

System.Runtime.InteropServices.WindowsRuntime.dll

当应用于 Windows 运行时组件中的数组参数时，指定传递到该参数的数组的内容仅用于输出。 调用方不保证对内容进行了初始化，因此，所调用的方法不应读取内容。

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 Attribute

Public NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute

继承

Object

Attribute

WriteOnlyArrayAttribute

属性

AttributeUsageAttribute

注解

如果 Windows 运行时组件中的数组参数由 Visual Basic) 中的值 (ByVal 传递，则必须向其应用以下属性之一：

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

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

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

重要

具有 WriteOnlyArrayAttribute 特性的参数的行为方式不同，具体取决于调用方是用本机代码还是托管代码编写。 如果调用方是 javaScript 或 Visual C++ 组件扩展 (本机代码) ，则调用的方法无法对原始数组的内容做出任何假设。 例如，方法接收的数组可能未初始化，或可能包含默认值。 方法应在数组中设置所有元素的值。

如果调用方是托管代码，则调用方的原始数组将传递到被调用的方法，就像在 .NET Framework 中的任何方法调用中一样。 数组内容在托管代码中是可变的，因此该方法可以有选择地读取和更改这些值。 请务必记住这一点，因为它会影响为 Windows 运行时组件编写的单元测试。 如果测试是用托管代码编写的，则数组的内容在测试期间看起来是可变的，如果稍后从本机代码调用方法，则结果可能会有所不同。

导出模块时，将此属性应用于 out 参数或具有 InAttribute 特性的参数会导致错误。 除非参数还具有 Visual Basic ByRef 修饰符，否则将特性应用于具有 OutAttribute 特性的参数会导致错误。 在这种情况下，属性是冗余的，但允许。

构造函数

WriteOnlyArrayAttribute()

初始化 WriteOnlyArrayAttribute 类的新实例。

属性

TypeId

在派生类中实现时，获取此 Attribute 的唯一标识符。 (继承自 Attribute)

方法

Equals(Object)	返回一个值，该值指示此实例是否与指定的对象相等。 (继承自 Attribute)
GetHashCode()	返回此实例的哈希代码。 (继承自 Attribute)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsDefaultAttribute()	在派生类中重写时，指示此实例的值是否是派生类的默认值。 (继承自 Attribute)
Match(Object)	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• ReadOnlyArrayAttribute
• Winmdexp.exe（Windows 运行时元数据导出工具）
• 用 C# 和 Visual Basic 创建 Windows 运行时组件
• 将数组传递到 Windows 运行时组件