WriteOnlyArrayAttribute Classe

Definição

Namespace:

System.Runtime.InteropServices.WindowsRuntime

Assembly:

System.Runtime.InteropServices.WindowsRuntime.dll

Quando aplicado a um parâmetro de matriz em um componente Windows Runtime, especifica que o conteúdo de uma matriz passada para esse parâmetro é usado apenas para a saída. O chamador não garante que o conteúdo seja inicializado e o método chamado não deve ler o conteúdo.

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

Herança

Object

Attribute

WriteOnlyArrayAttribute

Atributos

AttributeUsageAttribute

Comentários

Se um parâmetro de matriz no componente Windows Runtime for passado por valor (ByVal em Visual Basic), você deverá aplicar um dos seguintes atributos a ele:

• Aplique o ReadOnlyArrayAttribute atributo se você pretende que o conteúdo da matriz seja usado apenas para entrada.

• Aplique o WriteOnlyArrayAttribute atributo se você pretende que o conteúdo da matriz seja usado somente para saída (ou seja, o método define o conteúdo da matriz, mas não os lê).

Aplicar ambos os atributos a um parâmetro causa um erro.

Importante

Parâmetros que têm o WriteOnlyArrayAttribute atributo se comportam de forma diferente dependendo se o chamador é escrito em código nativo ou código gerenciado. Se o chamador for código nativo (extensões de componente JavaScript ou Visual C++), o método chamado não poderá fazer suposições sobre o conteúdo da matriz original. Por exemplo, a matriz recebida pelo método pode não ser inicializada ou pode conter valores padrão. Espera-se que o método defina os valores de todos os elementos na matriz.

Se o chamador for um código gerenciado, a matriz original do chamador será passada para o método chamado, como seria em qualquer chamada de método no .NET Framework. O conteúdo da matriz é mutável no código gerenciado, de modo que o método pode ler e alterar seletivamente esses valores. Isso é importante lembrar porque afeta testes de unidade gravados para um componente Windows Runtime. Se os testes forem escritos em código gerenciado, o conteúdo de uma matriz parecerá mutável durante o teste e os resultados provavelmente serão diferentes se o método for chamado do código nativo mais tarde.

Aplicar esse atributo a um out parâmetro ou a um parâmetro que tem o InAttribute atributo causa um erro quando o módulo é exportado. Aplicar o atributo a um parâmetro que tem o atributo OutAttribute causa um erro, a menos que o parâmetro também tenha o modificador Visual Basic ByRef. Nesse caso, o atributo é redundante, mas permitido.

Construtores

Nome	Description
WriteOnlyArrayAttribute()	Inicializa uma nova instância da classe WriteOnlyArrayAttribute.

Propriedades

Nome	Description
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para esse Attribute. (Herdado de Attribute)

Métodos

Nome	Description
Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash dessa instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• ReadOnlyArrayAttribute
• Winmdexp.exe (Ferramenta de Exportação de Metadados Windows Runtime)