XmlWriter.WriteElementString 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.

Scrive un elemento contenente un valore stringa.

Overload

Nome	Descrizione
WriteElementString(String, String)	Scrive un elemento con il nome e il valore locali specificati.
WriteElementString(String, String, String)	Scrive un elemento con il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteElementString(String, String, String, String)	Scrive un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.

Commenti

Per la versione asincrona di questo metodo, vedere WriteElementStringAsync.

WriteElementString(String, String)

Scrive un elemento con il nome e il valore locali specificati.

public:
 void WriteElementString(System::String ^ localName, System::String ^ value);

public void WriteElementString(string localName, string value);

member this.WriteElementString : string * string -> unit

Public Sub WriteElementString (localName As String, value As String)

Parametri

localName: String

Nome locale dell'elemento.

value: String

Valore dell'elemento.

Eccezioni

ArgumentException

Il localName valore è null o una stringa vuota.

oppure

I valori dei parametri non sono validi.

EncoderFallbackException

È presente un carattere nel buffer che è un carattere XML valido, ma non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è consigliabile usare solo i caratteri compresi tra 0 e 127 per i nomi di elementi e attributi. Il carattere non valido potrebbe trovarsi nell'argomento di questo metodo o in un argomento di metodi precedenti che stavano scrivendo nel buffer. Tali caratteri vengono preceduti da un carattere di escape per i riferimenti all'entità carattere, ad esempio nei nodi di testo o nei valori degli attributi. Tuttavia, il riferimento all'entità carattere non è consentito nelle sezioni di elementi e attributi, commenti, istruzioni di elaborazione o CDATA.

InvalidOperationException

È 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".

Esempio

Nell'esempio seguente vengono utilizzati diversi metodi di scrittura per creare un frammento XML.

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

Per la versione asincrona di questo metodo, vedere WriteElementStringAsync.

Si applica a

WriteElementString(String, String, String)

Scrive un elemento con il nome locale, l'URI dello spazio dei nomi e il valore specificati.

public:
 void WriteElementString(System::String ^ localName, System::String ^ ns, System::String ^ value);

public void WriteElementString(string localName, string ns, string value);

member this.WriteElementString : string * string * string -> unit

Public Sub WriteElementString (localName As String, ns As String, value As String)

Parametri

localName: String

Nome locale dell'elemento.

ns: String

URI dello spazio dei nomi da associare all'elemento .

value: String

Valore dell'elemento.

Eccezioni

ArgumentException

Il localName valore è null o una stringa vuota.

oppure

I valori dei parametri non sono validi.

EncoderFallbackException

InvalidOperationException

Esempio

Nell'esempio seguente vengono utilizzati diversi metodi di scrittura per creare un frammento XML.

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

Per la versione asincrona di questo metodo, vedere WriteElementStringAsync.

Si applica a

WriteElementString(String, String, String, String)

Scrive un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.

public:
 void WriteElementString(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public void WriteElementString(string prefix, string localName, string ns, string value);

member this.WriteElementString : string * string * string * string -> unit

Public Sub WriteElementString (prefix As String, localName As String, ns As String, value As String)

Parametri

prefix: String

Prefisso dell'elemento.

localName: String

Nome locale dell'elemento.

ns: String

URI dello spazio dei nomi dell'elemento.

value: String

Valore dell'elemento.

Eccezioni

ArgumentException

Il localName valore è null o una stringa vuota.

oppure

I valori dei parametri non sono validi.

EncoderFallbackException

InvalidOperationException

Commenti

Per la versione asincrona di questo metodo, vedere WriteElementStringAsync.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?