SoapEnumAttribute Classe

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Contrôle la manière dont XmlSerializer sérialise un membre de l'énumération.

C#

[System.AttributeUsage(System.AttributeTargets.Field)]
public class SoapEnumAttribute : Attribute

Héritage

Object

Attribute

SoapEnumAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant utilise la XmlSerializer méthode permettant de sérialiser une classe nommée Food qui inclut une énumération nommée FoodType. L’énumération FoodType est substituée en créant une SoapEnumAttribute pour chaque énumération et en définissant la SoapEnum propriété d’un SoapAttributes sur le SoapEnumAttribute. L’élément SoapAttributes est ajouté à un SoapAttributeOverrides qui est utilisé pour créer un XmlSerializer.

C#

using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;

public class Group{
   public string GroupName;
   public GroupType Grouptype;
}

public enum GroupType{
   // Use the SoapEnumAttribute to instruct the XmlSerializer
   // to generate Small and Large instead of A and B.
   [SoapEnum("Small")]
   A,
   [SoapEnum("Large")]
   B
}

public class Run {
   static void Main(){
      Run test= new Run();
      test.SerializeObject("SoapEnum.xml");
      test.SerializeOverride("SoapOverride.xml");
      Console.WriteLine("Fininished writing two files");
   }

     private void SerializeObject(string filename){
      // Create an instance of the XmlSerializer Class.
      XmlTypeMapping mapp  =
      (new SoapReflectionImporter()).ImportTypeMapping(typeof(Group));
      XmlSerializer mySerializer =  new XmlSerializer(mapp);

      // Writing the file requires a TextWriter.
      TextWriter writer = new StreamWriter(filename);

      // Create an instance of the Class that will be serialized.
      Group myGroup = new Group();

      // Set the object properties.
      myGroup.GroupName = ".NET";
      myGroup.Grouptype= GroupType.A;

      // Serialize the Class, and close the TextWriter.
      mySerializer.Serialize(writer, myGroup);
       writer.Close();
   }

   private void SerializeOverride(string fileName){
      SoapAttributeOverrides soapOver = new SoapAttributeOverrides();
      SoapAttributes SoapAtts = new SoapAttributes();

      // Add a SoapEnumAttribute for the GroupType.A enumerator.
      // Instead of 'A'  it will be "West".
      SoapEnumAttribute soapEnum = new SoapEnumAttribute("West");
      // Override the "A" enumerator.
      SoapAtts.SoapEnum = soapEnum;
      soapOver.Add(typeof(GroupType), "A", SoapAtts);

      // Add another SoapEnumAttribute for the GroupType.B enumerator.
      // Instead of //B// it will be "East".
      SoapAtts= new SoapAttributes();
      soapEnum = new SoapEnumAttribute();
      soapEnum.Name = "East";
      SoapAtts.SoapEnum = soapEnum;
      soapOver.Add(typeof(GroupType), "B", SoapAtts);

      // Create an XmlSerializer used for overriding.
      XmlTypeMapping map =
      new SoapReflectionImporter(soapOver).
      ImportTypeMapping(typeof(Group));
      XmlSerializer ser = new XmlSerializer(map);
      Group myGroup = new Group();
      myGroup.GroupName = ".NET";
      myGroup.Grouptype = GroupType.B;
      // Writing the file requires a TextWriter.
      TextWriter writer = new StreamWriter(fileName);
      ser.Serialize(writer, myGroup);
      writer.Close();
    }
}

Remarques

La SoapEnumAttribute classe appartient à une famille d’attributs qui contrôle la façon dont la XmlSerializer sérialise ou désérialise un objet en tant que code SOAP XML encodé. Le code XML résultant est conforme à la section 5 du document World Wide Web Consortium Document Simple Object Access Protocol (SOAP) 1.1. Pour obtenir la liste complète des attributs similaires, consultez Attributs qui contrôlent la sérialisation SOAP encodée.

Pour sérialiser un objet en tant que message SOAP encodé, vous devez construire l’utilisation XmlSerializer d’un XmlTypeMapping objet créé avec la ImportTypeMapping méthode de la SoapReflectionImporter classe.

Utilisez l’énumération SoapEnumAttribute pour modifier l’énumération XmlSerializer générée ou reconnaît (lorsqu’elle sérialise ou désérialise une classe, respectivement). Par exemple, si une énumération contient un membre nommé One, mais que vous préférez que la sortie XML soit nommée Single, appliquez le SoapEnumAttribute membre d’énumération et définissez la Name propriété sur « Single ».

Vous pouvez remplacer la Name valeur de propriété d’un SoapEnumAttribute en créant une instance de la SoapEnumAttribute classe et en l’affectant à la SoapEnum propriété d’un SoapAttributes. Pour plus d’informations, consultez la vue d’ensemble de la SoapAttributeOverrides classe.

Pour sérialiser un objet en tant que message SOAP encodé, vous devez construire l’utilisation XmlSerializer d’un XmlTypeMapping objet créé avec la ImportTypeMapping méthode de la SoapReflectionImporter classe.

Remarque

Vous pouvez utiliser le mot SoapEnum dans votre code au lieu du plus long SoapEnumAttribute.

Pour plus d’informations sur l’utilisation d’attributs, consultez Attributs.

Constructeurs

SoapEnumAttribute()	Initialise une nouvelle instance de la classe SoapEnumAttribute.
SoapEnumAttribute(String)	Initialise une nouvelle instance de la classe SoapEnumAttribute en utilisant le nom d'élément spécifié.

Propriétés

Name	Obtient ou définit la valeur générée dans un document XML lorsque XmlSerializer sérialise une énumération ou la valeur reconnue lors de la désérialisation du membre d'énumération.
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)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à