XmlDocument.Load XmlDocument.Load XmlDocument.Load XmlDocument.Load Method

정의

지정된 XML 데이터를 Stream, URL, TextReader 또는 XmlReader에서 로드합니다.Loads the specified XML data from a Stream, a URL, a TextReader, or an XmlReader.

오버로드

Load(Stream) Load(Stream) Load(Stream) Load(Stream)

지정된 스트림에서 XML 문서를 로드합니다.Loads the XML document from the specified stream.

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

지정된 TextReader에서 XML 문서를 로드합니다.Loads the XML document from the specified TextReader.

Load(String) Load(String) Load(String) Load(String)

지정된 URL에서 XML 문서를 로드합니다.Loads the XML document from the specified URL.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

지정된 XmlReader에서 XML 문서를 로드합니다.Loads the XML document from the specified XmlReader.

Load(Stream) Load(Stream) Load(Stream) Load(Stream)

지정된 스트림에서 XML 문서를 로드합니다.Loads the XML document from the specified stream.

public:
 virtual void Load(System::IO::Stream ^ inStream);
public virtual void Load (System.IO.Stream inStream);
abstract member Load : System.IO.Stream -> unit
override this.Load : System.IO.Stream -> unit
Public Overridable Sub Load (inStream As Stream)

매개 변수

inStream
Stream Stream Stream Stream

로드할 XML 문서가 포함된 스트림입니다.The stream containing the XML document to load.

예외

XML에 로드 또는 구문 분석 오류가 있습니다.There is a load or parse error in the XML. 이 경우 FileNotFoundException이 발생합니다.In this case, a FileNotFoundException is raised.

설명

참고

Load 메서드는 항상 유효 공백 유지 합니다.The Load method always preserves significant white space. PreserveWhitespace 속성 불필요 한 공백을 요소 콘텐츠에서 공백을 보존 되는지 여부를 결정 합니다.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. 기본값은 false; 요소 콘텐츠에서 공백을 유지 되지 않습니다.The default is false; white space in element content is not preserved.

유효성 검사를 수행 합니다 하는 경우 유효성 검사를 만들 수 있습니다 XmlReader 를 사용 하 여 인스턴스를 XmlReaderSettings 클래스 및 Create 메서드.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. 자세한 내용은 XmlReader 참조 페이지의 설명 섹션을 참조하세요.For more information, see the Remarks section of the XmlReader reference page.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

이 메서드는 입력 (예: utf-8, ANSI 및 등)에 XML 문자열 형식의 자동으로 검색합니다.This method automatically detects the string format of the input XML (for example, UTF-8, ANSI, and so on). 스트림을 읽는 데 사용 되는 인코딩을 알아야 애플리케이션에 필요한 경우는 XmlTextReader 스트림의 읽을 개체를 사용 하 여는 XmlTextReader.Encoding 인코딩을 결정 하는 속성입니다.If your application needs to know which encoding is used to read the stream, consider using an XmlTextReader object to read the stream, and then use the XmlTextReader.Encoding property to determine the encoding. 사용 해야 하는 경우는 XmlDocument XML 작업할 개체를 사용할 수는 XmlTextReader 만들려면 개체입니다.If you need to use a XmlDocument object to work with XML, you can use the XmlTextReader object to create one. 자세한 내용은 XPathDocument 및 XmlDocument를 사용 하 여 XML 데이터를 읽는합니다.For more information, see Reading XML Data using XPathDocument and XmlDocument.

추가 정보

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

지정된 TextReader에서 XML 문서를 로드합니다.Loads the XML document from the specified TextReader.

public:
 virtual void Load(System::IO::TextReader ^ txtReader);
public virtual void Load (System.IO.TextReader txtReader);
abstract member Load : System.IO.TextReader -> unit
override this.Load : System.IO.TextReader -> unit
Public Overridable Sub Load (txtReader As TextReader)

매개 변수

txtReader
TextReader TextReader TextReader TextReader

XML 데이터를 문서에 제공하기 위해 사용하는 TextReader입니다.The TextReader used to feed the XML data into the document.

예외

XML에 로드 또는 구문 분석 오류가 있습니다.There is a load or parse error in the XML. 이 경우 문서는 빈 상태로 유지됩니다.In this case, the document remains empty.

예제

