SoapAttributeAttribute Classe

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

netstandard.dll, System.Xml.XmlSerializer.dll

Origine:

SoapAttributeAttribute.cs

Specifica che XmlSerializer deve serializzare il membro della classe come attributo SOAP codificato.

C#

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class SoapAttributeAttribute : Attribute

Ereditarietà

Object

Attribute

SoapAttributeAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene serializzata una classe che contiene diversi campi a cui viene applicato un oggetto SoapAttributeAttribute .

C#

using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Serialization;
using System.Xml.Schema;

[SoapInclude(typeof(Vehicle))]
public class Group
{
   [SoapAttribute (Namespace = "http://www.cpandl.com")]
   public string GroupName;

   [SoapAttribute(DataType = "base64Binary")]
   public Byte [] GroupNumber;

   [SoapAttribute(DataType = "date", AttributeName = "CreationDate")]
   public DateTime Today;
   [SoapElement(DataType = "nonNegativeInteger", ElementName = "PosInt")]
   public string PostitiveInt;

   public Vehicle GroupVehicle;
}

public class Vehicle
{
   public string licenseNumber;
}

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("SoapAtts.xml");
      test.DeserializeObject("SoapAtts.xml");
   }
   public void SerializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class that
      // can generate encoded SOAP messages.
      XmlSerializer mySerializer =  ReturnSOAPSerializer();

      Group myGroup=MakeGroup();
      // Writing the file requires a TextWriter.
      XmlTextWriter writer =
      new XmlTextWriter(filename, Encoding.UTF8);
      writer.Formatting = Formatting.Indented;
      writer.WriteStartElement("wrapper");
      // Serialize the class, and close the TextWriter.
      mySerializer.Serialize(writer, myGroup);
      writer.WriteEndElement();
      writer.Close();
   }

   private Group MakeGroup(){
      // Create an instance of the class that will be serialized.
      Group myGroup = new Group();

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

      Byte [] hexByte = new Byte[2]{Convert.ToByte(100),
      Convert.ToByte(50)};
      myGroup.GroupNumber = hexByte;

      DateTime myDate = new DateTime(2002,5,2);
      myGroup.Today = myDate;
      myGroup.PostitiveInt= "10000";
      myGroup.GroupVehicle = new Vehicle();
      myGroup.GroupVehicle.licenseNumber="1234";
      return myGroup;
   }   	

   public void DeserializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class that
      // can generate encoded SOAP messages.
      XmlSerializer mySerializer =  ReturnSOAPSerializer();

      // Reading the file requires an  XmlTextReader.
      XmlTextReader reader=
      new XmlTextReader(filename);
      reader.ReadStartElement("wrapper");

      // Deserialize and cast the object.
      Group myGroup;
      myGroup = (Group) mySerializer.Deserialize(reader);
      reader.ReadEndElement();
      reader.Close();
   }

   private XmlSerializer ReturnSOAPSerializer(){
      // Create an instance of the XmlSerializer class.
      XmlTypeMapping myMapping =
      (new SoapReflectionImporter().ImportTypeMapping
      (typeof(Group)));
       return new XmlSerializer(myMapping);
   }
}

Commenti

La SoapAttributeAttribute classe appartiene a una famiglia di attributi che controlla il modo in cui serializza XmlSerializer o deserializza un oggetto come XML SOAP codificato. Il codice XML risultante è conforme alla sezione 5 del documento World Wide Web Consortium, Simple Object Access Protocol (SOAP) 1.1. Per un elenco completo di attributi simili, vedere Attributi che controllano la serializzazione SOAP codificata.

Per serializzare un oggetto come messaggio SOAP codificato, è necessario costruire XmlSerializer utilizzando un XmlTypeMapping oggetto creato con il ImportTypeMapping metodo della SoapReflectionImporter classe .

Applicare a SoapAttributeAttribute un campo pubblico per specificare che il XmlSerializer campo viene serializzato come attributo XML. È possibile specificare un nome alternativo dell'attributo impostando la AttributeName proprietà . Impostare se DataType all'attributo deve essere assegnato un tipo di dati XSD (XML Schema Definition Language) specifico. Se l'attributo appartiene a uno spazio dei nomi XML specifico, impostare la Namespace proprietà .

Per altre informazioni sull'uso degli attributi, vedere Attributi

Nota

È possibile usare la parola SoapAttribute nel codice anziché quella più lunga SoapAttributeAttribute.

Costruttori

SoapAttributeAttribute()	Inizializza una nuova istanza della classe SoapAttributeAttribute.
SoapAttributeAttribute(String)	Consente di inizializzare una nuova istanza della classe SoapAttributeAttribute utilizzando il valore specificato come nome dell'attributo XML.

Proprietà

AttributeName	Ottiene o imposta il nome dell'attributo XML generato dalla classe XmlSerializer.
DataType	Ottiene o imposta il tipo di dati XSD (XML Schema Definition Language) dell'attributo SOAP generato mediante la classe XmlSerializer.
Namespace	Ottiene o imposta lo spazio dei nomi XML dell'attributo XML.
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)

Si applica a

Vedi anche

• XmlSerializer
• SoapAttributeOverrides
• SoapAttribute