XmlIncludeAttribute Classe

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

netstandard.dll, System.Xml.XmlSerializer.dll

Origine:

XmlIncludeAttribute.cs

Consente al XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto.

public ref class XmlIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class XmlIncludeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type XmlIncludeAttribute = class
    inherit Attribute

Public Class XmlIncludeAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

XmlIncludeAttribute

Attributi

AttributeUsageAttribute

Esempio

L'esempio seguente mostra tre classi, due delle quali ereditano dal terzo. Nell'esempio viene applicato a XmlIncludeAttribute un metodo che restituisce un'istanza di una delle classi derivate.

<%@ WebService Language="C#" Class="Test" %>
 
using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;
using System.Xml;
using System.Xml.Schema;
using System.Xml.Serialization;
using System.Data;
 
public class Test : WebService {
   [WebMethod()]
   [return:XmlElement("MyTime", DataType="time")]
   public DateTime EchoString([XmlElement(DataType="string")] 
   string strval) {
        return DateTime.Now;
   }
 
   [WebMethod()]
   [XmlInclude(typeof(Car)), XmlInclude(typeof(Bike))]
   public Vehicle Vehicle(string licenseNumber) {
      if (licenseNumber == "0") {
         Vehicle v = new Car();
         v.licenseNumber = licenseNumber;
         return v;
      }
      else if (licenseNumber == "1") {
          Vehicle v = new Bike();
          v.licenseNumber = licenseNumber;
          return v;
      }
      else {
         return null;
      }
   }
}
[XmlRoot("NewVehicle")] 
public abstract class Vehicle {
    public string licenseNumber;
    public DateTime make;
}
 
public class Car : Vehicle {
}
 
public class Bike : Vehicle {
}

Commenti

Usare quando XmlIncludeAttribute si chiama il Serialize metodo o Deserialize della XmlSerializer classe .

Quando si applica , XmlIncludeAttributespecificare l'oggetto Type della classe derivata. Quando l'oggetto XmlSerializer serializza oggetti che includono sia la base che la classe derivata, può quindi riconoscere entrambi i tipi di oggetto.

È possibile utilizzare XmlIncludeAttribute per includere classi derivate nei documenti di descrizione del servizio scritti nel linguaggio WSDL (Web Services Description Language). Ad esempio, se un metodo restituisce un Objectoggetto , applicare l'oggetto XmlIncludeAttribute al metodo e specificare i tipi effettivi da restituire.

Per altre informazioni su WSDL, vedere Web Services Description Language (WSDL) 1.1.

Costruttori

Nome	Descrizione
XmlIncludeAttribute(Type)	Inizializza una nuova istanza della classe XmlIncludeAttribute.

Proprietà

Nome	Descrizione
Type	Ottiene o imposta il tipo dell'oggetto da includere.
TypeId	Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute)

Metodi

Nome	Descrizione
Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per questa istanza. (Ereditato da Attribute)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Quando sottoposto a 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 è uguale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• XmlSerializer
• XmlAttributes
• Introduzione alla serializzazione XML
• Procedura: Specificare un nome di elemento alternativo per un flusso XML
• Controllo della serializzazione XML tramite attributi
• Esempi di serializzazione XML
• Xml Schema Definition Tool (Xsd.exe)