XmlDeclaration.Encoding プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlDeclaration.Encoding プロパティ

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property Encoding As
 String

Visual Basic (使用法)

Dim instance As XmlDeclaration
Dim value As String

value = instance.Encoding

instance.Encoding = value

C#

public string Encoding { get;
 set; }

C++

public:
property String^ Encoding {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Encoding ()

/** @property */
public void set_Encoding (String value)

JScript

public function get Encoding
 () : String

public function set Encoding
 (value : 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) 標準規格に準拠しているためです。

使用例

XmlDeclaration ノードを作成し、XML ドキュメントに追加する例を次に示します。

Visual Basic

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 <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create and load the XML document.
   XmlDocument^ doc = gcnew XmlDocument;
   String^ xmlString = "<book><title>Oberon's Legacy</title></book>";
   doc->Load( gcnew StringReader( xmlString ) );
   
   // Create an XML declaration. 
   XmlDeclaration^ xmldecl;
   xmldecl = doc->CreateXmlDeclaration( "1.0", nullptr, nullptr );
   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 );
}

J#

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        // 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.set_Encoding("UTF-8");
        xmlDecl.set_Standalone("yes");

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

        // Display the modified XML document 
        Console.WriteLine(doc.get_OuterXml());
    } //main
} //Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlDeclaration クラス
XmlDeclaration メンバ
System.Xml 名前空間