XmlWriter.WriteStartAttribute Método

Definição

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

Sobrecargas

Nome Description
WriteStartAttribute(String, String, String)

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

WriteStartAttribute(String)

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

WriteStartAttribute(String, String)

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

Comentários

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

WriteStartAttribute(String, String, String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

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

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)

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

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

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada 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 de gravação.

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

Aplica-se a

WriteStartAttribute(String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

Grava o início de um atributo com o nome 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

O gravador está fechado.

- ou -

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

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

Comentários

Esse método permite que você escreva um valor usando vários métodos de gravação.

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

Aplica-se a

WriteStartAttribute(String, String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

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

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)

Parâmetros

localName
String

O nome local do atributo .

ns
String

O URI do espaço de nomes do atributo.

Exceções

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

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

Exemplos

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

Comentários

Essa é uma versão mais avançada 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 deste método, consulte WriteStartAttributeAsync.

Confira também

Aplica-se a