XmlIncludeAttribute Klasa

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestawy:

netstandard.dll, System.Xml.XmlSerializer.dll

Źródło:

XmlIncludeAttribute.cs

Umożliwia XmlSerializer rozpoznawanie typu podczas serializacji lub deserializacji obiektu.

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.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type XmlIncludeAttribute = class
    inherit Attribute

Public Class XmlIncludeAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

XmlIncludeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie przedstawiono trzy klasy, z których dwie dziedziczą po trzeciej. W przykładzie XmlIncludeAttribute zastosowano metodę zwracającą wystąpienie jednej z klas pochodnych.

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

Uwagi

XmlIncludeAttribute Użyj metody podczas wywoływania Serialize metody Deserialize lub XmlSerializer klasy .

Podczas stosowania XmlIncludeAttributeklasy , określ Type klasę pochodną. XmlSerializer Gdy serializuje obiekty, które obejmują zarówno bazę, jak i klasę pochodną, może rozpoznać oba typy obiektów.

Można użyć elementu XmlIncludeAttribute , aby uwzględnić klasy pochodne w dokumentach opisu usługi napisanych w języku WSDL (Web Services Description Language). Jeśli na przykład metoda zwraca metodę , zastosuj Object metodę XmlIncludeAttributedo metody i określ rzeczywiste typy, które mają być zwracane.

Aby uzyskać więcej informacji na temat języka WSDL, zobacz Web Services Description Language (WSDL) 1.1.

Konstruktory

Nazwa	Opis
XmlIncludeAttribute(Type)	Inicjuje nowe wystąpienie klasy XmlIncludeAttribute.

Właściwości

Nazwa	Opis
Type	Pobiera lub ustawia typ obiektu do uwzględnienia.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• XmlSerializer
• XmlAttributes
• Wprowadzenie do serializacji XML
• Instrukcje: określanie alternatywnej nazwy elementu dla strumienia XML
• Kontrolowanie serializacji XML przy użyciu atrybutów
• Przykłady serializacji XML
• Narzędzie definicji schematu XML (Xsd.exe)