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 передается по значению (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)

См. также раздел

• ReadOnlyArrayAttribute
• Winmdexp.exe (средство экспорта метаданных среды выполнения Windows)
• Создание компонентов среды выполнения Windows в C# и Visual Basic
• Передача массивов компоненту среды выполнения Windows