XmlWriterSettings.CloseOutput プロパティ


XmlWriter メソッドを呼び出したときに、TextWriter が、基になるストリームまたは Close() も閉じる必要があるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the XmlWriter should also close the underlying stream or TextWriter when the Close() method is called.

 property bool CloseOutput { bool get(); void set(bool value); };
public bool CloseOutput { get; set; }
member this.CloseOutput : bool with get, set
Public Property CloseOutput As Boolean


基になるストリームまたは TextWriter も閉じる場合は true、それ以外の場合は falsetrue to also close the underlying stream or TextWriter; otherwise, false. 既定値は、false です。The default is false.

次の例では、XML フラグメントをメモリストリームに書き込みます。The following example writes an XML fragment to a memory stream.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");

// Do additonal processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")

' Do additonal processing on the stream.


この設定は、XML をストリームに書き込み、のXmlWriter書き込みが完了した後にストリームの末尾に追加情報を追加する場合に便利です。This setting is useful when you wish to write XML to a stream, and then add extra information to the end of the stream after the XmlWriter has finished writing.

このプロパティは、XML XmlWriterコンテンツをTextWriterストリームに出力するインスタンスにのみ適用されます。それ以外の場合、この設定は無視されます。This property only applies to XmlWriter instances that output XML content to a stream or TextWriter; otherwise, this setting is ignored.