XmlIncludeAttribute Osztály

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

XmlIncludeAttribute.cs

Lehetővé teszi egy XmlSerializer típus felismerését, amikor szerializál vagy deszerializál egy objektumot.

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

Öröklődés

Object

Attribute

XmlIncludeAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa három osztályt mutat be, amelyek közül kettő a harmadiktól örököl. A példa egy XmlIncludeAttribute olyan metódusra vonatkozik, amely az egyik származtatott osztály egy példányát adja vissza.

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

Megjegyzések

Használja az XmlIncludeAttribute osztály vagy Serialize metódus Deserialize meghívásának XmlSerializer módját.

A származtatott XmlIncludeAttributeosztály alkalmazásakor adja meg a Type származtatott osztályt. Ha a szerializálja az XmlSerializer alap- és a származtatott osztályt is tartalmazó objektumokat, akkor mindkét objektumtípus felismerhető.

A használatával XmlIncludeAttribute származtatott osztályokat vehet fel a webszolgáltatások leírási nyelvén (WSDL) írt szolgáltatásleírási dokumentumokba. Ha például egy metódus egy értéket ad vissza Object, alkalmazza a XmlIncludeAttribute metódust, és adja meg a visszaadandó tényleges típusokat.

További információ a WSDL-ről: Web Services Description Language (WSDL) 1.1.

Konstruktorok

Name	Description
XmlIncludeAttribute(Type)	Inicializálja a XmlIncludeAttribute osztály új példányát.

Tulajdonságok

Name	Description
Type	Lekéri vagy beállítja a belefoglalandó objektum típusát.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• XmlSerializer
• XmlAttributes
• Az XML-szerializálás bemutatása
• Útmutató: Alternatív elemnév megadása XML-adatfolyamhoz
• XML-szerializálás szabályozása attribútumokkal
• Példák XML-szerializálásra
• XML-sémadefiníciós eszköz (Xsd.exe)