XmlIncludeAttribute Класс

Определение

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

Наследование

Object

Attribute

XmlIncludeAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показаны три класса, два из которых наследуются от третьего. В примере применяется XmlIncludeAttribute метод, возвращающий экземпляр одного из производных классов.

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

Комментарии

XmlIncludeAttribute Используйте при вызове Serialize или Deserialize методе XmlSerializer класса.

При применении XmlIncludeAttributeукажите Type производный класс. XmlSerializer При сериализации объектов, включающих как базовый, так и производный класс, он может распознать оба типа объектов.

Вы можете использовать производные XmlIncludeAttribute классы в документы описания служб, написанные на языке описания веб-служб (WSDL). Например, если метод возвращает объект, примените ObjectXmlIncludeAttribute его к методу и укажите фактические типы для возврата.

Дополнительные сведения о WSDL см. в разделе "Язык описания веб-служб" (WSDL) 1.1.

См. также раздел

• XmlSerializer
• XmlAttributes
• Введение в сериализацию XML
• Практическое руководство. Указание альтернативного имени элемента для XML-потока
• Управление сериализацией XML с помощью атрибутов
• Примеры сериализации XML
• Инструмент определения схемы XML (Xsd.exe)