다음 예제에서는 합니다 StringReader XML 데이터의 문자열이 로드 클래스를 XmlDocument 개체입니다.The following example uses the StringReader class to load a string of XML data into the XmlDocument object.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew StringReader( xmlData ) );
   
   // Create a new element and add it to the document.
   XmlElement^ elem = doc->CreateElement( "bk", "genre", "urn:samples" );
   elem->InnerText = "fantasy";
   doc->DocumentElement->AppendChild( elem );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}
Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

    Console.WriteLine("Display the modified XML...")
    doc.Save(Console.Out)

  end sub
end class

설명

참고

Load 메서드는 항상 유효 공백 유지 합니다.The Load method always preserves significant white space. PreserveWhitespace 속성 불필요 한 공백을 요소 콘텐츠에서 공백을 보존 되는지 여부를 결정 합니다.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. 기본값은 false; 요소 콘텐츠에서 공백을 유지 되지 않습니다.The default is false; white space in element content is not preserved.

유효성 검사를 수행 합니다 하는 경우 유효성 검사를 만들 수 있습니다 XmlReader 를 사용 하 여 인스턴스를 XmlReaderSettings 클래스 및 Create 메서드.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. 자세한 내용은 XmlReader 참조 페이지의 설명 섹션을 참조하세요.For more information, see the Remarks section of the XmlReader reference page.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

추가 정보

Load(String) Load(String) Load(String) Load(String)

지정된 URL에서 XML 문서를 로드합니다.Loads the XML document from the specified URL.

public:
 virtual void Load(System::String ^ filename);
public virtual void Load (string filename);
abstract member Load : string -> unit
override this.Load : string -> unit
Public Overridable Sub Load (filename As String)

매개 변수

filename
String String String String

로드할 XML 문서가 포함된 파일의 URL입니다.URL for the file containing the XML document to load. URL은 로컬 파일 또는 HTTP URL(웹 주소)일 수 있습니다.The URL can be either a local file or an HTTP URL (a Web address).

예외

XML에 로드 또는 구문 분석 오류가 있습니다.There is a load or parse error in the XML. 이 경우 FileNotFoundException이 발생합니다.In this case, a FileNotFoundException is raised.

filename가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.filename is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.The specified path, file name, or both exceed the system-defined maximum length.

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).The specified path is invalid (for example, it is on an unmapped drive).

파일을 여는 동안 I/O 오류가 발생했습니다.An I/O error occurred while opening the file.

filename에 읽기 전용인 파일이 지정되었습니다.filename specified a file that is read-only.

또는-or- 현재 플랫폼이 해당 작업을 지원하지 않는 경우This operation is not supported on the current platform.

또는-or- filename에 디렉터리가 지정되었습니다.filename specified a directory.

또는-or- 호출자에게 필요한 권한이 없는 경우The caller does not have the required permission.

filename에 지정된 파일을 찾을 수 없습니다.The file specified in filename was not found.

filename의 형식이 잘못되었습니다.filename is in an invalid format.

호출자에게 필요한 권한이 없는 경우The caller does not have the required permission.

설명

참고

Load 메서드는 항상 유효 공백 유지 합니다.The Load method always preserves significant white space. PreserveWhitespace 속성 불필요 한 공백을 요소 콘텐츠에서 공백을 보존 되는지 여부를 결정 합니다.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. 기본값은 false; 요소 콘텐츠에서 공백을 유지 되지 않습니다.The default is false; white space in element content is not preserved.

유효성 검사를 수행 합니다 하는 경우 유효성 검사를 만들 수 있습니다 XmlReader 를 사용 하 여 인스턴스를 XmlReaderSettings 클래스 및 Create 메서드.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. 자세한 내용은 XmlReader 참조 페이지의 설명 섹션을 참조하세요.For more information, see the Remarks section of the XmlReader reference page.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

추가 정보

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

지정된 XmlReader에서 XML 문서를 로드합니다.Loads the XML document from the specified XmlReader.

public:
 virtual void Load(System::Xml::XmlReader ^ reader);
public virtual void Load (System.Xml.XmlReader reader);
abstract member Load : System.Xml.XmlReader -> unit
override this.Load : System.Xml.XmlReader -> unit
Public Overridable Sub Load (reader As XmlReader)

매개 변수

reader
XmlReader XmlReader XmlReader XmlReader

XML 데이터를 문서에 제공하기 위해 사용하는 XmlReader입니다.The XmlReader used to feed the XML data into the document.

예외

XML에 로드 또는 구문 분석 오류가 있습니다.There is a load or parse error in the XML. 이 경우 문서는 빈 상태로 유지됩니다.In this case, the document remains empty.

