XmlTextWriter XmlTextWriter XmlTextWriter XmlTextWriter Class

定義

W3C 勧告『Extensible Markup Language (XML) 1.0』および勧告『Namespaces in XML』に準拠する XML データを格納するストリームまたはファイルを高速に、非キャッシュで、前方向に生成する方法を提供するライターを表します。Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations.

.NET Framework 2.0 以降では、代わりに XmlWriter クラスを使用することをお勧めします。Starting with the .NET Framework 2.0, we recommend that you use the XmlWriter class instead.

public ref class XmlTextWriter : System::Xml::XmlWriter
public class XmlTextWriter : System.Xml.XmlWriter
type XmlTextWriter = class
    inherit XmlWriter
Public Class XmlTextWriter
Inherits XmlWriter
継承
XmlTextWriterXmlTextWriterXmlTextWriterXmlTextWriter

注釈

このクラスは、 XmlWriterクラスを実装します。This class implements the XmlWriter class.

注意

.NET Framework 2.0 以降では、新しい機能を利用するXmlWriterために、 XmlWriter.CreateメソッドとXmlWriterSettingsクラスを使用してインスタンスを作成することをお勧めします。Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

XmlTextWriter現在の要素スタックで定義されているすべての名前空間に対応する名前空間スタックを保持します。XmlTextWriter maintains a namespace stack corresponding to all the namespaces defined in the current element stack. XmlTextWriter使用すると、手動で名前空間を宣言できます。Using XmlTextWriter you can declare namespaces manually.

w.WriteStartElement("root");  
w.WriteAttributeString("xmlns", "x", null, "urn:1");  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  

上記の C# コードでは、次の出力が生成されます。The above C# code produces the following output. XmlTextWriter2つの子要素の間で重複しないように、名前空間の宣言をルート要素に昇格させます。XmlTextWriter promotes the namespace declaration to the root element to avoid having it duplicated on the two child elements. 子要素は、名前空間宣言からプレフィックスを取得します。The child elements pick up the prefix from the namespace declaration.

<root xmlns:x="urn:1">  
 <x:item/>  
 <x:item/>  
</x:root>  

XmlTextWriterでは、現在の名前空間宣言をオーバーライドすることもできます。XmlTextWriter also allows you to override the current namespace declaration. 次の例では、XML 要素<x:node xmlns:x="abc"/>を生成するために、名前空間 URI "123" が "abc" によってオーバーライドされています。In the following example, the namespace URI "123" is overridden by "abc" to produce the XML element <x:node xmlns:x="abc"/>.

w.WriteStartElement("x","node","123");  
w.WriteAttributeString("xmlns","x",null,"abc");  

