XmlIncludeAttribute Klasse

Definition

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

Vererbung

Object

Attribute

XmlIncludeAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel zeigt drei Klassen, von denen zwei vom dritten erben. Im Beispiel wird die XmlIncludeAttribute Methode angewendet, die eine Instanz einer der abgeleiteten Klassen zurückgibt.

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

Hinweise

Verwenden Sie die Methode oder Deserialize die SerializeXmlIncludeAttribute Methode der Klasse, wenn Sie die XmlSerializer Klasse aufrufen.

Geben Sie beim Anwenden der XmlIncludeAttributeabgeleiteten Klasse die Type abgeleitete Klasse an. Wenn die XmlSerializer Objekte serialisiert, die sowohl die Basis als auch die abgeleitete Klasse enthalten, können beide Objekttypen erkannt werden.

Sie können abgeleitete XmlIncludeAttribute Klassen in Dienstbeschreibungsdokumente einschließen, die in der Beschreibungssprache für Webdienste (Web Services Description Language, WSDL) geschrieben sind. Wenn z. B. eine Methode einen ObjectWert zurückgibt, wenden Sie die XmlIncludeAttribute Methode an, und geben Sie die tatsächlichen Typen an, die zurückgegeben werden sollen.

Weitere Informationen zur WSDL finden Sie unter Web Services Description Language (WSDL) 1.1.

Weitere Informationen

• XmlSerializer
• XmlAttributes
• Einführung in die XML-Serialisierung
• Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
• Steuern der XML-Serialisierung mithilfe von Attributen
• Beispiele für die XML-Serialisierung
• XML Schema Definition-Tool (Xsd.exe)