IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) Method

정의

개체를 XML 표현으로 변환합니다.Converts an object into its XML representation.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);
public void WriteXml (System.Xml.XmlWriter writer);
abstract member WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)

매개 변수

writer
XmlWriter XmlWriter XmlWriter XmlWriter

개체가 serialize되는 XmlWriter 스트림입니다.The XmlWriter stream to which the object is serialized.

예제

다음 예제 구현의 WriteXml 메서드.The following example illustrates an implementation of the WriteXml method.

virtual void WriteXml( XmlWriter^ writer )
{
   writer->WriteString( personName );
}
public void WriteXml (XmlWriter writer)
{
    writer.WriteString(personName);
}

다음 예제를 사용 하 여 XmlSerializer 이 개체를 deserialize 할 클래스입니다.The following example illustrates the use of the XmlSerializer class to deserialize this object.

#using <System.Xml.dll>
#using <System.dll>
#using <Person.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Serialization;

int main()
{
   // Create a person object.
   Person ^ fred = gcnew Person( "Fred Flintstone" );

   // Serialize the object to a file.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "test.xml", nullptr );
   XmlSerializer^ serializer = gcnew XmlSerializer( Person::typeid );
   serializer->Serialize( writer, fred );
}
using System;
using System.Xml;
using System.Xml.Serialization;

public class Writer {

  public static void Main() {

    // Create a person object.
    Person fred = new Person("Fred Flintstone");

    // Serialize the object to a file.
    XmlTextWriter writer = new XmlTextWriter("test.xml", null);
    XmlSerializer serializer = new XmlSerializer(typeof(Person));
    serializer.Serialize(writer, fred);
  }

}

설명

WriteXml 구현을 제공 하는 개체의 XML 표현을 작성 해야 합니다.The WriteXml implementation you provide should write out the XML representation of the object. 프레임 워크는 래퍼 요소를 쓰고 해당 시작 후 XML 작성기를 배치 합니다.The framework writes a wrapper element and positions the XML writer after its start. 구현에는 자식 요소를 포함 하 여 해당 콘텐츠를 작성할 수 있습니다.Your implementation may write its contents, including child elements. 프레임 워크는 그런 다음 래퍼 요소를 닫습니다.The framework then closes the wrapper element.

에 충분 한 정보를 기록 합니다 XmlWriter 수 있도록 stream을 ReadXml 개체를 다시 구성 하는 방법.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

예를 들어, 개체 상태 배열 변수를 포함 하는 경우 배열의 길이 작성 해야 하거나 개체가 재구성 될 때 읽을 값의 개수를 알 수 있도록 배열 값을 설명 하는 요소를 포함 하는 부모 요소를 사용 합니다.For example, if your object state includes an array variable, be sure to write the length of the array, or use a parent element to contain the elements that describe the array values, so that you know how many values to read when the object is reconstituted.

적용 대상