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 classe ou Deserialize la Serialize XmlSerializer méthode.

Lors de l’application du XmlIncludeAttribute, 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 la XmlIncludeAttribute méthode permettant d’inclure des classes dérivées dans des 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 à la méthode et spécifiez les types réels à retourner.

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

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• XmlSerializer
• XmlAttributes
• Introduction à la sérialisation XML
• Comment : spécifier un nom d'élément différent pour un flux XML
• Contrôle de la sérialisation XML à l'aide d'attributs
• Exemples de sérialisation XML
• Outil XML Schema Definition (Xsd.exe)