XmlWriter.WriteStartAttribute Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando sobrescrito numa classe derivada, escreve o início de um atributo.
Sobrecargas
| Name | Description |
|---|---|
| WriteStartAttribute(String, String, String) |
Quando sobrescrito numa classe derivada, escreve o início de um atributo com o prefixo especificado, nome local e espaço de nomes URI. |
| WriteStartAttribute(String) |
Escreve o início de um atributo com o nome local especificado. |
| WriteStartAttribute(String, String) |
Escreve o início de um atributo com o nome local especificado e o espaço de nomes URI. |
Observações
Para a versão assíncrona deste método, veja WriteStartAttributeAsync.
WriteStartAttribute(String, String, String)
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
Quando sobrescrito numa classe derivada, escreve o início de um atributo com o prefixo especificado, nome local e espaço de nomes 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 -> unitPublic MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)Parâmetros
- prefix
- String
O prefixo de namespace do atributo.
- localName
- String
O nome local do atributo.
- ns
- String
O URI do namespace para o atributo.
Exceções
Existe um carácter no buffer que é um carácter 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, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.
Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
Observações
Este método permite-lhe escrever um valor usando múltiplos métodos Write.
Para a versão assíncrona deste método, veja WriteStartAttributeAsync.
Aplica-se a
WriteStartAttribute(String)
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
Escreve 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 -> unitPublic Sub WriteStartAttribute (localName As String)Parâmetros
- localName
- String
O nome local do atributo.
Exceções
O escritor está fechado.
-ou-
Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
Existe um carácter no buffer que é um carácter 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, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.
Observações
Este método permite-lhe escrever um valor usando múltiplos métodos Write.
Para a versão assíncrona deste método, veja WriteStartAttributeAsync.
Aplica-se a
WriteStartAttribute(String, String)
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
- Origem:
- XmlWriter.cs
Escreve o início de um atributo com o nome local especificado e o espaço de nomes 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 -> 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
Existe um carácter no buffer que é um carácter 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, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.
Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
Exemplos
Veja XmlTextWriter.WriteStartAttribute um exemplo que utiliza este método.
Observações
Esta é uma versão mais avançada que WriteAttributeString permite escrever um valor de atributo usando múltiplos métodos de escrita, como WriteString, WriteQualifiedName, e assim sucessivamente.
Para a versão assíncrona deste método, veja WriteStartAttributeAsync.
