XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration XmlWriterSettings.OmitXmlDeclaration Property

定義

XML 宣言を省略するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether to omit an XML declaration.

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、それ以外の場合は falsetrue to omit the XML declaration; otherwise, false. 既定値は false で、XML 宣言が書き込まれます。The default is false, an XML declaration is written.

次の例では、メモリ ストリームを 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");
writer.Flush();
writer.Close();

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

' Do additonal processing on the stream.

注釈

このプロパティはXmlWriterインスタンスのテキストの内容を出力する。 それ以外の場合、この設定は無視されます。This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored.

場合OmitXmlDeclarationに設定されているfalse、XML 宣言が自動的に書き込まれますIf OmitXmlDeclaration is set to false, The XML declaration is written automatically

場合、XML 宣言が常に書き込まれるConformanceLevelに設定されているDocument場合でも、OmitXmlDeclarationに設定されているtrueします。The XML declaration is always written if ConformanceLevel is set to Document, even if OmitXmlDeclaration is set to true.

場合、XML 宣言が書き込まれていないConformanceLevelに設定されているFragmentします。The XML declaration is never written if ConformanceLevel is set to Fragment. 呼び出すことができますWriteProcessingInstructionXML 宣言を明示的に記述します。You can call WriteProcessingInstruction to explicitly write out an XML declaration.

適用対象