XmlDocument.CreateXmlDeclaration(String, String, String) XmlDocument.CreateXmlDeclaration(String, String, String) XmlDocument.CreateXmlDeclaration(String, String, String) XmlDocument.CreateXmlDeclaration(String, String, String) Method

정의

지정된 값이 있는 XmlDeclaration 노드를 만듭니다.Creates an XmlDeclaration node with the specified values.

public:
 virtual System::Xml::XmlDeclaration ^ CreateXmlDeclaration(System::String ^ version, System::String ^ encoding, System::String ^ standalone);
public virtual System.Xml.XmlDeclaration CreateXmlDeclaration (string version, string encoding, string standalone);
abstract member CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration
override this.CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration
Public Overridable Function CreateXmlDeclaration (version As String, encoding As String, standalone As String) As XmlDeclaration

매개 변수

version
String String String String

버전은 "1.0"이어야 합니다.The version must be "1.0".

encoding
String String String String

인코딩 특성 값입니다.The value of the encoding attribute. XmlDocument를 파일이나 스트림으로 저장할 경우 사용하는 인코딩입니다. 그러므로 Encoding 클래스에서 지원하는 문자열로 설정되어야 합니다. 그렇지 않으면 Save(String)이 실패합니다.This is the encoding that is used when you save the XmlDocument to a file or a stream; therefore, it must be set to a string supported by the Encoding class, otherwise Save(String) fails. null 또는 String.Empty일 경우 Save 메서드에서 인코딩 특성을 XML 선언에 기록하지 않으므로 기본 인코딩인 UTF-8을 사용하게 됩니다.If this is null or String.Empty, the Save method does not write an encoding attribute on the XML declaration and therefore the default encoding, UTF-8, is used.

참고: XmlDocumentTextWriterXmlTextWriter로 저장하면 이 인코딩 값이 삭제됩니다.Note: If the XmlDocument is saved to either a TextWriter or an XmlTextWriter, this encoding value is discarded. 대신 TextWriter 또는 XmlTextWriter의 인코딩을 사용합니다.Instead, the encoding of the TextWriter or the XmlTextWriter is used. 그러면 기록된 XML을 올바른 인코딩을 사용하여 다시 읽을 수 있습니다.This ensures that the XML written out can be read back using the correct encoding.

standalone
String String String String

값은 "Yes" 또는 "No"여야 합니다.The value must be either "yes" or "no". 값이 null이나 String.Empty일 경우에는 Save 메서드에서 독립형 특성을 XML 선언에 기록하지 않습니다.If this is null or String.Empty, the Save method does not write a standalone attribute on the XML declaration.

반환

XmlDeclaration 노드입니다.The new XmlDeclaration node.

예외

version 또는 standalone의 값이 위에서 지정한 값 이외의 값입니다.The values of version or standalone are something other than the ones specified above.

예제

다음 예제에서는 XML 선언을 만들어 문서에 추가 합니다.The following example creates an XML declaration and adds it to the document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create an XML declaration. 
   XmlDeclaration^ xmldecl;
   xmldecl = doc->CreateXmlDeclaration( "1.0", nullptr, nullptr );
   
   //Add the new node to the document.
   XmlElement^ root = doc->DocumentElement;
   doc->InsertBefore( xmldecl, root );
   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()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create an XML declaration. 
    XmlDeclaration xmldecl;
    xmldecl = doc.CreateXmlDeclaration("1.0",null,null);

    //Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    doc.InsertBefore(xmldecl, root);
        
    Console.WriteLine("Display the modified XML...");        
    doc.Save(Console.Out);
  }
}
Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        'Create an XML declaration. 
        Dim xmldecl As XmlDeclaration
        xmldecl = doc.CreateXmlDeclaration("1.0", Nothing, Nothing)
        
        'Add the new node to the document.
        Dim root As XmlElement = doc.DocumentElement
        doc.InsertBefore(xmldecl, root)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main
End Class 'Sample

설명

특성에서 특수 속성으로 노출 되는 XmlDeclaration 노드를 아니라 XmlAttribute 노드.The attributes are exposed as special properties on the XmlDeclaration node, and not as XmlAttribute nodes.

이 메서드가 문서의 컨텍스트에서 새 개체를 만들고, 있지만 추가 되지 않습니다 자동으로 새 개체를 문서 트리에입니다.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. 새 개체를 추가 하려면 명시적으로 노드 삽입 메서드 중 하나가 호출 해야 합니다.To add the new object, you must explicitly call one of the node insert methods.

W3C에 따라 Extensible Markup Language (XML) 1.0 권장 사항XmlDeclaration 노드가 첫 번째 노드는 문서 여야 합니다.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, the XmlDeclaration node must be the first node in the document.

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

적용 대상

추가 정보