XmlWriter.WriteAttributeString Método

Definição

Quando substituído em uma classe derivada, grava um atributo com o valor especificado.When overridden in a derived class, writes an attribute with the specified value.

Sobrecargas

WriteAttributeString(String, String, String, String)

Quando substituído em uma classe derivada, grava o atributo com o prefixo, nome local, URI do namespace e o 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, String)

Quando substituído em uma classe derivada, grava um atributo com o nome local, URI do namespace e o valor especificados.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String)

Quando substituído em uma classe derivada, grava o atributo com o nome local e o valor especificados.When overridden in a derived class, writes out the attribute with the specified local name and value.

Comentários

Para obter a versão assíncrona desse método, consulte WriteElementStringAsync .For the asynchronous version of this method, see WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Quando substituído em uma classe derivada, grava o atributo com o prefixo, nome local, URI do namespace e o 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);
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

O prefixo do namespace do atributo.The namespace prefix of the attribute.

localName
String

O nome local do atributo.The local name of the attribute.

ns
String

O URI do namespace do atributo.The namespace URI of the attribute.

value
String

O valor do atributo.The value of the attribute.

Exceções

O estado do gravador não é WriteState.Element ou o gravador está fechado.The state of writer is not WriteState.Element or writer is closed.

- ou --or- Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O valor do atributo xml:space ou xml:lang é inválido.The xml:space or xml:lang attribute value is invalid.

O localName ou ns é null.The localName or ns is null.

Exemplos

O exemplo a seguir usa o WriteAttributeString método para gravar uma declaração de namespace.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

Comentários

Esse método grava o atributo com um prefixo de namespace definido pelo usuário e o associa ao namespace fornecido.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Se o prefixo for "xmlns", esse método também tratará isso como uma declaração de namespace e associará o prefixo declarado ao URI de namespace fornecido no valor de atributo fornecido.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. Nesse caso, o ns argumento pode ser null .In this case the ns argument can be null.

WriteAttributeString faz o seguinte:WriteAttributeString does the following:

  • Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas por &quot; e, &apos; respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Os valores válidos são preserve ou default .)(Valid values are preserve or default.)

  • Se estiver escrevendo um xml:lang atributo, o gravador não verificará se o valor do atributo é válido de acordo com a recomendação do W3C 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.

Para obter a versão assíncrona desse método, consulte WriteAttributeStringAsync .For the asynchronous version of this method, see WriteAttributeStringAsync.

Aplica-se a

WriteAttributeString(String, String, String)

Quando substituído em uma classe derivada, grava um atributo com o nome local, URI do namespace e o valor 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);
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

O nome local do atributo.The local name of the attribute.

ns
String

O URI do namespace para associar ao atributo.The namespace URI to associate with the attribute.

value
String

O valor do atributo.The value of the attribute.

Exceções

O estado do gravador não é WriteState.Element ou o gravador está fechado.The state of writer is not WriteState.Element or writer is closed.

- ou --or- Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O valor do atributo xml:space ou xml:lang é inválido.The xml:space or xml:lang attribute value is invalid.

Exemplos

O exemplo a seguir usa o WriteAttributeString método para gravar uma declaração de namespace.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

Comentários

Esse método grava o atributo com um prefixo de namespace definido pelo usuário e o associa ao namespace fornecido.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Se localName for "xmlns", esse método também tratará isso como uma declaração de namespace.If localName is "xmlns" then this method also treats this as a namespace declaration. Nesse caso, o ns argumento pode ser null .In this case, the ns argument can be null.

WriteAttributeString faz o seguinte:WriteAttributeString does the following:

  • Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas por &quot; e, &apos; respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Os valores válidos são preserve ou default .)(Valid values are preserve or default.)

  • Se estiver escrevendo um xml:lang atributo, o gravador não verificará se o valor do atributo é válido de acordo com a recomendação do W3C 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.

Para obter a versão assíncrona desse método, consulte WriteAttributeStringAsync .For the asynchronous version of this method, see WriteAttributeStringAsync.

Aplica-se a

WriteAttributeString(String, String)

Quando substituído em uma classe derivada, grava o atributo com o nome local e o valor 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);
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

O nome local do atributo.The local name of the attribute.

value
String

O valor do atributo.The value of the attribute.

Exceções

O estado do gravador não é WriteState.Element ou o gravador está fechado.The state of writer is not WriteState.Element or writer is closed.

- ou --or-

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O valor do atributo xml:space ou xml:lang é inválido.The xml:space or xml:lang attribute value is invalid.

Exemplos

O exemplo a seguir grava um livro.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

Comentários

WriteAttributeString faz o seguinte:WriteAttributeString does the following:

  • Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas por &quot; e, &apos; respectivamente.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Os valores válidos são preserve ou default .)(Valid values are preserve or default.)

  • Se estiver escrevendo um xml:lang atributo, o gravador não verificará se o valor do atributo é válido de acordo com a recomendação do W3C 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.

Para obter a versão assíncrona desse método, consulte WriteAttributeStringAsync .For the asynchronous version of this method, see WriteAttributeStringAsync.

Aplica-se a