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

Definizione

Quando ne viene eseguito l'override in una classe derivata, scrive un attributo con il valore specificato.When overridden in a derived class, writes an attribute with the specified value.

Overload

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

Quando ne viene eseguito l'override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.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)

Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.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)

Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il nome locale e il valore specificati.When overridden in a derived class, writes out the attribute with the specified local name and value.

Commenti

Per la versione asincrona di questo metodo, vedere 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)

Quando ne viene eseguito l'override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.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)

Parametri

localName
String String String String

Nome locale dell'attributo.The local name of the attribute.

ns
String String String String

URI dello spazio dei nomi da associare all'attributo.The namespace URI to associate with the attribute.

value
String String String String

Valore dell'attributo.The value of the attribute.

Eccezioni

Lo stato del writer non è WriteState.Element o il writer è chiuso.The state of writer is not WriteState.Element or writer is closed.

-oppure--or- È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Il valore dell'attributo xml:space o xml:lang non è valido.The xml:space or xml:lang attribute value is invalid.

Esempi

Nell'esempio seguente viene usato WriteAttributeString il metodo per scrivere una dichiarazione dello spazio dei nomi.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

Commenti

Questo metodo scrive l'attributo con un prefisso dello spazio dei nomi definito dall'utente e lo associa allo spazio dei nomi specificato.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Se localName è "xmlns", questo metodo lo considera anche come dichiarazione dello spazio dei nomi.If localName is "xmlns" then this method also treats this as a namespace declaration. In questo caso, l' ns argomento può essere null.In this case, the ns argument can be null.

WriteAttributeString effettua le operazioni seguenti:WriteAttributeString does the following:

  • Se il valore dell'attributo include virgolette doppie o singole, verranno sostituiti &apos; rispettivamente con &quot; e.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se si scrive xml:space un attributo, il writer verifica che il valore dell'attributo sia valido.If writing an xml:space attribute, the writer verifies the attribute value is valid. I valori validi sono preserve o default.(Valid values are preserve or default.)

  • Se si scrive xml:lang un attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione 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.

Per la versione asincrona di questo metodo, vedere 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)

Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.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)

Parametri

prefix
String String String String

Prefisso dello spazio dei nomi dell'attributo.The namespace prefix of the attribute.

localName
String String String String

Nome locale dell'attributo.The local name of the attribute.

ns
String String String String

URI dello spazio dei nomi dell'attributo.The namespace URI of the attribute.

value
String String String String

Valore dell'attributo.The value of the attribute.

Eccezioni

Lo stato del writer non è WriteState.Element o il writer è chiuso.The state of writer is not WriteState.Element or writer is closed.

In alternativa-or- È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Il valore dell'attributo xml:space o xml:lang non è valido.The xml:space or xml:lang attribute value is invalid.

Il localName o ns è null.The localName or ns is null.

Esempi

Nell'esempio seguente viene usato WriteAttributeString il metodo per scrivere una dichiarazione dello spazio dei nomi.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

Commenti

Questo metodo scrive l'attributo con un prefisso dello spazio dei nomi definito dall'utente e lo associa allo spazio dei nomi specificato.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Se il prefisso è "xmlns", questo metodo lo considera anche come dichiarazione dello spazio dei nomi e associa il prefisso dichiarato all'URI dello spazio dei nomi fornito nel valore dell'attributo specificato.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. In questo caso l' ns argomento può essere null.In this case the ns argument can be null.

WriteAttributeString effettua le operazioni seguenti:WriteAttributeString does the following:

  • Se il valore dell'attributo include virgolette doppie o singole, verranno sostituiti &apos; rispettivamente con &quot; e.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se si scrive xml:space un attributo, il writer verifica che il valore dell'attributo sia valido.If writing an xml:space attribute, the writer verifies the attribute value is valid. I valori validi sono preserve o default.(Valid values are preserve or default.)

  • Se si scrive xml:lang un attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione 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.

Per la versione asincrona di questo metodo, vedere WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

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

Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il nome locale e il valore specificati.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)

Parametri

localName
String String String String

Nome locale dell'attributo.The local name of the attribute.

value
String String String String

Valore dell'attributo.The value of the attribute.

Eccezioni

Lo stato del writer non è WriteState.Element o il writer è chiuso.The state of writer is not WriteState.Element or writer is closed.

-oppure--or-

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Il valore dell'attributo xml:space o xml:lang non è valido.The xml:space or xml:lang attribute value is invalid.

Esempi

Nell'esempio seguente viene scritto 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.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

Commenti

WriteAttributeString effettua le operazioni seguenti:WriteAttributeString does the following:

  • Se il valore dell'attributo include virgolette doppie o singole, verranno sostituiti &apos; rispettivamente con &quot; e.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Se si scrive xml:space un attributo, il writer verifica che il valore dell'attributo sia valido.If writing an xml:space attribute, the writer verifies the attribute value is valid. I valori validi sono preserve o default.(Valid values are preserve or default.)

  • Se si scrive xml:lang un attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione 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.

Per la versione asincrona di questo metodo, vedere WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

Si applica a