XmlWriter.WriteStartAttribute Método

Definição

Quando substituído em uma classe derivada, grava o início de um atributo.When overridden in a derived class, writes the start of an attribute.

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.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttribute(String)

Grava o início de um atributo com o nome do local especificado.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Grava o início de um atributo com o nome do local e o URI de namespace especificados.Writes the start of an attribute with the specified local name and namespace URI.

Comentários

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

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.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace 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)

Parâmetros

prefix
String

O prefixo do namespace do atributo.The namespace prefix of the attribute.

localName
String

O nome local do atributo.The local name of the attribute.

ns
String

O URI do namespace para o atributo.The namespace URI for the attribute.

Exceções

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 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.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the 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).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 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.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Esse método permite que você grave um valor usando vários métodos de gravação.This method enables you to write a value using multiple Write methods.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

Aplica-se a

WriteStartAttribute(String)

Grava o início de um atributo com o nome do local especificado.Writes the start of an attribute with the specified local name.

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.The local name of the attribute.

Exceções

O gravador está fechado.The writer is closed.

- ou --or-

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 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.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the 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).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 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.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Comentários

Esse método permite que você grave um valor usando vários métodos de gravação.This method enables you to write a value using multiple Write methods.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

Aplica-se a

WriteStartAttribute(String, String)

Grava o início de um atributo com o nome do local e o URI de namespace especificados.Writes the start of an attribute with the specified local name and namespace 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)

Parâmetros

localName
String

O nome local do atributo.The local name of the attribute.

ns
String

O URI do namespace do atributo.The namespace URI of the attribute.

Exceções

Há um caractere no buffer que é um caractere XML válido, mas que não é válido para a codificação de saída.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 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.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. O caractere inválido pode estar no argumento do método ou em um argumento dos métodos anteriores que foram gravados no buffer.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the 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).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 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.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemplos

Consulte XmlTextWriter.WriteStartAttribute para obter um exemplo usando esse método.See XmlTextWriter.WriteStartAttribute for an example using this method.

Comentários

Essa é uma versão mais avançada do WriteAttributeString que permite escrever um valor de atributo usando vários métodos de gravação, como WriteString , WriteQualifiedName e assim por diante.This is a more advanced version of WriteAttributeString that allows you to write an attribute value using multiple write methods, such as WriteString, WriteQualifiedName, and so on.

Para obter a versão assíncrona desse método, consulte WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

Confira também

Aplica-se a