XmlWriter.WriteElementString Metoda

Definicja

Przestrzeń nazw:: System.Xml

Zestawy:: System.Xml.dll, System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje element zawierający wartość ciągu.

Przeciążenia

Nazwa	Opis
WriteElementString(String, String)	Zapisuje element o określonej nazwie lokalnej i wartości.
WriteElementString(String, String, String)	Zapisuje element z określoną lokalną nazwą, identyfikatorem URI przestrzeni nazw i wartością.
WriteElementString(String, String, String, String)	Zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteElementStringAsync.

WriteElementString(String, String)

Zapisuje element o określonej nazwie lokalnej i wartości.

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)

Parametry

localName: String

Lokalna nazwa elementu.

value: String

Wartość elementu.

Wyjątki

ArgumentException

Wartość localName to null lub pusty ciąg.

— lub —

Wartości parametrów są nieprawidłowe.

EncoderFallbackException

Istnieje znak w buforze, który jest prawidłowym znakiem XML, ale nie jest prawidłowy dla kodowania danych wyjściowych. Jeśli na przykład kodowanie wyjściowe to ASCII, należy używać tylko znaków z zakresu od 0 do 127 dla nazw elementów i atrybutów. Nieprawidłowy znak może znajdować się w argumencie tej metody lub w argumencie poprzednich metod zapisywanych w buforze. Takie znaki są usuwane przez odwołania do jednostki znaków, gdy jest to możliwe (na przykład w węzłach tekstowych lub wartościach atrybutów). Odwołanie do jednostki znaku nie jest jednak dozwolone w nazwach elementów i atrybutów, komentarzach, instrukcjach przetwarzania lub sekcjach CDATA.

InvalidOperationException

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

W poniższym przykładzie użyto kilku metod zapisu w celu utworzenia fragmentu 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

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteElementStringAsync.

Dotyczy

WriteElementString(String, String, String)

Zapisuje element z określoną lokalną nazwą, identyfikatorem URI przestrzeni nazw i wartością.

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)

Parametry

localName: String

Lokalna nazwa elementu.

ns: String

Identyfikator URI przestrzeni nazw do skojarzenia z elementem.

value: String

Wartość elementu.

Wyjątki

ArgumentException

Wartość localName to null lub pusty ciąg.

— lub —

Wartości parametrów są nieprawidłowe.

EncoderFallbackException

InvalidOperationException

Przykłady

W poniższym przykładzie użyto kilku metod zapisu w celu utworzenia fragmentu 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

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteElementStringAsync.

Dotyczy

WriteElementString(String, String, String, String)

Zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.

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)

Parametry

prefix: String

Prefiks elementu.

localName: String

Lokalna nazwa elementu.

ns: String

Identyfikator URI przestrzeni nazw elementu.

value: String

Wartość elementu.

Wyjątki

ArgumentException

Wartość localName to null lub pusty ciąg.

— lub —

Wartości parametrów są nieprawidłowe.

EncoderFallbackException

InvalidOperationException

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteElementStringAsync.

Dotyczy

Opinia

Czy ta strona była pomocna?