XmlWriter.WriteElementString Metoda

Definice

Obor názvů:
System.Xml
Sestavení:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sestavení:
netstandard.dll, System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.dll
Sestavení:
netstandard.dll

Zapíše prvek obsahující řetězcovou hodnotu.

Přetížení

Name Description
WriteElementString(String, String)

Zapíše prvek se zadaným místním názvem a hodnotou.
WriteElementString(String, String, String)

Zapíše prvek se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteElementString(String, String, String, String)

Zapíše prvek se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.

Poznámky

Asynchronní verzi této metody naleznete v tématu WriteElementStringAsync.

WriteElementString(String, String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Zapíše prvek se zadaným místním názvem a hodnotou.

public:
 void WriteElementString(System::String ^ localName, System::String ^ value);
public void WriteElementString(string localName, 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

Místní název elementu.

value
String

Hodnota elementu.

Výjimky

ArgumentException

Hodnota localName je null nebo prázdný řetězec.

nebo

Hodnoty parametrů nejsou platné.

EncoderFallbackException

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro kódování výstupu. Pokud je například kódování výstupu ASCII, měli byste pro názvy elementů a atributů použít pouze znaky z rozsahu 0 až 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapisovat do vyrovnávací paměti. Tyto znaky jsou řídicími znaky odkazy na entity znaků, pokud je to možné (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech prvků a atributů, komentářích, pokynech ke zpracování nebo částech CDATA.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad používá několik metod zápisu k vytvoření 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

Poznámky

Asynchronní verzi této metody naleznete v tématu WriteElementStringAsync.

Platí pro

WriteElementString(String, String, String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Zapíše prvek se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.

public:
 void WriteElementString(System::String ^ localName, System::String ^ ns, System::String ^ value);
public void WriteElementString(string localName, string ns, 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

Místní název elementu.

ns
String

Identifikátor URI oboru názvů, který chcete přidružit k elementu.

value
String

Hodnota elementu.

Výjimky

ArgumentException

Hodnota localName je null nebo prázdný řetězec.

nebo

Hodnoty parametrů nejsou platné.

EncoderFallbackException

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro kódování výstupu. Pokud je například kódování výstupu ASCII, měli byste pro názvy elementů a atributů použít pouze znaky z rozsahu 0 až 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapisovat do vyrovnávací paměti. Tyto znaky jsou řídicími znaky odkazy na entity znaků, pokud je to možné (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech prvků a atributů, komentářích, pokynech ke zpracování nebo částech CDATA.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad používá několik metod zápisu k vytvoření 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

Poznámky

Asynchronní verzi této metody naleznete v tématu WriteElementStringAsync.

Platí pro

WriteElementString(String, String, String, String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Zapíše prvek se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.

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);
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

Předpona elementu.

localName
String

Místní název elementu.

ns
String

Identifikátor URI oboru názvů elementu.

value
String

Hodnota elementu.

Výjimky

ArgumentException

Hodnota localName je null nebo prázdný řetězec.

nebo

Hodnoty parametrů nejsou platné.

EncoderFallbackException

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro kódování výstupu. Pokud je například kódování výstupu ASCII, měli byste pro názvy elementů a atributů použít pouze znaky z rozsahu 0 až 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapisovat do vyrovnávací paměti. Tyto znaky jsou řídicími znaky odkazy na entity znaků, pokud je to možné (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech prvků a atributů, komentářích, pokynech ke zpracování nebo částech CDATA.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Poznámky

Asynchronní verzi této metody naleznete v tématu WriteElementStringAsync.

Platí pro