XmlWriter.WriteAttributeString Méthode

Définition

En cas de substitution dans une classe dérivée, écrit un attribut avec la valeur spécifiée.When overridden in a derived class, writes an attribute with the specified value.

Surcharges

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 de l'espace de noms et la valeur spécifiés.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeString(String, String, String)

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

WriteAttributeString(String, String)

En cas de substitution dans une classe dérivée, écrit l'attribut avec le nom local et la valeur spécifiés.When overridden in a derived class, writes out the attribute with the specified local name and value.

Remarques

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

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 de l'espace de noms et la valeur spécifiés.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

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 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

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

value
String

Valeur de l'attribut.The value of the attribute.

Exceptions

L'état du writer n'est pas WriteState.Element ou le writer est fermé.The state of writer is not WriteState.Element or 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."

La valeur d'attribut xml:space ou xml:lang n'est pas valide.The xml:space or xml:lang attribute value is invalid.

localName ou ns a la valeur null.The localName or ns is null.

Exemples

L’exemple suivant utilise la WriteAttributeString méthode pour écrire une déclaration d’espace de noms.The following example uses the WriteAttributeString method to write a namespace declaration.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}
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 spécifié.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Si le préfixe est « xmlns », cette méthode traite également ce 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.If the prefix is "xmlns" then this method also treats this as a namespace declaration and associates the declared prefix with the namespace URI provided in the given attribute value. Dans ce cas, l' ns argument peut être null .In this case the ns argument can be null.

WriteAttributeString effectue les actions suivantes :WriteAttributeString does the following:

  • Si la valeur de l’attribut comprend des guillemets doubles ou simples, ceux-ci sont remplacés par &quot; et &apos; respectivement.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • En cas d’écriture d’un xml:space attribut, le writer vérifie que la valeur de l’attribut est valide.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Les valeurs valides sont preserve ou default .)(Valid values are preserve or default.)

  • En cas d’écriture d’un xml:lang attribut, le writer ne vérifie pas si la valeur de l’attribut est valide conformément à la recommandation du W3C intitulée XML 1,0.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

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

WriteAttributeString(String, String, String)

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

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

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

ns
String

URI de l'espace de noms à associer à l'attribut.The namespace URI to associate with the attribute.

value
String

Valeur de l'attribut.The value of the attribute.

Exceptions

L'état du writer n'est pas WriteState.Element ou le writer est fermé.The state of writer is not WriteState.Element or 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."

La valeur d'attribut xml:space ou xml:lang n'est pas valide.The xml:space or xml:lang attribute value is invalid.

Exemples

L’exemple suivant utilise la WriteAttributeString méthode pour écrire une déclaration d’espace de noms.The following example uses the WriteAttributeString method to write a namespace declaration.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}
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 spécifié.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Si localName est « xmlns », cette méthode traite également ce comme une déclaration d’espace de noms.If localName is "xmlns" then this method also treats this as a namespace declaration. Dans ce cas, l' ns argument peut être null .In this case, the ns argument can be null.

WriteAttributeString effectue les actions suivantes :WriteAttributeString does the following:

  • Si la valeur de l’attribut comprend des guillemets doubles ou simples, ceux-ci sont remplacés par &quot; et &apos; respectivement.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • En cas d’écriture d’un xml:space attribut, le writer vérifie que la valeur de l’attribut est valide.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Les valeurs valides sont preserve ou default .)(Valid values are preserve or default.)

  • En cas d’écriture d’un xml:lang attribut, le writer ne vérifie pas si la valeur de l’attribut est valide conformément à la recommandation du W3C intitulée XML 1,0.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

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

WriteAttributeString(String, String)

En cas de substitution dans une classe dérivée, écrit l'attribut avec le nom local et la valeur spécifiés.When overridden in a derived class, writes out the attribute with the specified local name and value.

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

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

value
String

Valeur de l'attribut.The value of the attribute.

Exceptions

L'état du writer n'est pas WriteState.Element ou le writer est fermé.The state of writer is not WriteState.Element or 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."

La valeur d'attribut xml:space ou xml:lang n'est pas valide.The xml:space or xml:lang attribute value is invalid.

Exemples

L’exemple suivant écrit un livre.The following example writes out a book.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"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 != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

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 actions suivantes :WriteAttributeString does the following:

  • Si la valeur de l’attribut comprend des guillemets doubles ou simples, ceux-ci sont remplacés par &quot; et &apos; respectivement.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • En cas d’écriture d’un xml:space attribut, le writer vérifie que la valeur de l’attribut est valide.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Les valeurs valides sont preserve ou default .)(Valid values are preserve or default.)

  • En cas d’écriture d’un xml:lang attribut, le writer ne vérifie pas si la valeur de l’attribut est valide conformément à la recommandation du W3C intitulée XML 1,0.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

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

S’applique à