WriteOnlyArrayAttribute 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
应用于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 AttributePublic NotInheritable Class WriteOnlyArrayAttribute
Inherits Attribute- 继承
- 属性
注解
如果Windows 运行时组件中的数组参数通过值（ByVal 在 Visual Basic 中传递），则必须向其应用以下属性之一：
ReadOnlyArrayAttribute如果希望数组的内容仅用于输入，请应用该属性。
WriteOnlyArrayAttribute如果希望数组的内容仅用于输出（即该方法设置数组的内容但不读取它们），则应用该属性。
将这两个属性应用于参数会导致错误。 有关详细信息，包括对数组进行更改的标准模式，请参阅 Windows 开发人员中心中的将数组传递给Windows 运行时组件。
重要
属性 WriteOnlyArrayAttribute 具有不同行为的参数，具体取决于调用方是使用本机代码还是托管代码编写。 如果调用方是本机代码（JavaScript 或 Visual C++ 组件扩展），则调用的方法无法对原始数组的内容做出任何假设。 例如，方法接收的数组可能未初始化，或者可能包含默认值。 该方法应设置数组中所有元素的值。
如果调用方是托管代码，则调用方的原始数组将传递给调用的方法，就像在 .NET Framework 中的任何方法调用中一样。 数组内容在托管代码中可变，因此该方法可以有选择地读取和更改这些值。 请务必记住这一点，因为它会影响为Windows 运行时组件编写的单元测试。 如果测试是用托管代码编写的，则数组的内容在测试期间看起来是可变的，如果稍后从本机代码调用该方法，结果可能会有所不同。
将此属性应用于参数 out 或具有 InAttribute 该特性的参数在导出模块时导致错误。 将特性应用于具有 OutAttribute 属性的参数会导致错误，除非该参数还具有 Visual Basic ByRef 修饰符。 在这种情况下，该属性是冗余的，但允许。
构造函数
| 名称 | 说明 |
|---|---|
| WriteOnlyArrayAttribute() |
初始化 WriteOnlyArrayAttribute 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| 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) |
