XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString Method

Definición

Cuando se invalida en una clase derivada, escribe un atributo con el valor especificado.When overridden in a derived class, writes an attribute with the specified value.

Sobrecargas

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Cuando se invalida en una clase derivada, escribe un atributo con el valor, nombre local e identificador URI del espacio de nombres especificados.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

Cuando se invalida en una clase derivada, escribe el atributo con el prefijo, el nombre local, el identificador URI de espacio de nombres y el valor especificados.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local especificados.When overridden in a derived class, writes out the attribute with the specified local name and value.

Comentarios

Para obtener la versión asincrónica de este método, vea WriteElementStringAsync.For the asynchronous version of this method, see WriteElementStringAsync.

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Cuando se invalida en una clase derivada, escribe un atributo con el valor, nombre local e identificador URI del espacio de nombres especificados.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);
member this.WriteAttributeString : string * string * string -> unit
Public Sub WriteAttributeString (localName As String, ns As String, value As String)

Parámetros

localName
String String String String

Nombre local del atributo.The local name of the attribute.

ns
String String String String

Identificador URI de espacio de nombres que se va asociar al atributo.The namespace URI to associate with the attribute.

value
String String String String

El valor del atributo.The value of the attribute.

Excepciones

El estado del método de escritura no es WriteState.Element o está cerrado.The state of writer is not WriteState.Element or writer is closed.

O bien-or- Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior.An XmlWriter method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

El valor de atributo xml:space o xml:lang no es válido.The xml:space or xml:lang attribute value is invalid.

Ejemplos

En el ejemplo siguiente se WriteAttributeString usa el método para escribir una declaración de espacio de nombres.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
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

Comentarios

Este método escribe el atributo con un prefijo de espacio de nombres definido por el usuario y lo asocia al espacio de nombres especificado.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Si localName es "xmlns", este método también lo trata como una declaración de espacio de nombres.If localName is "xmlns" then this method also treats this as a namespace declaration. En este caso, el ns argumento puede ser null.In this case, the ns argument can be null.

WriteAttributeString hace lo siguiente:WriteAttributeString does the following:

  • Si el valor del atributo incluye comillas simples o dobles, se reemplazan &apos; por &quot; y, respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Si escribe un xml:space atributo, el escritor comprueba que el valor del atributo es válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Los valores válidos defaultson preserve o).(Valid values are preserve or default.)

  • Si escribe un xml:lang atributo, el escritor no comprueba si el valor del atributo es válido de acuerdo con la recomendación XML 1,0 del consorcio W3C.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.

Para obtener la versión asincrónica de este método, vea WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

Cuando se invalida en una clase derivada, escribe el atributo con el prefijo, el nombre local, el identificador URI de espacio de nombres y el valor especificados.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);
member this.WriteAttributeString : string * string * string * string -> unit
Public Sub WriteAttributeString (prefix As String, localName As String, ns As String, value As String)

Parámetros

prefix
String String String String

Prefijo de espacio de nombres del atributo.The namespace prefix of the attribute.

localName
String String String String

Nombre local del atributo.The local name of the attribute.

ns
String String String String

URI de espacio de nombres del atributo.The namespace URI of the attribute.

value
String String String String

El valor del atributo.The value of the attribute.

Excepciones

El estado del método de escritura no es WriteState.Element o está cerrado.The state of writer is not WriteState.Element or writer is closed.

O bien-or- Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior.An XmlWriter method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

El valor de atributo xml:space o xml:lang no es válido.The xml:space or xml:lang attribute value is invalid.

localName o ns es null.The localName or ns is null.

Ejemplos

En el ejemplo siguiente se WriteAttributeString usa el método para escribir una declaración de espacio de nombres.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
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

Comentarios

Este método escribe el atributo con un prefijo de espacio de nombres definido por el usuario y lo asocia al espacio de nombres especificado.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Si el prefijo es "xmlns", este método también lo trata como una declaración de espacio de nombres y asocia el prefijo declarado al identificador URI de espacio de nombres proporcionado en el valor de atributo especificado.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. En este caso, ns el argumento puede nullser.In this case the ns argument can be null.

WriteAttributeString hace lo siguiente:WriteAttributeString does the following:

  • Si el valor del atributo incluye comillas simples o dobles, se reemplazan &apos; por &quot; y, respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Si escribe un xml:space atributo, el escritor comprueba que el valor del atributo es válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Los valores válidos defaultson preserve o).(Valid values are preserve or default.)

  • Si escribe un xml:lang atributo, el escritor no comprueba si el valor del atributo es válido de acuerdo con la recomendación XML 1,0 del consorcio W3C.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.

Para obtener la versión asincrónica de este método, vea WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local especificados.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);
member this.WriteAttributeString : string * string -> unit
Public Sub WriteAttributeString (localName As String, value As String)

Parámetros

localName
String String String String

Nombre local del atributo.The local name of the attribute.

value
String String String String

El valor del atributo.The value of the attribute.

Excepciones

El estado del método de escritura no es WriteState.Element o está cerrado.The state of writer is not WriteState.Element or writer is closed.

O bien-or-

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior.An XmlWriter method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

El valor de atributo xml:space o xml:lang no es válido.The xml:space or xml:lang attribute value is invalid.

Ejemplos

En el ejemplo siguiente se escribe un libro.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
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 'Main 
End Class 'Sample

Comentarios

WriteAttributeString hace lo siguiente:WriteAttributeString does the following:

  • Si el valor del atributo incluye comillas simples o dobles, se reemplazan &apos; por &quot; y, respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Si escribe un xml:space atributo, el escritor comprueba que el valor del atributo es válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Los valores válidos defaultson preserve o).(Valid values are preserve or default.)

  • Si escribe un xml:lang atributo, el escritor no comprueba si el valor del atributo es válido de acuerdo con la recomendación XML 1,0 del consorcio W3C.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.

Para obtener la versión asincrónica de este método, vea WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

Se aplica a