XmlDeclaration.Encoding Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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).