XmlIncludeAttribute Clase

Definición

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

Herencia

Object

Attribute

XmlIncludeAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestran tres clases, dos de las cuales heredan del tercero. El ejemplo aplica a XmlIncludeAttribute un método que devuelve una instancia de una de las clases derivadas.

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

Comentarios

Use cuando XmlIncludeAttribute llame al Serialize método o Deserialize de la XmlSerializer clase .

Al aplicar , XmlIncludeAttributeespecifique el Type de la clase derivada. Cuando serializa XmlSerializer los objetos que incluyen la base y la clase derivada, puede reconocer ambos tipos de objeto.

Puede usar XmlIncludeAttribute para incluir clases derivadas en documentos de descripción del servicio escritos en el lenguaje de descripción de servicios web (WSDL). Por ejemplo, si un método devuelve un Object, aplique al XmlIncludeAttribute método y especifique los tipos reales que se van a devolver.

Para obtener más información sobre WSDL, vea Lenguaje de descripción de servicios web (WSDL) 1.1.

Consulte también

• XmlSerializer
• XmlAttributes
• Introducción a la serialización XML
• Cómo: Especificar un nombre de elemento alternativo para una secuencia XML
• Control de la serialización XML mediante atributos
• Ejemplos de serialización XML
• Herramienta de definición de esquema XML (Xsd.exe)