XmlWriterSettings.ConformanceLevel プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlWriterSettings.ConformanceLevel プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

XmlWriter が従う準拠のレベルを取得または設定します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property ConformanceLevel As
 ConformanceLevel

Visual Basic (使用法)

Dim instance As XmlWriterSettings
Dim value As ConformanceLevel

value = instance.ConformanceLevel

instance.ConformanceLevel = value

public ConformanceLevel ConformanceLevel { get;
 set; }

C++

public:
property ConformanceLevel ConformanceLevel {
    ConformanceLevel get ();
    void set (ConformanceLevel value);
}

/** @property */
public ConformanceLevel get_ConformanceLevel ()

/** @property */
public void set_ConformanceLevel (ConformanceLevel
 value)

JScript

public function get ConformanceLevel
 () : ConformanceLevel

public function set ConformanceLevel
 (value : ConformanceLevel)

プロパティ値
ConformanceLevel 値の 1 つ。既定値は ConformanceLevel.Document です。

解説

ライタは、指定された準拠のレベルに違反する情報アイテムを検出すると、例外をスローします。場合によっては、ライタが準拠エラーを自動的に修正します。たとえば、ライタは例外をスローすることなく、閉じられていない属性を閉じます。

詳細については、「データの一致と XmlWriter」を参照してください。

使用例

XML フラグメントをメモリストリームに書き込む例を次に示します。

Visual Basic

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.

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.