プレフィックスを引数として受け取る write メソッドを使用して、使用するプレフィックスを指定することもできます。By using the write methods that take a prefix as an argument you can also specify which prefix to use. 次の例では、XML テキスト<x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>を生成するために、2つの異なるプレフィックスが同じ名前空間 URI にマップされています。In the following example, two different prefixes are mapped to the same namespace URI to produce the XML text <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.WriteStartElement("x","root","urn:1");  
 w.WriteStartElement("y","item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

異なるプレフィックスを同じ名前空間 URI にマッピングする複数の名前空間宣言XmlTextWriterがある場合、は、名前空間宣言のスタックを後方にウォークし、最も近いものを選択します。If there are multiple namespace declarations mapping different prefixes to the same namespace URI, XmlTextWriter walks the stack of namespace declarations backwards and picks the closest one.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.Formatting = Formatting.Indented;  
w.WriteStartElement("x","root","urn:1");  
w.WriteStartElement("y","item","urn:1");  
w.WriteAttributeString("attr","urn:1","123");  
w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

上記の C# 例であるため、WriteAttributeString呼び出しは、プレフィックスを指定しない場合、ライターの名前空間スタックにプッシュされた最後のプレフィックスを使用して、次の XML が生成されます。In the above C# example, because the WriteAttributeString call does not specify a prefix, the writer uses the last prefix pushed onto the namespace stack, and produces the following XML:

<x:root xmlns:x="urn:1">  
 <y:item y:attr="123" xmlns:y="urn:1" />  
</x:root>  

名前空間の競合がXmlTextWriter発生した場合、は代替プレフィックスを生成してそれらを解決します。If namespace conflicts occur, XmlTextWriter resolves them by generating alternate prefixes. たとえば、属性と要素のプレフィックスが同じで名前空間が異なる場合、 XmlWriterによって属性の代替プレフィックスが生成されます。For example, if an attribute and element have the same prefix but different namespaces, XmlWriter generates an alternate prefix for the attribute. 生成されたプレフィックスn{i}iはという名前が付けられます。ここで、は1から始まる数値です。The generated prefixes are named n{i} where i is a number beginning at 1. 要素ごとに、数値が1にリセットされます。The number is reset to 1 for each element.

名前空間 URI に関連付けられている属性にはプレフィックスが必要です (既定の名前空間は属性には適用されません)。Attributes which are associated with a namespace URI must have a prefix (default namespaces do not apply to attributes). これは、XML 勧告の W3C 名前空間のセクション5.2 に準拠しています。This conforms to section 5.2 of the W3C Namespaces in XML recommendation. 属性が名前空間 URI を参照していても、プレフィックスが指定されていない場合、ライターはその属性のプレフィックスを生成します。If an attribute references a namespace URI, but does not specify a prefix, the writer generates a prefix for the attribute.

空の要素を書き込むと、タグ名と終了タグの間に追加のスペースが追加さ<item />れます。たとえば、のようになります。When writing an empty element, an additional space is added between tag name and the closing tag, for example <item />. これにより、古いブラウザーとの互換性が提供されます。This provides compatibility with older browsers.

がメソッドパラメーターとして使用さnullれるString.Empty場合、とは等価です。 StringWhen a String is used as method parameter, null and String.Empty are equivalent. String.EmptyW3C 規則に従います。String.Empty follows the W3C rules.

厳密に型指定されたデータXmlConvertを書き込むには、クラスを使用してデータ型を文字列に変換します。To write strongly typed data, use the XmlConvert class to convert data types to string. たとえば、次の C# コードはからデータを変換します。DoubleString要素を書き込み、<price>19.95</price>します。For example, the following C# code converts the data from Double to String and writes the element <price>19.95</price>.

Double price = 19.95;  
writer.WriteElementString("price", XmlConvert.ToString(price));  

XmlTextWriterでは、次のチェックは行われません。XmlTextWriter does not check for the following:

  • 属性名と要素名に無効な文字が含まれています。Invalid characters in attribute and element names.

  • 指定されたエンコードに合わない Unicode 文字。Unicode characters that do not fit the specified encoding. Unicode 文字が指定されたエンコードに合わない場合XmlTextWriter 、は unicode 文字を文字エンティティにエスケープしません。If the Unicode characters do not fit the specified encoding, the XmlTextWriter does not escape the Unicode characters into character entities.

  • 重複する属性。Duplicate attributes.

  • DOCTYPE のパブリック識別子またはシステム識別子の文字。Characters in the DOCTYPE public identifier or system identifier.

セキュリティの考慮事項Security Considerations

XmlTextWriterクラスを使用する場合は、次の点を考慮する必要があります。The following items are things to consider when working with the XmlTextWriter class.

  • によってスロー XmlTextWriterされた例外は、アプリケーションに通知しないパス情報を開示できます。Exceptions thrown by the XmlTextWriter can disclose path information that you do not want bubbled up to the application. アプリケーションは例外をキャッチし、それらを適切に処理する必要があります。Your applications must catch exceptions and process them appropriately.

  • XmlTextWriter を別のアプリケーションに渡すと、下位のストリームがそのアプリケーションに公開されます。When you pass the XmlTextWriter to another application the underlying stream is exposed to that application. XmlTextWriter を信頼度の低いアプリケーションに渡す必要がある場合は、代わりに XmlWriter メソッドによって作成される Create オブジェクトを使用する必要があります。If you need to pass the XmlTextWriter to a semi-trusted application, you should use an XmlWriter object created by the Create method instead.

  • は、メソッドWriteDocTypeまたはWriteRawメソッドに渡されるデータを検証しません。 XmlTextWriterThe XmlTextWriter does not validate any data that is passed to the WriteDocType or WriteRaw methods. これらのメソッドには、任意のデータを渡さないでください。You should not pass arbitrary data to these methods.

  • 既定の設定が変更された場合、生成された出力が整形式の XML データであることは保証されません。If the default settings are changed, there is no guarantee that the generated output is well-formed XML data.

  • 信頼できないソースからのEncodingオブジェクトなどのサポートコンポーネントは受け入れないでください。Do not accept supporting components, such as an Encoding object, from an untrusted source.

コンストラクター

XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding)

指定したストリームおよびエンコーディングを使用して、XmlTextWriter クラスのインスタンスを作成します。Creates an instance of the XmlTextWriter class using the specified stream and encoding.

XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding)

指定したファイルを使用して XmlTextWriter クラスのインスタンスを作成します。Creates an instance of the XmlTextWriter class using the specified file.

XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter)

指定した TextWriter を使用して XmlTextWriter クラスのインスタンスを作成します。Creates an instance of the XmlTextWriter class using the specified TextWriter.

プロパティ

BaseStream BaseStream BaseStream BaseStream

基になるストリーム オブジェクトを取得します。Gets the underlying stream object.

Formatting Formatting Formatting Formatting

出力の書式設定方法を示します。Indicates how the output is formatted.

Indentation Indentation Indentation Indentation

FormattingFormatting.Indented に設定するときに、階層構造のレベルごとに書き込む IndentChar の数を取得または設定します。Gets or sets how many IndentChars to write for each level in the hierarchy when Formatting is set to Formatting.Indented.

IndentChar IndentChar IndentChar IndentChar

FormattingFormatting.Indented に設定するときに、インデントに使用する文字を取得または設定します。Gets or sets which character to use for indenting when Formatting is set to Formatting.Indented.

Namespaces Namespaces Namespaces Namespaces

名前空間をサポートするかどうかを示す値を取得または設定します。Gets or sets a value indicating whether to do namespace support.

QuoteChar QuoteChar QuoteChar QuoteChar

属性値を囲む引用符に使用する文字を取得または設定します。Gets or sets which character to use to quote attribute values.

Settings Settings Settings Settings

この XmlWriter インスタンスを作成するために使用された XmlWriterSettings オブジェクトを取得します。Gets the XmlWriterSettings object used to create this XmlWriter instance.

(Inherited from XmlWriter)
WriteState WriteState WriteState WriteState

ライターの状態を取得します。Gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

現在の xml:lang スコープを取得します。Gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

現在の xml:space スコープを表す XmlSpace を取得します。Gets an XmlSpace representing the current xml:space scope.

メソッド

Close() Close() Close() Close()

このストリームおよび基になるストリームを閉じます。Closes this stream and the underlying stream.

Dispose() Dispose() Dispose() Dispose()

XmlWriter クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。Releases all resources used by the current instance of the XmlWriter class.

(Inherited from XmlWriter)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

XmlWriter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

(Inherited from XmlWriter)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

バッファー内のデータをすべて基になるストリームにフラッシュし、基になるストリームもフラッシュします。Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

バッファー内のデータをすべて基になるストリームに非同期にフラッシュし、基になるストリームもフラッシュします。Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

(Inherited from XmlWriter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) LookupPrefix(String)

名前空間 URI の現在の名前空間スコープで定義されたものに最も近いプリフィックスを返します。Returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean)

派生クラスでオーバーライドされると、XmlReader の現在の位置で見つかったすべての属性を書き込みます。When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

(Inherited from XmlWriter)
WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean)

XmlReader の現在の位置で見つかったすべての属性を非同期に書き込みます。Asynchronously writes out all the attributes found at the current position in the XmlReader.

(Inherited from XmlWriter)
WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

派生クラスでオーバーライドされると、指定したローカル名と値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified local name and value.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

派生クラスでオーバーライドされると、指定したローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

派生クラスでオーバーライドされると、指定したプリフィックス、ローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String)

指定されたプレフィックス、ローカル名、名前空間 URI、および値を使用して属性を非同期に書き込みます。Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

指定したバイナリ バイトを base64 としてエンコードし、その結果生成されるテキストを書き込みます。Encodes the specified binary bytes as base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32)

指定したバイナリ バイトを base64 として非同期にエンコードし、その結果生成されるテキストを書き込みます。Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

(Inherited from XmlWriter)
WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

指定したバイナリ バイトを binhex としてエンコードし、その結果生成されるテキストを書き込みます。Encodes the specified binary bytes as binhex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32)

指定したバイナリ バイトを BinHex として非同期にエンコードし、その結果生成されるテキストを書き込みます。Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

(Inherited from XmlWriter)
WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

指定したテキストを格納する <![CDATA[...]]> ブロックを書き込みます。Writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String)

指定したテキストを格納する <![CDATA[...]]> ブロックを非同期に書き込みます。Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

(Inherited from XmlWriter)
WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

指定した Unicode 文字値の文字エンティティを強制的に生成します。Forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char)

指定した Unicode 文字値の文字エンティティを非同期に強制的に生成します。Asynchronously forces the generation of a character entity for the specified Unicode character value.

(Inherited from XmlWriter)
WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

一度に 1 つのバッファーにテキストを書き込みます。Writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32)

一度に 1 つのバッファーにテキストを非同期に書き込みます。Asynchronously writes text one buffer at a time.

