XmlDeclaration.Encoding Egenskap

Definition

Hämtar eller anger kodningsnivån för XML-dokumentet.

public:
 property System::String ^ Encoding { System::String ^ get(); void set(System::String ^ value); };
public string Encoding { get; set; }
member this.Encoding : string with get, set
Public Property Encoding As String

Egenskapsvärde

Det giltiga teckenkodningsnamnet. De vanligaste teckenkodningsnamnen för XML är följande:

Kategori Kodningsnamn
Unicode UTF-8, UTF-16
ISO 10646 ISO-10646-UCS-2, ISO-10646-UCS-4
ISO 8859 ISO-8859-n (där "n" är en siffra från 1 till 9)
JIS X-0208-1997 ISO-2022-JP, Shift_JIS, EUC-JP

Det här värdet är valfritt. Om ett värde inte har angetts returnerar den här egenskapen String.Empty.

Om ett kodningsattribut inte ingår antas UTF-8-kodning när dokumentet skrivs eller sparas.

Exempel

I följande exempel skapas en XmlDeclaration nod och läggs till i ett XML-dokument.

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

public class Sample {

  public static void Main() {

    // Create and load the XML document.
    XmlDocument doc = new XmlDocument();
    string xmlString = "<book><title>Oberon's Legacy</title></book>";
    doc.Load(new StringReader(xmlString));

    // Create an XML declaration.
    XmlDeclaration xmldecl;
    xmldecl = doc.CreateXmlDeclaration("1.0",null,null);
    xmldecl.Encoding="UTF-8";
    xmldecl.Standalone="yes";

    // Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    doc.InsertBefore(xmldecl, root);

    // Display the modified XML document
    Console.WriteLine(doc.OuterXml);
  }
}
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 
   
    ' Create and load the XML document.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlString as string = "<book><title>Oberon's Legacy</title></book>"
    doc.Load(new StringReader(xmlString))
  
    ' Create an XML declaration. 
    Dim xmldecl as XmlDeclaration 
    xmldecl = doc.CreateXmlDeclaration("1.0",nothing, nothing)
    xmldecl.Encoding="UTF-8"
    xmldecl.Standalone="yes"     
      
    ' Add the new node to the document.
    Dim root as XmlElement = doc.DocumentElement
    doc.InsertBefore(xmldecl, root)
    
    ' Display the modified XML document 
    Console.WriteLine(doc.OuterXml)
      
  end sub
end class

Kommentarer

Till skillnad från de flesta XML-attribut är kodningsattributvärden inte skiftlägeskänsliga. Det beror på att kodning av teckennamn följer ISO- och IANA-standarder (Internet Assigned Numbers Authority).

Gäller för