XmlWriter.WriteElementString Метод

Определение

Пространство имен:: System.Xml

Сборки:: System.Xml.dll, System.Xml.ReaderWriter.dll

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает элемент, содержащий строковое значение.

Перегрузки

Имя	Описание
WriteElementString(String, String)	Записывает элемент с указанным локальным именем и значением.
WriteElementString(String, String, String)	Записывает элемент с указанным локальным именем, URI пространства имен и значением.
WriteElementString(String, String, String, String)	Записывает элемент с указанным префиксом, локальным именем, URI пространства имен и значением.

WriteElementString(String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает элемент с указанным локальным именем и значением.

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)

Параметры

localName: String

Локальное имя элемента.

value: String

Значение элемента.

Исключения

ArgumentException

Значение localName равно null или пустой строке.

–или–

Недопустимые значения параметров.

EncoderFallbackException

В буфере есть символ, который является допустимым XML-символом, но не является допустимым для кодирования выходных данных. Например, если кодирование выходных данных равно ASCII, следует использовать только символы из диапазона от 0 до 127 для имен элементов и атрибутов. Недопустимый символ может находиться в аргументе этого метода или в аргументе предыдущих методов, которые записывали в буфер. Такие символы экранируются ссылками на сущности символов, если это возможно (например, в текстовых узлах или значениях атрибутов). Однако ссылка на символьную сущность не допускается в разделах элементов и атрибутов, примечаний, инструкций по обработке или CDATA.

InvalidOperationException

Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

Примеры

В следующем примере для создания фрагмента 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

Применяется к

WriteElementString(String, String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает элемент с указанным локальным именем, URI пространства имен и значением.

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)

Параметры

localName: String

Локальное имя элемента.

ns: String

Универсальный код ресурса (URI) пространства имен для связывания с элементом.

value: String

Значение элемента.

Исключения

ArgumentException

Значение localName равно null или пустой строке.

–или–

Недопустимые значения параметров.

EncoderFallbackException

InvalidOperationException

Примеры

В следующем примере для создания фрагмента 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

Применяется к

WriteElementString(String, String, String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает элемент с указанным префиксом, локальным именем, URI пространства имен и значением.

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)

Параметры

prefix: String

Префикс элемента.

localName: String

Локальное имя элемента.

ns: String

URI пространства имен элемента.

value: String

Значение элемента.

Исключения

ArgumentException

Значение localName равно null или пустой строке.

–или–

Недопустимые значения параметров.

EncoderFallbackException

InvalidOperationException

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

XmlWriter.WriteElementString Метод

Определение

Перегрузки

Комментарии

WriteElementString(String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteElementString(String, String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteElementString(String, String, String, String)

Параметры

Исключения

Комментарии

Применяется к