XmlDeclaration.Encoding プロパティ

XML ドキュメントのエンコーディング レベルを取得または設定します。

Public Property Encoding As String
[C#]
public string Encoding {get; set;}
[C++]
public: __property String* get_Encoding();public: __property void set_Encoding(String*);
[JScript]
public function get Encoding() : String;public function set Encoding(String);

プロパティ値

有効な文字エンコーディング名。通常サポートされている XML の文字エンコーディング名を次に示します。

カテゴリ	エンコーディング名
Unicode	UTF-8、UTF-16
ISO 10646	ISO-10646-UCS-2、ISO-10646-UCS-4
ISO 8859	ISO-8859-n ("n" は 1 から 9 までの数字)
JIS X-0208-1997	ISO-2022-JP、Shift_JIS、EUC-JP

この値はオプションです。値が設定されていない場合は、このプロパティが String.Empty を返します。エンコーディング属性が含まれていない場合は、ドキュメントが書き込まれたり保存されるときに、UTF-8 エンコーディングであると見なされます。

解説

ほとんどの XML 属性とは異なり、エンコーディング属性値は大文字小文字を区別しません。これは、エンコーディング文字名が ISO 標準規格および IANA (Internet Assigned Numbers Authority) 標準規格に準拠しているためです。

使用例

[Visual Basic, C#, C++] XmlDeclaration ノードを作成し、XML ドキュメントに追加する例を次に示します。

 
Imports System
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

[C#] 
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);
      
  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
 
int main() 
{
    // Create and load the XML document.
    XmlDocument* doc = new XmlDocument();
    String* xmlString = S"<book><title>Oberon's Legacy</title></book>";
    doc->Load(new StringReader(xmlString));
  
    // Create an XML declaration. 
    XmlDeclaration* xmldecl;
    xmldecl = doc->CreateXmlDeclaration(S"1.0",0,0);
    xmldecl->Encoding=S"UTF-8";
    xmldecl->Standalone=S"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);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlDeclaration クラス | XmlDeclaration メンバ | System.Xml 名前空間