XmlWriter.WriteStartAttribute メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

派生クラスでオーバーライドされると、属性の開始を書き込みます。

オーバーロード

WriteStartAttribute(String, String, String)	派生クラスでオーバーライドされると、指定されたプリフィックス、ローカル名、および名前空間 URI を使用して属性の開始を書き込みます。
WriteStartAttribute(String)	指定されたローカル名を使用して属性の開始を書き込みます。
WriteStartAttribute(String, String)	指定されたローカル名および名前空間 URI を使用して属性の開始を書き込みます。

注釈

このメソッドの非同期バージョンについては、次を参照してください WriteStartAttributeAsync。

WriteStartAttribute(String, String, String)

派生クラスでオーバーライドされると、指定されたプリフィックス、ローカル名、および名前空間 URI を使用して属性の開始を書き込みます。

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartAttribute (string prefix, string localName, string ns);

public abstract void WriteStartAttribute (string? prefix, string localName, string? ns);

abstract member WriteStartAttribute : string * string * string -> unit

Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)

パラメーター

prefix

String

属性の名前空間プレフィックス。

localName

String

属性のローカル名。

ns

String

属性の名前空間 URI。

例外

EncoderFallbackException

有効な XML 文字であるが出力エンコーディングには有効でない文字がバッファー内にあります。 たとえば、出力エンコーディングが ASCII の場合、要素名と属性名には 0 ～ 127 の範囲の文字だけを使用する必要があります。 無効な文字は、このメソッドの引数か、バッファーに書き込んでいた以前のメソッドの引数に含まれている可能性があります。 このような文字は、可能であれば文字エンティティ参照によってエスケープされます (たとえば、テキスト ノード内や属性値内で)。 ただし、文字エンティティの参照は、要素名と属性名、コメント、処理命令、または CDATA セクションでは使用できません。

InvalidOperationException

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

このメソッドを使用すると、複数の Write メソッドを使用して値を書き込めます。

このメソッドの非同期バージョンについては、次を参照してください WriteStartAttributeAsync。

WriteStartAttribute(String)

指定されたローカル名を使用して属性の開始を書き込みます。

public:
 void WriteStartAttribute(System::String ^ localName);

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

パラメーター

localName

String

属性のローカル名。

例外

InvalidOperationException

ライターが閉じています。

• または -

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

EncoderFallbackException

有効な XML 文字であるが出力エンコーディングには有効でない文字がバッファー内にあります。 たとえば、出力エンコーディングが ASCII の場合、要素名と属性名には 0 ～ 127 の範囲の文字だけを使用する必要があります。 無効な文字は、このメソッドの引数か、バッファーに書き込んでいた以前のメソッドの引数に含まれている可能性があります。 このような文字は、可能であれば文字エンティティ参照によってエスケープされます (たとえば、テキスト ノード内や属性値内で)。 ただし、文字エンティティの参照は、要素名と属性名、コメント、処理命令、または CDATA セクションでは使用できません。

注釈

このメソッドを使用すると、複数の Write メソッドを使用して値を書き込めます。

このメソッドの非同期バージョンについては、次を参照してください WriteStartAttributeAsync。

WriteStartAttribute(String, String)

指定されたローカル名および名前空間 URI を使用して属性の開始を書き込みます。

public:
 void WriteStartAttribute(System::String ^ localName, System::String ^ ns);

public void WriteStartAttribute (string localName, string ns);

public void WriteStartAttribute (string localName, string? ns);

member this.WriteStartAttribute : string * string -> unit

Public Sub WriteStartAttribute (localName As String, ns As String)

パラメーター

localName

String

属性のローカル名。

ns

String

属性の名前空間 URI。

例外

EncoderFallbackException

有効な XML 文字であるが出力エンコーディングには有効でない文字がバッファー内にあります。 たとえば、出力エンコーディングが ASCII の場合、要素名と属性名には 0 ～ 127 の範囲の文字だけを使用する必要があります。 無効な文字は、このメソッドの引数か、バッファーに書き込んでいた以前のメソッドの引数に含まれている可能性があります。 このような文字は、可能であれば文字エンティティ参照によってエスケープされます (たとえば、テキスト ノード内や属性値内で)。 ただし、文字エンティティの参照は、要素名と属性名、コメント、処理命令、または CDATA セクションでは使用できません。

InvalidOperationException

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

例

このメソッドの使用例を参照してください XmlTextWriter.WriteStartAttribute 。

注釈

これは、複数の書き込みメソッドを使用して属性値を書き込むための WriteAttributeString より高度なバージョンです(例: WriteStringなど WriteQualifiedName)。

このメソッドの非同期バージョンについては、次を参照してください WriteStartAttributeAsync。

こちらもご覧ください

• WriteEndAttribute()