예제

다음 예제에서는 마지막 책 노드의 로드를 books.xml XML 문서에는 파일입니다.The following example loads the last book node of the books.xml file into the XML document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   
   //Load the document with the last book node.
   XmlTextReader^ reader = gcnew XmlTextReader( "books.xml" );
   reader->WhitespaceHandling = WhitespaceHandling::None;
   reader->MoveToContent();
   reader->Read();
   reader->Skip(); //Skip the first book.
   reader->Skip(); //Skip the second book.
   doc->Load( reader );
   doc->Save( Console::Out );
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    //Load the document with the last book node.
    XmlTextReader reader = new XmlTextReader("books.xml");
    reader.WhitespaceHandling = WhitespaceHandling.None;
    reader.MoveToContent();
    reader.Read();
    reader.Skip(); //Skip the first book.
    reader.Skip(); //Skip the second book.
    doc.Load(reader);

    doc.Save(Console.Out);
  }
}
Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        
        'Load the document with the last book node.
        Dim reader As New XmlTextReader("books.xml")
        reader.WhitespaceHandling = WhitespaceHandling.None
        reader.MoveToContent()
        reader.Read()
        reader.Skip() 'Skip the first book.
        reader.Skip() 'Skip the second book.
        doc.Load(reader)
        
        doc.Save(Console.Out)
    End Sub 'Main
End Class 'Sample

이 예제에서는 파일을 사용 하 여 books.xml입력으로 합니다.The example uses the file, books.xml, as input.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

설명

참고

Load 메서드는 항상 유효 공백 유지 합니다.The Load method always preserves significant white space. PreserveWhitespace 속성 불필요 한 공백을 요소 콘텐츠에서 공백을 보존 되는지 여부를 결정 합니다.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. 기본값은 false; 요소 콘텐츠에서 공백을 유지 되지 않습니다.The default is false; white space in element content is not preserved.

초기 상태에서 판독기가 있으면 (ReadState ReadState.Initial =), Load 판독기의 전체 내용을 사용 하 고 찾은 내용에서 DOM을 빌드합니다.If the reader is in the initial state (ReadState =ReadState.Initial), Load consumes the entire contents of the reader and builds the DOM from what it finds.

판독기가 이미 "n" 깊이가 일부 노드에 배치 됩니다을 하는 경우이 메서드는 해당 노드 및 모든 후속 형제 "n" 수준을 닫는 끝 태그 최대 로드 합니다.If the reader is already positioned on some node at depth "n", this method loads that node and all subsequent siblings up to the end tag that closes depth "n". 이 다음과 같은 결과가 있습니다.This has the following results.

현재 노드와 해당 형제 다음과 같은 살펴보기:If the current node and its siblings look like the following:

<!--comment--><element1>one</element1><element2>two</element2>  

Load 문서 루트 수준 요소가 두 개를 포함할 수 없으므로 예외가 throw 됩니다.Load throws an exception because a document cannot have two root level elements. 현재 노드와 해당 형제 다음과 같은 살펴보기:If the current node and its siblings look like the following:

<!--comment--><?process instruction?><!--comment--></endtag>  

Load 성공 하지만 루트 수준 요소가 없기 때문에 불완전 한 DOM 트리를 해야 합니다.Load succeeds, but you have an incomplete DOM tree because there is no root level element. 문서를 저장할 추가 해야 합니다는 루트 수준 요소가 고, 그렇지 Save 예외가 throw 됩니다.Before you save the document, you must add a root level element, otherwise Save will throw an exception.

판독기가 배치 될 때까지 읽기를 계속 공백이 나 특성 노드를 예를 들어 문서의 루트 수준에 대해 유효 하지 않은 리프 노드에 판독기가 배치 하는 경우 루트에 사용할 수 있는 노드에 있습니다.If the reader is positioned on a leaf node that is invalid for the root level of a document, for example a white space or attribute node, the reader continues to read until it is positioned on a node that can be used for the root. 이때 문서가 로드되기 시작합니다.The document begins loading at this point.

유효성 검사를 수행 합니다 하는 경우 유효성 검사를 만들 수 있습니다 XmlReader 를 사용 하 여 인스턴스를 XmlReaderSettings 클래스 및 Create 메서드.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. 자세한 내용은 XmlReader 참조 페이지의 설명 섹션을 참조하세요.For more information, see the Remarks section of the XmlReader reference page.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

추가 정보

적용 대상