WriteOnlyArrayAttribute Classe

Définition

Espace de noms:

System.Runtime.InteropServices.WindowsRuntime

Assembly:

System.Runtime.InteropServices.WindowsRuntime.dll

Lorsqu’il est appliqué à un paramètre de tableau dans un composant Windows Runtime, spécifie que le contenu d’un tableau passé à ce paramètre est utilisé uniquement pour la sortie. L’appelant ne garantit pas que le contenu est initialisé et que la méthode appelée ne doit pas lire le contenu.

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

Héritage

Object

Attribute

WriteOnlyArrayAttribute

Attributs

AttributeUsageAttribute

Remarques

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

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

• Appliquez l’attribut WriteOnlyArrayAttribute si vous envisagez 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.

Important

Les paramètres qui ont l’attribut WriteOnlyArrayAttribute se comportent différemment selon que l’appelant est écrit dans du code natif ou du code managé. Si l’appelant est du code natif (extensions de composant JavaScript ou Visual C++), la méthode appelée ne peut pas faire d’hypothèses sur le contenu du tableau d’origine. Par exemple, le tableau reçu par la méthode peut ne pas être initialisé ou contenir des valeurs par défaut. La méthode est censée définir les valeurs de tous les éléments du tableau.

Si l'appelant est du code managé, le tableau d'origine de l'appelant est transmis à la méthode appelée, comme dans n'importe quel appel de méthode dans l'infrastructure .NET. Le contenu du tableau est mutable dans le code managé, de sorte que la méthode peut lire et modifier ces valeurs de manière sélective. Il est important de se rappeler qu’il affecte les tests unitaires écrits pour un composant Windows Runtime. Si les tests sont écrits dans du code managé, le contenu d’un tableau semble mutable pendant les tests et les résultats sont susceptibles d’être différents si la méthode est appelée à partir du code natif ultérieurement.

L’application de cet attribut à un out paramètre ou à un paramètre qui a l’attribut InAttribute provoque une erreur lorsque le module est exporté. L’application de l’attribut à un paramètre qui a l’attribut OutAttribute provoque une erreur, sauf si le paramètre a également le modificateur Visual Basic ByRef. Dans ce cas, l’attribut est redondant mais autorisé.

Constructeurs

Nom	Description
WriteOnlyArrayAttribute()	Initialise une nouvelle instance de la classe WriteOnlyArrayAttribute.

Propriétés

Nom	Description
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
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 pour cette instance. (Hérité de Attribute)
GetType()	Obtient la 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 de la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• ReadOnlyArrayAttribute
• Winmdexp.exe (outil d’exportation de métadonnées Windows Runtime)