XmlWriter.WriteAttributeString Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

En cas de substitution dans une classe dérivée, écrit un attribut avec la valeur spécifiée.

Surcharges

Nom Description
WriteAttributeString(String, String, String, String)

En cas de substitution dans une classe dérivée, écrit l’attribut avec le préfixe, le nom local, l’URI d’espace de noms et la valeur spécifiés.
WriteAttributeString(String, String, String)

En cas de substitution dans une classe dérivée, écrit un attribut avec le nom local, l’URI d’espace de noms et la valeur spécifiés.
WriteAttributeString(String, String)

En cas de substitution dans une classe dérivée, écrit l’attribut avec le nom et la valeur locaux spécifiés.

Remarques

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

WriteAttributeString(String, 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 l’attribut avec le préfixe, le nom local, l’URI d’espace de noms et la valeur spécifiés.

public:
 void WriteAttributeString(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);
public void WriteAttributeString(string prefix, string localName, string ns, string value);
public void WriteAttributeString(string? prefix, string localName, string? ns, string? value);
member this.WriteAttributeString : string * string * string * string -> unit
Public Sub WriteAttributeString (prefix As String, localName As String, ns As String, value 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.

value
String

Valeur de l’attribut.

Exceptions

InvalidOperationException

L’état de l’enregistreur n’est pas WriteState.Element ou 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 ».

ArgumentException

La valeur ou xml:space l’attribut xml:lang n’est pas valide.

XmlException

localName Ou ns est null.

Exemples

L’exemple suivant utilise la WriteAttributeString méthode pour écrire une déclaration d’espace de noms.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

Remarques

Cette méthode écrit l’attribut avec un préfixe d’espace de noms défini par l’utilisateur et l’associe à l’espace de noms donné. Si le préfixe est « xmlns », cette méthode traite également ce paramètre comme une déclaration d’espace de noms et associe le préfixe déclaré à l’URI d’espace de noms fourni dans la valeur d’attribut donnée. Dans ce cas, l’argument ns peut être null.

WriteAttributeString effectue les opérations suivantes :

  • Si la valeur d’attribut comprend des guillemets doubles ou simples, elles sont remplacées " respectivement par et ' respectivement.

  • Si vous écrivez un xml:space attribut, l’enregistreur vérifie que la valeur de l’attribut est valide. (Les valeurs valides sont preserve ou default.)

  • Si vous écrivez un xml:lang attribut, l’enregistreur ne vérifie pas que la valeur de l’attribut est valide conformément à la recommandation W3C XML 1.0.

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

S’applique à

WriteAttributeString(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 un attribut avec le nom local, l’URI d’espace de noms et la valeur spécifiés.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ ns, System::String ^ value);
public void WriteAttributeString(string localName, string ns, string value);
public void WriteAttributeString(string localName, string? ns, string? value);
member this.WriteAttributeString : string * string * string -> unit
Public Sub WriteAttributeString (localName As String, ns As String, value As String)

Paramètres

localName
String

Nom local de l’attribut.

ns
String

URI d’espace de noms à associer à l’attribut.

value
String

Valeur de l’attribut.

Exceptions

InvalidOperationException

L’état de l’enregistreur n’est pas WriteState.Element ou 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 ».

ArgumentException

La valeur ou xml:space l’attribut xml:lang n’est pas valide.

Exemples

L’exemple suivant utilise la WriteAttributeString méthode pour écrire une déclaration d’espace de noms.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

Remarques

Cette méthode écrit l’attribut avec un préfixe d’espace de noms défini par l’utilisateur et l’associe à l’espace de noms donné. S’il localName s’agit de « xmlns », cette méthode traite également cette méthode comme une déclaration d’espace de noms. Dans ce cas, l’argument ns peut être null.

WriteAttributeString effectue les opérations suivantes :

  • Si la valeur d’attribut comprend des guillemets doubles ou simples, elles sont remplacées " respectivement par et ' respectivement.

  • Si vous écrivez un xml:space attribut, l’enregistreur vérifie que la valeur de l’attribut est valide. (Les valeurs valides sont preserve ou default.)

  • Si vous écrivez un xml:lang attribut, l’enregistreur ne vérifie pas que la valeur de l’attribut est valide conformément à la recommandation W3C XML 1.0.

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

S’applique à

WriteAttributeString(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 l’attribut avec le nom et la valeur locaux spécifiés.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ value);
public void WriteAttributeString(string localName, string value);
public void WriteAttributeString(string localName, string? value);
member this.WriteAttributeString : string * string -> unit
Public Sub WriteAttributeString (localName As String, value As String)

Paramètres

localName
String

Nom local de l’attribut.

value
String

Valeur de l’attribut.

Exceptions

InvalidOperationException

L’état de l’enregistreur n’est pas WriteState.Element ou 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 ».

ArgumentException

La valeur ou xml:space l’attribut xml:lang n’est pas valide.

Exemples

L’exemple suivant écrit un livre.

using System;
using System.IO;
using System.Xml;

 public class Sample
 {
   private const string m_Document = "sampledata.xml";

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared m_Document As String = "sampledata.xml"
    
    Public Shared Sub Main()
        Dim writer As XmlWriter = Nothing
        
      Try

        Dim settings As XmlWriterSettings = new XmlWriterSettings()
        settings.Indent = true
        writer = XmlWriter.Create (m_Document, settings)
            
        writer.WriteComment("sample XML fragment")
            
        ' Write an element (this one is the root).
        writer.WriteStartElement("book")
            
        ' Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", Nothing, "urn:samples")
            
        ' Write the genre attribute.
        writer.WriteAttributeString("genre", "novel")
            
        ' Write the title.
        writer.WriteStartElement("title")
        writer.WriteString("The Handmaid's Tale")
        writer.WriteEndElement()
            
        ' Write the price.
        writer.WriteElementString("price", "19.95")
            
        ' Lookup the prefix and write the ISBN element.
        Dim prefix As String = writer.LookupPrefix("urn:samples")
        writer.WriteStartElement(prefix, "ISBN", "urn:samples")
        writer.WriteString("1-861003-78")
        writer.WriteEndElement()
            
        ' Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover")
            
        ' Write the close tag for the root element.
        writer.WriteEndElement()
            
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        Finally
            If Not (writer Is Nothing) Then
                writer.Close()
            End If
        End Try

    End Sub
End Class

Remarques

WriteAttributeString effectue les opérations suivantes :

  • Si la valeur d’attribut comprend des guillemets doubles ou simples, elles sont remplacées " respectivement par et ' respectivement.

  • Si vous écrivez un xml:space attribut, l’enregistreur vérifie que la valeur de l’attribut est valide. (Les valeurs valides sont preserve ou default.)

  • Si vous écrivez un xml:lang attribut, l’enregistreur ne vérifie pas que la valeur de l’attribut est valide conformément à la recommandation W3C XML 1.0.

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

S’applique à