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，允许你使用多个写入方法（例如WriteStringWriteQualifiedName，等等）编写属性值。

有关此方法的异步版本，请参阅 WriteStartAttributeAsync。

另请参阅

适用于