(Inherited from XmlWriter)
WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

指定したテキストを格納するコメント <!--...--> を書き込みます。Writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String)

指定したテキストを含むコメント <!--...--> を非同期に書き込みます。Asynchronously writes out a comment <!--...--> containing the specified text.

(Inherited from XmlWriter)
WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String)

名前とオプション属性を指定して、DOCTYPE 宣言を書き込みます。Writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String)

指定された名前とオプション属性を使用して DOC 宣言を非同期に書き込みます。Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

(Inherited from XmlWriter)
WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String)

指定されたローカル名および値を使用して要素を書き込みます。Writes an element with the specified local name and value.

(Inherited from XmlWriter)
WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String)

指定されたローカル名、名前空間 URI、および値を使用して要素を書き込みます。Writes an element with the specified local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String)

指定されたプレフィックス、ローカル名、名前空間 URI、および値を使用して要素を書き込みます。Writes an element with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String)

指定されたプレフィックス、ローカル名、名前空間 URI、および値を使用して要素を非同期に書き込みます。Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

(Inherited from XmlWriter)
WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

前の WriteStartAttribute(String, String, String) 呼び出しを閉じます。Closes the previous WriteStartAttribute(String, String, String) call.

WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync()

前の WriteStartAttribute(String, String) 呼び出しを非同期に閉じます。Asynchronously closes the previous WriteStartAttribute(String, String) call.

(Inherited from XmlWriter)
WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

開いている要素または属性を閉じ、ライターを Start 状態に戻します。Closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync()

開いている要素または属性を非同期に閉じ、ライターを Start 状態に戻します。Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

(Inherited from XmlWriter)
WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

1 つの要素を閉じ、対応する名前空間スコープをポップします。Closes one element and pops the corresponding namespace scope.

WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync()

1 つの要素を非同期に閉じ、対応する名前空間スコープをポップします。Asynchronously closes one element and pops the corresponding namespace scope.

(Inherited from XmlWriter)
WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

&name; のようにエンティティ参照を書き込みます。Writes out an entity reference as &name;.

WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String)

エンティティ参照を &name; として非同期的に書き込みます。Asynchronously writes out an entity reference as &name;.

(Inherited from XmlWriter)
WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

1 つの要素を閉じ、対応する名前空間スコープをポップします。Closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync()

1 つの要素を非同期に閉じ、対応する名前空間スコープをポップします。Asynchronously closes one element and pops the corresponding namespace scope.

(Inherited from XmlWriter)
WriteName(String) WriteName(String) WriteName(String) WriteName(String)

指定した名前が W3C 勧告『XML 1.0』に準拠した有効な名前であることを確認して、それを書き込みます。Writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation.

WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String)

指定した名前が W3C 勧告『XML 1.0』(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)) に準拠した有効な名前であることを確認し、それを非同期に書き込みます。Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

(Inherited from XmlWriter)
WriteNmToken(String) WriteNmToken(String) WriteNmToken(String) WriteNmToken(String)

指定した名前が W3C 勧告『XML 1.0』に準拠した有効な NmToken であることを確認して、それを書き込みます。Writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation.

WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String)

指定した名前が W3C 勧告『XML 1.0』(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)) に準拠した有効な NmToken であることを確認し、それを非同期に書き込みます。Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

(Inherited from XmlWriter)
WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean)

派生クラスでオーバーライドされると、リーダーのデータをすべてライターにコピーし、リーダーを次の兄弟の開始位置に移動します。When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

(Inherited from XmlWriter)
WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean)

XPathNavigator オブジェクトからライターにすべてをコピーします。Copies everything from the XPathNavigator object to the writer. XPathNavigator の位置は変更されません。The position of the XPathNavigator remains unchanged.

(Inherited from XmlWriter)
WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean)

派生クラスでオーバーライドされると、リーダーのデータをすべてライターに非同期にコピーし、リーダーを次の兄弟の開始位置に移動します。Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

(Inherited from XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean)

XPathNavigator オブジェクトのすべてをライターに非同期にコピーします。Asynchronously copies everything from the XPathNavigator object to the writer. XPathNavigator の位置は変更されません。The position of the XPathNavigator remains unchanged.

(Inherited from XmlWriter)
WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String)

名前とテキストの間にスペースがある処理命令を、次のように書き込みます: <?name text?>。Writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String)

名前とテキストの間にスペースがある処理命令を、次のように非同期的に書き込みます: <?name text?>。Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

(Inherited from XmlWriter)
WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

