XmlIncludeAttribute Classe

Définition

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.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

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

Public Class XmlIncludeAttribute
Inherits Attribute

Héritage

Object

Attribute

XmlIncludeAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre trois classes, dont deux héritent du troisième. L’exemple applique la XmlIncludeAttribute méthode qui retourne une instance de l’une des classes dérivées.

<%@ 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 {
}

Remarques

Utilisez le XmlIncludeAttribute moment où vous appelez la Serialize classe ou Deserialize la méthode XmlSerializer .

Lors de l’application XmlIncludeAttributedu , spécifiez la Type classe dérivée. Lorsque le XmlSerializer sérialise des objets qui incluent à la fois la base et la classe dérivée, il peut ensuite reconnaître les deux types d’objets.

Vous pouvez utiliser les XmlIncludeAttribute classes dérivées dans les documents de description de service écrits dans le langage WSDL (Web Services Description Language). Par exemple, si une méthode retourne un Object, appliquez la XmlIncludeAttribute méthode et spécifiez les types réels à retourner.

Pour plus d’informations sur WSDL, consultez Web Services Description Language (WSDL) 1.1.

Voir aussi

• XmlSerializer
• XmlAttributes
• Présentation de la sérialisation XML
• Guide pratique pour spécifier un autre nom d’élément pour un flux XML
• Contrôle de la sérialisation XML à l’aide d’attributs
• Exemples de sérialisation XML
• Outil de définition de schéma XML (Xsd.exe)