XmlIncludeAttribute Classe

Definição

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

Herança

Object

Attribute

XmlIncludeAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra três classes, duas das quais herdam da terceira. O exemplo aplica-se a XmlIncludeAttribute um método que retorna uma instância de uma das classes 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 {
}

Comentários

Use o XmlIncludeAttribute quando você chamar o método ou Deserialize o Serialize método da XmlSerializer classe.

Ao aplicar o XmlIncludeAttribute, especifique a Type classe derivada. Quando os XmlSerializer objetos serializados que incluem a base e a classe derivada, ele pode reconhecer ambos os tipos de objeto.

Você pode usar as XmlIncludeAttribute classes derivadas para incluir em documentos de descrição de serviço que são escritos na Linguagem de Descrição dos Serviços Web (WSDL). Por exemplo, se um método retornar um Object, aplique o XmlIncludeAttribute método e especifique os tipos reais a serem retornados.

Para obter mais informações sobre o WSDL, consulte a Linguagem de Descrição dos Serviços Web (WSDL) 1.1.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• XmlSerializer
• XmlAttributes
• Apresentando a serialização XML
• Como especificar um nome de elemento alternativo para um fluxo XML
• Controlando a serialização XML usando atributos
• Exemplos de Serialização XML
• Ferramenta de Definição de Esquema XML (Xsd.exe)