SoapEnumAttribute Klasse

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Steuert die Art, in der XmlSerializer einen Enumerationsmember serialisiert.

C#

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

Vererbung

Object

Attribute

SoapEnumAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird die Serialisierung einer Klasse verwendet, die XmlSerializer eine Enumeration mit Food dem Namen FoodType". Die FoodType Enumeration wird überschrieben, indem sie eine SoapEnumAttribute für jede Enumeration erstellen und die SoapEnum Eigenschaft einer auf die SoapEnumAttributeSoapAttributes . Dies SoapAttributes wird zu einer SoapAttributeOverrides hinzugefügt, die zum Erstellen eines 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();
    }
}

Hinweise

Die SoapEnumAttribute Klasse gehört zu einer Familie von Attributen, die steuert, wie das XmlSerializer Serialisieren oder Deserialisieren eines Objekts als codierte SOAP-XML-Code. Der resultierende XML-Code entspricht Abschnitt 5 des World Wide Web Consortium-Dokuments Simple Object Access Protocol (SOAP) 1.1. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute, die codierte SOAP-Serialisierung steuern.

Um ein Objekt als codierte SOAP-Nachricht serialisieren zu können, müssen Sie die XmlSerializer Verwendung einer XmlTypeMapping mit der ImportTypeMapping Methode der SoapReflectionImporter Klasse erstellten Erstellen.

Verwenden Sie die SoapEnumAttribute Zuzählung, die generiert XmlSerializer oder erkannt wird (wenn sie eine Klasse serialisiert oder deserialisiert). Wenn z. B. eine Enumeration ein Element Onemit dem Namen enthält, aber Sie bevorzugen, dass die XML-Ausgabe benannt Singlewerden soll, wenden Sie das SoapEnumAttribute Aufzählungselement an, und legen Sie die Name Eigenschaft auf "Single" fest.

Sie können den Name Eigenschaftswert eines SoapEnumAttribute Werts außer Kraft setzen, indem Sie eine Instanz der SoapEnumAttribute Klasse erstellen und der SoapEnum Eigenschaft einer Klasse SoapAttributeszuweisen. Ausführliche Informationen finden Sie in der SoapAttributeOverrides Klassenübersicht.

Um ein Objekt als codierte SOAP-Nachricht serialisieren zu können, müssen Sie die XmlSerializer Verwendung einer XmlTypeMapping mit der ImportTypeMapping Methode der SoapReflectionImporter Klasse erstellten Erstellen.

Hinweis

Sie können das Wort SoapEnum in Ihrem Code anstelle der längeren SoapEnumAttributeVerwenden.

Weitere Informationen zur Verwendung von Attributen finden Sie unter Attribute.

Konstruktoren

SoapEnumAttribute()	Initialisiert eine neue Instanz der SoapEnumAttribute-Klasse.
SoapEnumAttribute(String)	Initialisiert eine neue Instanz der SoapEnumAttribute-Klasse mit dem angegebenen Elementnamen.

Eigenschaften

Name	Ruft den Wert ab, der bei der Serialisierung einer Enumeration durch XmlSerializer in einem XML-Dokument generiert bzw. bei der Deserialisierung des Enumerationsmembers erkannt wurde, oder legt diesen fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für