Aracılığıyla paylaş


XmlWriter.WriteElementString Yöntem

Tanım

Dize değeri içeren bir öğe yazar.

Aşırı Yüklemeler

WriteElementString(String, String)

Belirtilen yerel ada ve değere sahip bir öğe yazar.

WriteElementString(String, String, String)

Belirtilen yerel ada, ad alanı URI'sine ve değere sahip bir öğe yazar.

WriteElementString(String, String, String, String)

Belirtilen ön ek, yerel ad, ad alanı URI'si ve değere sahip bir öğe yazar.

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteElementStringAsync. .

WriteElementString(String, String)

Belirtilen yerel ada ve değere sahip bir öğe yazar.

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)

Parametreler

localName
String

Öğesinin yerel adı.

value
String

öğesinin değeri.

Özel durumlar

localName Değer veya boş bir dizedirnull.

-veya- Parametre değerleri geçerli değil.

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnekte, XML parçası oluşturmak için birkaç yazma yöntemi kullanılır.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"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 != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}
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

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteElementStringAsync. .

Şunlara uygulanır

WriteElementString(String, String, String)

Belirtilen yerel ada, ad alanı URI'sine ve değere sahip bir öğe yazar.

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)

Parametreler

localName
String

Öğesinin yerel adı.

ns
String

öğesiyle ilişkilendirilecek ad alanı URI'si.

value
String

öğesinin değeri.

Özel durumlar

localName Değer veya boş bir dizedirnull.

-veya- Parametre değerleri geçerli değil.

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnekte, XML parçası oluşturmak için birkaç yazma yöntemi kullanılır.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"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 != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}
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

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteElementStringAsync. .

Şunlara uygulanır

WriteElementString(String, String, String, String)

Belirtilen ön ek, yerel ad, ad alanı URI'si ve değere sahip bir öğe yazar.

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)

Parametreler

prefix
String

öğesinin ön eki.

localName
String

Öğesinin yerel adı.

ns
String

öğesinin ad alanı URI'si.

value
String

öğesinin değeri.

Özel durumlar

localName Değer veya boş bir dizedirnull.

-veya- Parametre değerleri geçerli değil.

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteElementStringAsync. .

Şunlara uygulanır