注釈

を使用してXmlWriterCreate作成されたの既定のArgumentException動作では、0x-0x1f (空白文字0x9、0xa、0xd を除く) で文字値を書き込もうとすると、がスローされます。The default behavior of an XmlWriter created using Create is to throw an ArgumentException when attempting to write character values in the range 0x-0x1F (excluding white space characters 0x9, 0xA, and 0xD).これらの無効な XML 文字は、 XmlWriterプロパティがCheckCharactersにfalse設定されたを作成することによって記述できます。These invalid XML characters can be written by creating the XmlWriter with the CheckCharacters property set to false.このようにすると、文字が数字エンティティ (&#0; から & #0x1F) に置換されます。Doing so will result in the characters being replaced with numeric character entities (&#0; through &#0x1F).また、既定XmlTextWriterでは、 new演算子を使用して作成されたによって、無効な文字が数値文字エンティティに置き換えられます。Additionally, an XmlTextWriter created with the new operator will replace the invalid characters with numeric character entities by default.

メモXML を使用する多くのアプリケーションは無効な文字を処理するように設計されていないため、Microsoft では無効な XML 文字を記述することを推奨していません。Note Microsoft does not encourage the practice of writing invalid XML characters since many applications that consume XML are not designed to handle invalid characters.

属性WriteString値のコンテキストでが呼び出された場合、二重引用符と単一引用符はそれぞれ&quot;と&apos;に置き換えられます。If WriteString is called in the context of an attribute value, double and single quotes are replaced with &quot; and &apos; respectively.

たとえば、次の入力文字列test<item>testはとして書き込まれます。For example, this input string test<item>test is written out as

test&lt;item&gt;test

がtextまたはnull のいずれかの場合、このメソッドはデータコンテンツのないテキストノードを書き込みます。String.EmptyIf text is either null or String.Empty, this method writes a text node with no data content.