XmlWriter.WriteAttributeString Método

Referência

Definição

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Quando substituído em uma classe derivada, grava um atributo com o valor especificado.

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

Comentários

Para obter a versão assíncrona deste método, consulte 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.

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.

localName: String

O nome local do atributo.

ns: String

O URI do namespace do atributo.

value: String

O valor do atributo.

Exceções

InvalidOperationException

O estado do gravador não é WriteState.Element ou o gravador está fechado.

- ou - Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

ArgumentException

O valor do atributo xml:space ou xml:lang é inválido.

XmlException

O localName ou ns é null.

Exemplos

O exemplo a seguir usa o WriteAttributeString método para escrever uma declaração de namespace.

#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. 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 do namespace fornecido no valor de atributo fornecido. Nesse caso, o ns argumento pode ser null.

WriteAttributeString faz o seguinte:

Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas " e ' , respectivamente.
Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido. (Valores válidos são preserve ou 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.

Para obter a versão assíncrona deste método, consulte 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.

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.

ns: String

O URI do namespace para associar ao atributo.

value: String

O valor do atributo.

Exceções

InvalidOperationException

O estado do gravador não é WriteState.Element ou o gravador está fechado.

ArgumentException

O valor do atributo xml:space ou xml:lang é inválido.

Exemplos

O exemplo a seguir usa o WriteAttributeString método para escrever uma declaração de namespace.

#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. Se localName for "xmlns", esse método também tratará isso como uma declaração de namespace. Nesse caso, o ns argumento pode ser null.

WriteAttributeString faz o seguinte:

Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas " e ' , respectivamente.
Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido. (Valores válidos são preserve ou 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.

Para obter a versão assíncrona deste método, consulte 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.

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.

value: String

O valor do atributo.

Exceções

InvalidOperationException

O estado do gravador não é WriteState.Element ou o gravador está fechado.

- ou -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

ArgumentException

O valor do atributo xml:space ou xml:lang é inválido.

Exemplos

O exemplo a seguir grava um livro.

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

Se o valor do atributo incluir aspas duplas ou simples, elas serão substituídas " e ' , respectivamente.
Se estiver escrevendo um xml:space atributo, o gravador verificará se o valor do atributo é válido. (Valores válidos são preserve ou 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.

Para obter a versão assíncrona deste método, consulte WriteAttributeStringAsync.

Aplica-se a

XmlWriter.WriteAttributeString Método

Definição

Sobrecargas

Comentários

WriteAttributeString(String, String, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

WriteAttributeString(String, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

WriteAttributeString(String, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais