IXmlSerializable Arabirim

Tanım

Ad Alanı:
System.Xml.Serialization
Bütünleştirilmiş Kodlar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
IXmlSerializable.cs
Kaynak:
IXmlSerializable.cs

XML serileştirme ve seri durumdan çıkarma için özel biçimlendirme sağlar.

public interface class IXmlSerializable
public interface IXmlSerializable
type IXmlSerializable = interface
Public Interface IXmlSerializable
Türetilmiş

Örnekler

Aşağıdaki örnek kod, özel bir alanı seri hale getiren arabirimin IXmlSerializable bir uygulamasını gösterir.

using System;
using System.Xml;
using System.Xml.Schema;
using System.Xml.Serialization;

public class Person : IXmlSerializable
{

    // Private state

    private string personName;

    // Constructors

    public Person (string name)
    {
        personName = name;
    }

    public Person ()
    {
        personName = null;
    }

    // Xml Serialization Infrastructure

    public void WriteXml (XmlWriter writer)
    {
        writer.WriteString(personName);
    }

    public void ReadXml (XmlReader reader)
    {
        personName = reader.ReadString();
    }

    public XmlSchema GetSchema()
    {
        return(null);
    }

    // Print

    public override string ToString()
    {
        return(personName);
    }
}

Açıklamalar

Bu arabirimi uygulamak için iki neden vardır. Birincisi, nesnenizin tarafından nasıl seri hale getirilmeye veya seri durumdan çıkarıldığını denetlemektir XmlSerializer. Örneğin, büyük veri kümelerini arabelleğe alma yerine verileri bayt olarak öbekleyebilir ve ayrıca veriler Base64 kodlaması kullanılarak kodlandığında oluşan enflasyondan kaçınabilirsiniz. Serileştirmeyi denetlemek için, XML'yi WriteXmlReadXml okumak ve yazmak için kullanılan ve sınıflarını denetlemek XmlReader için ve XmlWriter yöntemlerini uygulayın. Bunun bir örneği için bkz . Nasıl yapılır: Serileştirilmiş Verileri Öbekle.

İkinci neden şemayı denetleyebilmektir. Bunu etkinleştirmek için, serileştirilebilir türüne uygulamasını XmlSchemaProviderAttribute ve şemayı döndüren statik üyenin adını belirtmeniz gerekir. Örneğine XmlSchemaProviderAttribute bakın.

Arabirimini uygulayan bir sınıfın parametresiz oluşturucuya sahip olması gerekir. Bu, sınıfın XmlSerializer bir gereksinimidir.

Yöntemler

Name Description
GetSchema()

Bu yöntem ayrılmıştır ve kullanılmamalıdır. IXmlSerializable arabirimini uygularken, bu yöntemden null (Visual Basic'da Nothing) döndürmelisiniz ve bunun yerine, özel bir şema belirtilmesi gerekiyorsa sınıfına XmlSchemaProviderAttribute uygulamanız gerekir.
ReadXml(XmlReader)

XML gösteriminden bir nesne oluşturur.
WriteXml(XmlWriter)

Nesneyi XML gösterimine dönüştürür.

Şunlara uygulanır

Ayrıca bkz.