XmlWriterSettings.OmitXmlDeclaration プロパティ

定義

XML 宣言を省略するかどうかを示す値を取得または設定します。

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

プロパティ値

XML 宣言を省略する場合は true、それ以外の場合は false。 既定値は false で、XML 宣言が書き込まれます。

次の例では、XML フラグメントをメモリ ストリームに書き込みます。

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");
writer.Flush();
writer.Close();

// Do additional 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")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

注釈

このプロパティは、テキスト コンテンツを XmlWriter 出力するインスタンスにのみ適用されます。それ以外の場合、この設定は無視されます。

が にfalse設定されている場合OmitXmlDeclaration、XML 宣言は自動的に書き込まれます

が に設定されている場合 ConformanceLevel は、 が に Document設定されていても OmitXmlDeclaration 、XML 宣言は常に true書き込まれます。

が にFragment設定されている場合ConformanceLevel、XML 宣言は書き込まれることはありません。 を呼び出 WriteProcessingInstruction して、XML 宣言を明示的に書き出すことができます。

適用対象