XmlWriter.WriteStartAttribute Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quando substituído em uma classe derivada, grava o início de um atributo.

Sobrecargas

WriteStartAttribute(String, String, String)	Quando substituído em uma classe derivada, grava o início de um atributo com o prefixo especificado, o nome local e o URI de namespace.
WriteStartAttribute(String)	Grava o início de um atributo com o nome do local especificado.
WriteStartAttribute(String, String)	Grava o início de um atributo com o nome do local e o URI de namespace especificados.

Comentários

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Origem:

XmlWriter.cs

Quando substituído em uma classe derivada, grava o início de um atributo com o prefixo especificado, o nome local e o URI de namespace.

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::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)

Parâmetros

prefix

String

O prefixo do namespace do atributo.

localName

String

O nome local do atributo.

ns

String

O URI do namespace para o atributo.

Exceções

EncoderFallbackException

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, use apenas caracteres no intervalo de 0 a 127 para nomes de elemento e de atributo. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer. Esses caracteres são substituídos por referências de entidade de caracteres de escape quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caracteres não é permitida em nomes de elemento e de atributo, comentários, instruções de processamento ou seções de CDATA.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Esse método permite que você escreva um valor usando vários métodos write.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync.

WriteStartAttribute(String)

Origem:

XmlWriter.cs

Grava o início de um atributo com o nome do local especificado.

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

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parâmetros

localName

String

O nome local do atributo.

Exceções

InvalidOperationException

O gravador está fechado.

- ou -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

EncoderFallbackException

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, use apenas caracteres no intervalo de 0 a 127 para nomes de elemento e de atributo. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer. Esses caracteres são substituídos por referências de entidade de caracteres de escape quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caracteres não é permitida em nomes de elemento e de atributo, comentários, instruções de processamento ou seções de CDATA.

Comentários

Esse método permite que você escreva um valor usando vários métodos write.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync.

WriteStartAttribute(String, String)

Origem:

XmlWriter.cs

Grava o início de um atributo com o nome do local e o URI de namespace especificados.

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

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

member this.WriteStartAttribute : string * string -> unit

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

Parâmetros

localName

String

O nome local do atributo.

ns

String

O URI do namespace do atributo.

Exceções

EncoderFallbackException

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, use apenas caracteres no intervalo de 0 a 127 para nomes de elemento e de atributo. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer. Esses caracteres são substituídos por referências de entidade de caracteres de escape quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caracteres não é permitida em nomes de elemento e de atributo, comentários, instruções de processamento ou seções de CDATA.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

Consulte XmlTextWriter.WriteStartAttribute para obter um exemplo usando esse método.

Comentários

Essa é uma versão mais avançada do que permite que você escreva um valor de WriteAttributeString atributo usando vários métodos de gravação, como WriteString, WriteQualifiedNamee assim por diante.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync.

Confira também

• WriteEndAttribute()