XmlWriter.WriteAttributeString Metodo

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Quando sottoposto a override in una classe derivata, scrive un attributo con il valore specificato.

Overload

Nome	Descrizione
WriteAttributeString(String, String, String)	In caso di override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteAttributeString(String, String, String, String)	In caso di override in una classe derivata, scrive l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteAttributeString(String, String)	In caso di override in una classe derivata, scrive l'attributo con il nome e il valore locali specificati.

Commenti

Per la versione asincrona di questo metodo, vedere WriteElementStringAsync.

WriteAttributeString(String, String, String)

In caso di override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.

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

Nome locale dell'attributo.

ns: String

URI dello spazio dei nomi da associare all'attributo .

value: String

Valore dell'attributo.

Eccezioni

InvalidOperationException

Lo stato del writer non WriteState.Element è o il writer è chiuso.

oppure

È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

ArgumentException

Il valore dell'attributo xml:space o xml:lang non è valido.

Esempio

Nell'esempio seguente viene utilizzato il WriteAttributeString metodo per scrivere una dichiarazione dello spazio dei nomi.

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. Se localName è "xmlns", questo metodo lo considera anche come dichiarazione dello spazio dei nomi. In questo caso, l'argomento ns può essere null.

WriteAttributeString esegue le operazioni seguenti:

Se il valore dell'attributo include virgolette doppie o singole, vengono sostituite rispettivamente con " e ' .
Se si scrive un xml:space attributo, il writer verifica che il valore dell'attributo sia valido. (I valori validi sono preserve o default.)
Se si scrive un xml:lang attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione W3C XML 1.0.

Per la versione asincrona di questo metodo, vedere WriteAttributeStringAsync.

Si applica a

WriteAttributeString(String, String, String, String)

In caso di override in una classe derivata, scrive l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.

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

Prefisso dello spazio dei nomi dell'attributo.

localName: String

Nome locale dell'attributo.

ns: String

URI dello spazio dei nomi dell'attributo.

value: String

Valore dell'attributo.

Eccezioni

InvalidOperationException

Lo stato del writer non WriteState.Element è o il writer è chiuso.

oppure

ArgumentException

Il valore dell'attributo xml:space o xml:lang non è valido.

XmlException

l'oggetto localName o ns è null.

Esempio

Nell'esempio seguente viene utilizzato il WriteAttributeString metodo per scrivere una dichiarazione dello spazio dei nomi.

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. 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. In questo caso l'argomento ns può essere null.

WriteAttributeString esegue le operazioni seguenti:

Se il valore dell'attributo include virgolette doppie o singole, vengono sostituite rispettivamente con " e ' .
Se si scrive un xml:space attributo, il writer verifica che il valore dell'attributo sia valido. (I valori validi sono preserve o default.)
Se si scrive un xml:lang attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione W3C XML 1.0.

Per la versione asincrona di questo metodo, vedere WriteAttributeStringAsync.

Si applica a

WriteAttributeString(String, String)

In caso di override in una classe derivata, scrive l'attributo con il nome e il valore locali specificati.

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

Nome locale dell'attributo.

value: String

Valore dell'attributo.

Eccezioni

InvalidOperationException

Lo stato del writer non WriteState.Element è o il writer è chiuso.

oppure

ArgumentException

Il valore dell'attributo xml:space o xml:lang non è valido.

Esempio

Nell'esempio seguente viene scritto un libro.

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 esegue le operazioni seguenti:

Se il valore dell'attributo include virgolette doppie o singole, vengono sostituite rispettivamente con " e ' .
Se si scrive un xml:space attributo, il writer verifica che il valore dell'attributo sia valido. (I valori validi sono preserve o default.)
Se si scrive un xml:lang attributo, il writer non verifica che il valore dell'attributo sia valido in base alla raccomandazione W3C XML 1.0.

Per la versione asincrona di questo metodo, vedere WriteAttributeStringAsync.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?