XmlWriter.WriteStartElement Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.ReaderWriter.dll

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

När du åsidosättas i en härledd klass skriver du den angivna starttaggen.

Överlagringar

Name	Description
WriteStartElement(String)	När du åsidosättas i en härledd klass skriver du ut en starttagg med det angivna lokala namnet.
WriteStartElement(String, String)	När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet.
WriteStartElement(String, String, String)	När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet och prefixet.

Kommentarer

Den asynkrona versionen av den här metoden finns i WriteStartElementAsync.

WriteStartElement(String)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

När du åsidosättas i en härledd klass skriver du ut en starttagg med det angivna lokala namnet.

public:
 void WriteStartElement(System::String ^ localName);

public void WriteStartElement(string localName);

member this.WriteStartElement : string -> unit

Public Sub WriteStartElement (localName As String)

Parametrar

localName: String

Elementets lokala namn.

Undantag

InvalidOperationException

Författaren är stängd.

-eller-

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

EncoderFallbackException

Det finns ett tecken i bufferten som är ett giltigt XML-tecken men som inte är giltigt för utdatakodningen. Om utdatakodningen till exempel är ASCII bör du bara använda tecken från intervallet 0 till 127 för element- och attributnamn. Det ogiltiga tecknet kan finnas i argumentet för den här metoden eller i ett argument med tidigare metoder som skrev till bufferten. Sådana tecken kringgås av teckenentitetsreferenser när det är möjligt (till exempel i textnoder eller attributvärden). Teckenentitetsreferensen tillåts dock inte i element- och attributnamn, kommentarer, bearbetningsinstruktioner eller CDATA-avsnitt.

Exempel

I följande exempel skrivs en XML-nod.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the book element.
     writer.WriteStartElement("book");

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML and close the writer.
     writer.Close();
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings)

     ' Write the book element.
     writer.WriteStartElement("book")
        
     ' Write the title element.
     writer.WriteStartElement("title")
     writer.WriteString("Pride And Prejudice")
     writer.WriteEndElement()
        
     ' Write the close tag for the root element.
     writer.WriteEndElement()
        
     ' Write the XML and close the writer.
     writer.Close()

  End Sub
End Class

Kommentarer

Den asynkrona versionen av den här metoden finns i WriteStartElementAsync.

Gäller för

WriteStartElement(String, String)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet.

public:
 void WriteStartElement(System::String ^ localName, System::String ^ ns);

public void WriteStartElement(string localName, string ns);

public void WriteStartElement(string localName, string? ns);

member this.WriteStartElement : string * string -> unit

Public Sub WriteStartElement (localName As String, ns As String)

Parametrar

localName: String

Elementets lokala namn.

ns: String

Den namnområdes-URI som ska associeras med elementet. Om det här namnområdet redan finns i omfånget och har ett associerat prefix skriver skrivaren automatiskt även prefixet.

Undantag

InvalidOperationException

Författaren är stängd.

-eller-

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

EncoderFallbackException

Kommentarer

När du har anropat den här metoden kan du antingen skriva attribut eller skapa innehåll med hjälp av WriteComment, WriteStringeller WriteStartElement för underordnade element. Du kan stänga elementet med antingen WriteEndElement eller WriteFullEndElement. Till exempel följande C#-kod:

writer.WriteStartElement("item",null);
writer.WriteString("some text");
writer.WriteEndElement();

Genererar följande utdata:

<item>some text</item>

Den asynkrona versionen av den här metoden finns i WriteStartElementAsync.

Gäller för

WriteStartElement(String, String, String)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet och prefixet.

public:
 abstract void WriteStartElement(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartElement(string prefix, string localName, string ns);

public abstract void WriteStartElement(string? prefix, string localName, string? ns);

abstract member WriteStartElement : string * string * string -> unit

Public MustOverride Sub WriteStartElement (prefix As String, localName As String, ns As String)

Parametrar

prefix: String

Elementets namnområdesprefix.

localName: String

Elementets lokala namn.

ns: String

Den namnområdes-URI som ska associeras med elementet.

Undantag

InvalidOperationException

Författaren är stängd.

-eller-

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

EncoderFallbackException

Exempel

I följande exempel skrivs ett XML-fragment ut.

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

Kommentarer

Den asynkrona versionen av den här metoden finns i WriteStartElementAsync.

Gäller för

Feedback

Var den här sidan till hjälp?