XmlWriter.WriteElementString Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee schrijft u een element met een tekenreekswaarde.

Overloads

Name	Description
WriteElementString(String, String)	Hiermee schrijft u een element met de opgegeven lokale naam en waarde.
WriteElementString(String, String, String)	Hiermee schrijft u een element met de opgegeven lokale naam, naamruimte-URI en waarde.
WriteElementString(String, String, String, String)	Hiermee schrijft u een element met het opgegeven voorvoegsel, de lokale naam, de naamruimte-URI en de waarde.

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteElementStringAsync.

WriteElementString(String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een element met de opgegeven lokale naam en waarde.

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)

Parameters

localName: String

De lokale naam van het element.

value: String

De waarde van het element.

Uitzonderingen

ArgumentException

De localName waarde is null of een lege tekenreeks.

– of –

De parameterwaarden zijn ongeldig.

EncoderFallbackException

Er is een teken in de buffer dat een geldig XML-teken is, maar niet geldig is voor de uitvoercodering. Als de uitvoercodering bijvoorbeeld ASCII is, moet u alleen tekens uit het bereik van 0 tot 127 gebruiken voor element- en kenmerknamen. Het ongeldige teken kan in het argument van deze methode staan of in een argument van eerdere methoden die naar de buffer zijn geschreven. Dergelijke tekens worden indien mogelijk door tekenentiteitsverwijzingen escaped (bijvoorbeeld in tekstknooppunten of kenmerkwaarden). De verwijzing naar de tekenentiteit is echter niet toegestaan in element- en kenmerknamen, opmerkingen, verwerkingsinstructies of CDATA-secties.

InvalidOperationException

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Voorbeelden

In het volgende voorbeeld worden verschillende schrijfmethoden gebruikt om een XML-fragment te maken.

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

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteElementStringAsync.

Van toepassing op

WriteElementString(String, String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een element met de opgegeven lokale naam, naamruimte-URI en waarde.

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)

Parameters

localName: String

De lokale naam van het element.

ns: String

De naamruimte-URI die moet worden gekoppeld aan het element.

value: String

De waarde van het element.

Uitzonderingen

ArgumentException

De localName waarde is null of een lege tekenreeks.

– of –

De parameterwaarden zijn ongeldig.

EncoderFallbackException

InvalidOperationException

Voorbeelden

In het volgende voorbeeld worden verschillende schrijfmethoden gebruikt om een XML-fragment te maken.

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

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteElementStringAsync.

Van toepassing op

WriteElementString(String, String, String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een element met het opgegeven voorvoegsel, de lokale naam, de naamruimte-URI en de waarde.

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)

Parameters

prefix: String

Het voorvoegsel van het element.

localName: String

De lokale naam van het element.

ns: String

De naamruimte-URI van het element.

value: String

De waarde van het element.

Uitzonderingen

ArgumentException

De localName waarde is null of een lege tekenreeks.

– of –

De parameterwaarden zijn ongeldig.

EncoderFallbackException

InvalidOperationException

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteElementStringAsync.

Van toepassing op

Feedback

Is deze pagina nuttig?