System::Xml::XmlDocument::CreateXmlDeclaration メソッド

XmlDocument::CreateXmlDeclaration method

指定された値を持つ XmlDeclaration ノードを作成します。

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
パラメーター説明
バージョンconst String&バージョンは “1.0” である必要があります。
encodingconst String&エンコーディング属性の値。このエンコーディングは、XmlDocument をファイルまたはストリームに保存する際に使用されます。そのため、Text::Encoding クラスでサポートされている文字列に設定する必要があり、そうでない場合は “XmlDocument::Save(String)” が失敗します。これが nullptr または String::Empty の場合、XmlDocument::Save メソッドは XML 宣言にエンコーディング属性を書き込まず、デフォルトのエンコーディングである UTF-8 が使用されます。
standaloneconst String&値は “yes” または “no” のいずれかである必要があります。これが nullptr または String::Empty の場合、XmlDocument::Save メソッドは XML 宣言に standalone 属性を書き込みません。

ReturnValue

新しい XmlDeclaration ノード。

備考

注意: XmlDocument が TextWriter または XmlTextWriter のいずれかに保存される場合、このエンコーディング値は破棄されます。その代わりに、TextWriter または XmlTextWriter のエンコーディングが使用されます。これにより、書き出された XML を正しいエンコーディングで再度読み取ることができます。

参照