指定したストリームに XML ドキュメントを保存します。
Overloads Public Overridable Sub Save( _
ByVal outStream As Stream _)
[C#]
public virtual void Save(StreamoutStream);
[C++]
public: virtual void Save(Stream* outStream);
[JScript]
public function Save(
outStream : Stream);
パラメータ
- outStream
保存先のストリーム。
例外
例外の種類 | 条件 |
---|---|
XmlException | 操作の結果、整形式の XML ドキュメントにならない場合があります (ドキュメント要素がない、XML 宣言の重複など)。 |
解説
空白は PreserveWhitespace が true に設定されている場合だけ保存されます。
保存されたドキュメントのエンコーディング属性は、現在の XmlDocument オブジェクトの XmlDeclaration によって決定されます。エンコーディング属性の値は、 XmlDeclaration.Encoding プロパティから取得されます。 XmlDocument に XmlDeclaration がない場合、または XmlDeclaration にエンコーディング属性がない場合、保存されたドキュメントにエンコーディング属性は設定されません。
ドキュメントが保存されるときに、xmlns 属性が生成され、ノード ID (ローカル名 + 名前空間 URI) を正確に永続化します。たとえば、次に示す C# コードは、
XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);
xmls 属性 <item xmls="urn:1"/>
を生成します。
このメソッドは、ドキュメント オブジェクト モデル (DOM: Document Object Model) に対する Microsoft 拡張機能です。
必要条件
プラットフォーム: 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
参照
XmlDocument クラス | XmlDocument メンバ | System.Xml 名前空間 | XmlDocument.Save オーバーロードの一覧