XmlIncludeAttribute Sınıf

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.XmlSerializer.dll

Kaynak:

XmlIncludeAttribute.cs

XmlSerializer bir nesneyi seri hale getirdiğinde veya seri durumdan çıkardığında türü tanımasına izin verir.

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

Devralma

Object

Attribute

XmlIncludeAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte, ikisi üçüncü sınıftan devralan üç sınıf gösterilmektedir. Örnek, XmlIncludeAttribute türetilmiş sınıflardan birinin örneğini döndüren bir yönteme uygular.

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

Açıklamalar

XmlIncludeAttribute sınıfının veya Serialize yöntemini Deserialize çağırdığınızda XmlSerializer kullanın.

uygulanırken XmlIncludeAttributetüretilmiş sınıfın değerini Type belirtin. XmlSerializer hem temel hem de türetilmiş sınıfı içeren nesneleri serileştirdiğinde, her iki nesne türünü de tanıyabilir.

Web Hizmetleri Açıklama Dili'nde (WSDL) yazılmış hizmet açıklaması belgelerine türetilmiş sınıflar eklemek için kullanabilirsiniz XmlIncludeAttribute . Örneğin, bir yöntem döndürürse Objectyöntemine uygulayın XmlIncludeAttribute ve döndürülecek gerçek türleri belirtin.

WSDL hakkında daha fazla bilgi için bkz. Web Hizmetleri Açıklama Dili (WSDL) 1.1.

Oluşturucular

Name	Description
XmlIncludeAttribute(Type)	XmlIncludeAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Type	Eklenecek nesnenin türünü alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• XmlSerializer
• XmlAttributes
• XML Serileştirmeye Giriş
• Nasıl yapılır: XML Akışı için Alternatif Öğe Adı Belirtme
• Öznitelikleri Kullanarak XML Serileştirmesini Denetleme
• XML Serileştirme Örnekleri
• XML Şema Tanımı Aracı (XSD.exe)