XmlWriter.WriteStartAttribute Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- XmlWriter.cs
- 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);public abstract void WriteStartAttribute (string? prefix, string localName, string? ns);abstract member WriteStartAttribute : string * string * string -> unitPublic 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 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.
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.
Aplica-se a
WriteStartAttribute(String)
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- 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 -> unitPublic Sub WriteStartAttribute (localName As String)Parâmetros
- localName
- String
O nome local do atributo.
Exceções
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”.
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.
Aplica-se a
WriteStartAttribute(String, String)
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- 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);public void WriteStartAttribute (string localName, string? ns);member this.WriteStartAttribute : string * string -> unitPublic 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
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.
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.
