ReadOnlyArrayAttribute Classe

Definizione

Spazio dei nomi:

System.Runtime.InteropServices.WindowsRuntime

Assembly:

System.Runtime.InteropServices.WindowsRuntime.dll

Quando applicato al parametro di una matrice in un componente di Windows Runtime, specifica che il contenuto della matrice passata al parametro viene usato solo per l'input. Il chiamante prevede che la matrice resti invariata dopo la chiamata.

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

Ereditarietà

Object

Attribute

ReadOnlyArrayAttribute

Attributi

AttributeUsageAttribute

Commenti

Se un parametro di matrice nel componente Windows Runtime viene passato per valore (ByVal in Visual Basic), è necessario applicare uno degli attributi seguenti al componente:

• Applicare l'attributo se si intende utilizzare il contenuto della matrice solo per l'input ReadOnlyArrayAttribute .

• Applicare l'attributo se si intende utilizzare il WriteOnlyArrayAttribute contenuto della matrice solo per l'output, ovvero il metodo imposta il contenuto della matrice ma non li legge.

L'applicazione di entrambi gli attributi a un parametro causa un errore. Per altre informazioni, incluso il modello standard per apportare modifiche a una matrice, vedere Passaggio di matrici a un componente Windows Runtime in Windows Dev Center.

Importante

I parametri con l'attributo si comportano in modo diverso a seconda che il ReadOnlyArrayAttribute chiamante sia scritto nel codice nativo o nel codice gestito. Se il chiamante è codice nativo (estensioni del componente JavaScript o Visual C++), la matrice viene copiata quando la chiamata supera il limite dell'interfaccia binaria dell'applicazione (ABI). Se necessario, gli elementi vengono convertiti. Di conseguenza, eventuali modifiche effettuate dal metodo a una matrice di solo input non saranno visibili al chiamante.

Se il chiamante è codice gestito, la matrice non viene copiata. La matrice originale è disponibile per il metodo chiamato, perché si tratta di una chiamata a qualsiasi metodo in .NET Framework. Dal momento che il contenuto della matrice è modificabile nel codice .NET Framework, eventuali modifiche apportate dal metodo alla matrice sono visibili al chiamante. Questo è importante ricordare perché influisce sugli unit test scritti per un componente Windows Runtime. Se i test sono scritti in codice gestito, il contenuto di una matrice risulterà modificabile durante il test.

L'applicazione di questo attributo a un parametro con l'attributo InAttribute o OutAttribute causa un errore quando il modulo viene esportato. L'applicazione dell'attributo a un out parametro causa anche un errore.

Costruttori

ReadOnlyArrayAttribute()

Inizializza una nuova istanza della classe ReadOnlyArrayAttribute.

Proprietà

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• WriteOnlyArrayAttribute
• Winmdexp.exe (Windows Runtime Metadata Export Tool)
• Creazione di componenti Windows Runtime in C# e Visual Basic
• Passaggio di matrici a un componente Windows Runtime