ReadOnlyArrayAttribute Classe

Définition

Espace de noms:

System.Runtime.InteropServices.WindowsRuntime

Assembly:

System.Runtime.InteropServices.WindowsRuntime.dll

Quand il s’applique à un paramètre de tableau dans un composant Windows Runtime, spécifie que le contenu du tableau passé à ce paramètre est utilisé uniquement pour l’entrée. L'appelant s'attend à ce que le tableau ne soit pas affecté par l'appel.

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

Héritage

Object

Attribute

ReadOnlyArrayAttribute

Attributs

AttributeUsageAttribute

Remarques

Si un paramètre de tableau dans votre composant Windows Runtime est passé par valeur (ByVal en Visual Basic), vous devez lui appliquer l’un des attributs suivants :

• Appliquez l’attribut ReadOnlyArrayAttribute si vous souhaitez que le contenu du tableau soit utilisé uniquement pour l’entrée.

• Appliquez l’attribut WriteOnlyArrayAttribute si vous souhaitez que le contenu du tableau soit utilisé uniquement pour la sortie (autrement dit, la méthode définit le contenu du tableau, mais ne les lit pas).

L’application des deux attributs à un paramètre provoque une erreur. Pour plus d’informations, notamment le modèle standard permettant d’apporter des modifications à un tableau, consultez Passage de tableaux à un composant Windows Runtime dans le Centre de développement Windows.

Important

Les paramètres qui ont l’attribut ReadOnlyArrayAttribute se comportent différemment selon que l’appelant est écrit en code natif ou en code managé. Si l’appelant est du code natif (extensions de composant JavaScript ou Visual C++), le tableau est copié lorsque l’appel franchit la limite de l’interface binaire d’application (ABI). Les éléments sont convertis si nécessaire. Ainsi, aucune modification accidentelle apportée par la méthode dans un tableau de type « entrée uniquement » n’est visible par l’appelant.

Si l’appelant est du code managé, le tableau n’est pas copié. Le tableau d’origine est disponible pour la méthode appelée, comme dans n’importe quel appel de méthode dans le .NET Framework. Le contenu de tableau étant mutable dans le code .NET Framework, toute modification apportée par la méthode dans le tableau est visible par l’appelant. Il est important de se souvenir de cela, car il affecte les tests unitaires écrits pour un composant Windows Runtime. Si les tests sont écrits en code managé, le contenu d’un tableau semble être mutable pendant le test.

L’application de cet attribut à un paramètre qui a l’attribut InAttribute ou OutAttribute provoque une erreur lorsque le module est exporté. L’application de l’attribut à un out paramètre provoque également une erreur.

Constructeurs

ReadOnlyArrayAttribute()

Initialise une nouvelle instance de la classe ReadOnlyArrayAttribute.

Propriétés

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• WriteOnlyArrayAttribute
• Winmdexp.exe (outil d’exportation de métadonnées Windows Runtime)
• Création de composants Windows Runtime en C# et Visual Basic
• Transmission de tableaux à un composant Windows Runtime