XmlWriter.WriteStartAttribute Méthode

Définition

En cas de substitution dans une classe dérivée, écrit le début d’un attribut.

Surcharges

Nom Description
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 d’espace de noms spécifiés.

WriteStartAttribute(String)

Écrit le début d’un attribut avec le nom local spécifié.

WriteStartAttribute(String, String)

Écrit le début d’un attribut avec le nom local et l’URI d’espace de noms spécifiés.

Remarques

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

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 d’espace de noms spécifiés.

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 d’espace de noms de l’attribut.

localName
String

Nom local de l’attribut.

ns
String

URI d’espace de noms de l’attribut.

Exceptions

Il existe un caractère dans la mémoire tampon qui est un caractère XML valide, mais qui n’est pas valide pour l’encodage de sortie. Par exemple, si l’encodage de sortie est ASCII, vous devez utiliser uniquement des caractères compris entre 0 et 127 pour les noms d’éléments et d’attributs. 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. Ces caractères sont échappés par des références d’entité de caractères lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d’attribut). 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.

Une XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode vous permet d’écrire une valeur à l’aide de plusieurs méthodes d’écriture.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync.

S’applique à

WriteStartAttribute(String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Écrit le début d’un attribut avec le nom local spécifié.

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

Nom local de l’attribut.

Exceptions

L’enregistreur est fermé.

- ou -

Une XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Il existe un caractère dans la mémoire tampon qui est un caractère XML valide, mais qui n’est pas valide pour l’encodage de sortie. Par exemple, si l’encodage de sortie est ASCII, vous devez utiliser uniquement des caractères compris entre 0 et 127 pour les noms d’éléments et d’attributs. 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. Ces caractères sont échappés par des références d’entité de caractères lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d’attribut). 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.

Remarques

Cette méthode vous permet d’écrire une valeur à l’aide de plusieurs méthodes d’écriture.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync.

S’applique à

WriteStartAttribute(String, String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

Écrit le début d’un attribut avec le nom local et l’URI d’espace de noms spécifiés.

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

Nom local de l’attribut.

ns
String

URI d’espace de noms de l’attribut.

Exceptions

Il existe un caractère dans la mémoire tampon qui est un caractère XML valide, mais qui n’est pas valide pour l’encodage de sortie. Par exemple, si l’encodage de sortie est ASCII, vous devez utiliser uniquement des caractères compris entre 0 et 127 pour les noms d’éléments et d’attributs. 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. Ces caractères sont échappés par des références d’entité de caractères lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d’attribut). 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.

Une XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

Consultez XmlTextWriter.WriteStartAttribute un exemple utilisant cette méthode.

Remarques

Il s’agit d’une version plus avancée qui WriteAttributeString vous permet d’écrire une valeur d’attribut à l’aide de plusieurs méthodes d’écriture, telles que WriteString, WriteQualifiedNameetc.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStartAttributeAsync.

Voir aussi

S’applique à