XmlWriter.WriteStartAttribute Méthode

Définition

En cas de substitution dans une classe dérivée, écrit le début d'un attribut.When overridden in a derived class, writes the start of an attribute.

Surcharges

WriteStartAttribute(String, String, String)

En cas de substitution dans une classe dérivée, écrit le début d'un attribut avec le préfixe, le nom local et l'URI de l'espace de noms spécifiés.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttribute(String)

Écrit le début d'un attribut avec le nom local spécifié.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Écrit le début d'un attribut avec le nom local et l'URI de l'espace de noms spécifiés.Writes the start of an attribute with the specified local name and namespace URI.

Remarques

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

En cas de substitution dans une classe dérivée, écrit le début d'un attribut avec le préfixe, le nom local et l'URI de l'espace de noms spécifiés.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)

Paramètres

prefix
String

Préfixe de l'espace de noms de cet attribut.The namespace prefix of the attribute.

localName
String

Le nom local de l'attribut.The local name of the attribute.

ns
String

URI d'espace de noms de cet attribut.The namespace URI for the attribute.

Exceptions

Un caractère dans la mémoire tampon est un caractère XML valide mais n'est pas valide pour l'encodage de sortie.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Par exemple, si l'encodage de sortie est ASCII, vous devez utiliser uniquement des caractères de la plage de 0 à 127 pour les noms d'éléments et d'attributs.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. Le caractère non valide peut être dans l'argument de cette méthode ou dans un argument des méthodes précédentes qui écrivaient dans la mémoire tampon.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Les caractères de ce type sont échappés par les références d'entité de caractère lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d'attribut).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Toutefois, la référence d'entité de caractère n'est pas autorisée dans les noms d'éléments et d'attributs, les commentaires, les instructions de traitement ou les sections CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode vous permet d’écrire une valeur à l’aide de plusieurs méthodes d’écriture.This method enables you to write a value using multiple Write methods.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

S’applique à

WriteStartAttribute(String)

Écrit le début d'un attribut avec le nom local spécifié.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)

Paramètres

localName
String

Le nom local de l'attribut.The local name of the attribute.

Exceptions

Le writer est fermé.The writer is closed.

- ou --or-

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Un caractère dans la mémoire tampon est un caractère XML valide mais n'est pas valide pour l'encodage de sortie.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Par exemple, si l'encodage de sortie est ASCII, vous devez utiliser uniquement des caractères de la plage de 0 à 127 pour les noms d'éléments et d'attributs.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. Le caractère non valide peut être dans l'argument de cette méthode ou dans un argument des méthodes précédentes qui écrivaient dans la mémoire tampon.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Les caractères de ce type sont échappés par les références d'entité de caractère lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d'attribut).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Toutefois, la référence d'entité de caractère n'est pas autorisée dans les noms d'éléments et d'attributs, les commentaires, les instructions de traitement ou les sections CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Remarques

Cette méthode vous permet d’écrire une valeur à l’aide de plusieurs méthodes d’écriture.This method enables you to write a value using multiple Write methods.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

S’applique à

WriteStartAttribute(String, String)

Écrit le début d'un attribut avec le nom local et l'URI de l'espace de noms spécifiés.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)

Paramètres

localName
String

Le nom local de l'attribut.The local name of the attribute.

ns
String

L'URI de l'espace de noms de l'attribut.The namespace URI of the attribute.

Exceptions

Un caractère dans la mémoire tampon est un caractère XML valide mais n'est pas valide pour l'encodage de sortie.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Par exemple, si l'encodage de sortie est ASCII, vous devez utiliser uniquement des caractères de la plage de 0 à 127 pour les noms d'éléments et d'attributs.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. Le caractère non valide peut être dans l'argument de cette méthode ou dans un argument des méthodes précédentes qui écrivaient dans la mémoire tampon.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Les caractères de ce type sont échappés par les références d'entité de caractère lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d'attribut).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Toutefois, la référence d'entité de caractère n'est pas autorisée dans les noms d'éléments et d'attributs, les commentaires, les instructions de traitement ou les sections CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemples

XmlTextWriter.WriteStartAttributePour obtenir un exemple d’utilisation de cette méthode, consultez.See XmlTextWriter.WriteStartAttribute for an example using this method.

Remarques

Il s’agit d’une version plus avancée de WriteAttributeString qui vous permet d’écrire une valeur d’attribut à l’aide de plusieurs méthodes d’écriture, telles que WriteString , WriteQualifiedName , et ainsi de suite.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.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

Voir aussi

S’applique à