ReadOnlyArrayAttribute 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 do Windows Runtime, especifica que o conteúdo da matriz passado para esse parâmetro é usado somente para entrada. O chamador espera que a matriz não seja alterada pela chamada.

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

Herança

Object

Attribute

ReadOnlyArrayAttribute

Atributos

AttributeUsageAttribute

Comentários

Se um parâmetro de matriz em seu componente Windows Runtime for passado por valor (ByVal no 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 somente para entrada.

• Aplique o WriteOnlyArrayAttribute atributo se você pretende que o conteúdo da matriz seja usado apenas 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. Para obter mais informações, incluindo o padrão padrão para fazer alterações em uma matriz, consulte Passando matrizes para um componente Windows Runtime no Centro de Desenvolvimento do Windows.

Importante

Parâmetros que têm o ReadOnlyArrayAttribute 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++), a matriz será copiada quando a chamada cruzar o limite da ABI (interface binária do aplicativo). Os elementos são convertidos, se necessário. Portanto, quaisquer alterações acidentais feitas pelo método em uma matriz somente entrada não são visíveis para o autor da chamada.

Se o chamador for um código gerenciado, a matriz não será copiada. A matriz original está disponível para o método chamado, como seria em qualquer chamada de método no .NET Framework. Como o conteúdo da matriz é mutável no código do .NET Framework, quaisquer alterações feitas pelo método na matriz são visíveis para o autor da chamada. 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á ser mutável durante o teste.

Aplicar esse atributo a um parâmetro que tem o InAttribute atributo ou OutAttribute causa um erro quando o módulo é exportado. Aplicar o atributo a um out parâmetro também causa um erro.

Construtores

ReadOnlyArrayAttribute()

Inicializa uma nova instância da classe ReadOnlyArrayAttribute.

Propriedades

TypeId

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

Métodos

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 para a 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 Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• WriteOnlyArrayAttribute
• Winmdexp.exe (Ferramenta de Exportação de Metadados do Windows Runtime)
• Criando componentes do Windows Runtime em C# e Visual Basic
• Passagem de matrizes para um componente do Windows Runtime