名前空間の修飾名を書き込みます。Writes out the namespace-qualified name. このメソッドは、指定した名前空間のスコープ内にあるプレフィックスを検索します。This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String)

名前空間の修飾名を非同期に書き込みます。Asynchronously writes out the namespace-qualified name. このメソッドは、指定した名前空間のスコープ内にあるプレフィックスを検索します。This method looks up the prefix that is in scope for the given namespace.

(Inherited from XmlWriter)
WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

文字バッファーから手動で生のマークアップを書き込みます。Writes raw markup manually from a character buffer.

WriteRaw(String) WriteRaw(String) WriteRaw(String) WriteRaw(String)

文字列から手動で生のマークアップを書き込みます。Writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32)

文字バッファーから手動で生のマークアップを非同期に書き込みます。Asynchronously writes raw markup manually from a character buffer.

(Inherited from XmlWriter)
WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String)

文字列から手動で生のマークアップを非同期に書き込みます。Asynchronously writes raw markup manually from a string.

(Inherited from XmlWriter)
WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

指定されたローカル名を使用して属性の開始を書き込みます。Writes the start of an attribute with the specified local name.

(Inherited from XmlWriter)
WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

指定されたローカル名および名前空間 URI を使用して属性の開始を書き込みます。Writes the start of an attribute with the specified local name and namespace URI.

(Inherited from XmlWriter)
WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

属性の開始を書き込みます。Writes the start of an attribute.

WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String)

指定されたプレフィックス、ローカル名、および名前空間 URI を使用して属性の開始を非同期に書き込みます。Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

(Inherited from XmlWriter)
WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

バージョン "1.0" で XML 宣言を書き込みます。Writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

バージョン "1.0" とスタントアロン属性を使用して XML 宣言を書き込みます。Writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync()

バージョン "1.0" で XML 宣言を非同期に書き込みます。Asynchronously writes the XML declaration with the version "1.0".

(Inherited from XmlWriter)
WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean)

バージョン "1.0" とスタントアロン属性を使用して XML 宣言を非同期に書き込みます。Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

(Inherited from XmlWriter)
WriteStartElement(String) WriteStartElement(String) WriteStartElement(String) WriteStartElement(String)

派生クラスでオーバーライドされると、指定したローカル名の開始タグを書き込みます。When overridden in a derived class, writes out a start tag with the specified local name.

(Inherited from XmlWriter)
WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String)

派生クラスでオーバーライドされると、指定した開始タグを書き込み、指定した名前空間に関連付けます。When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

(Inherited from XmlWriter)
WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String)

指定した開始タグを書き込み、指定した名前空間とプレフィックスに関連付けます。Writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String)

指定した開始タグを非同期に書き込み、指定した名前空間とプレフィックスに関連付けます。Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

(Inherited from XmlWriter)
WriteString(String) WriteString(String) WriteString(String) WriteString(String)

指定したテキストの内容を書き込みます。Writes the given text content.

WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String)

指定したテキストの内容を非同期に書き込みます。Asynchronously writes the given text content.

(Inherited from XmlWriter)
WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。Generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char)

サロゲート文字ペアのサロゲート文字エンティティを非同期に生成して書き込みます。Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

(Inherited from XmlWriter)
WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Boolean 値を書き込みます。Writes a Boolean value.

(Inherited from XmlWriter)
WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

DateTime 値を書き込みます。Writes a DateTime value.

(Inherited from XmlWriter)
WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

DateTimeOffset 値を書き込みます。Writes a DateTimeOffset value.

(Inherited from XmlWriter)
WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Decimal 値を書き込みます。Writes a Decimal value.

(Inherited from XmlWriter)
WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Double 値を書き込みます。Writes a Double value.

(Inherited from XmlWriter)
WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Int32 値を書き込みます。Writes a Int32 value.

(Inherited from XmlWriter)
WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Int64 値を書き込みます。Writes a Int64 value.

(Inherited from XmlWriter)
WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

オブジェクト値を書き込みます。Writes the object value.

(Inherited from XmlWriter)
WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

単精度浮動小数点数を書き込みます。Writes a single-precision floating-point number.

(Inherited from XmlWriter)
WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

String 値を書き込みます。Writes a String value.

(Inherited from XmlWriter)
WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

指定した空白を書き込みます。Writes out the given white space.

WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String)

指定した空白を非同期に書き込みます。Asynchronously writes out the given white space.

(Inherited from XmlWriter)

明示的なインターフェイスの実装

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

このメンバーの詳細については、「Dispose()」をご覧ください。For a description of this member, see Dispose().

(Inherited from XmlWriter)

適用対象

こちらもご覧ください