XmlWriter.WriteStartElement Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Quando sobrescrito numa classe derivada, escreve a etiqueta inicial especificada.

Sobrecargas

Name Description
WriteStartElement(String)

Quando sobrescrito numa classe derivada, escreve uma etiqueta de início com o nome local especificado.
WriteStartElement(String, String)

Quando sobrescrito numa classe derivada, escreve a etiqueta inicial especificada e associa-a ao namespace dado.
WriteStartElement(String, String, String)

Quando sobreposta numa classe derivada, escreve a etiqueta inicial especificada e associa-a ao namespace e prefixo dados.

Observações

Para a versão assíncrona deste método, veja WriteStartElementAsync.

WriteStartElement(String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

Quando sobrescrito numa classe derivada, escreve uma etiqueta de início com o nome local especificado.

public:
 void WriteStartElement(System::String ^ localName);
public void WriteStartElement(string localName);
member this.WriteStartElement : string -> unit
Public Sub WriteStartElement (localName As String)

Parâmetros

localName
String

O nome local do elemento.

Exceções

InvalidOperationException

O escritor está fechado.

-ou-

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

EncoderFallbackException

Existe um carácter no buffer que é um carácter XML válido, mas não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.

Exemplos

O exemplo seguinte escreve um nó XML.

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

Observações

Para a versão assíncrona deste método, veja WriteStartElementAsync.

Aplica-se a

WriteStartElement(String, String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

Quando sobrescrito numa classe derivada, escreve a etiqueta inicial especificada e associa-a ao namespace dado.

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)

Parâmetros

localName
String

O nome local do elemento.

ns
String

O URI do namespace para associar ao elemento. Se este namespace já estiver dentro do âmbito e tiver um prefixo associado, o autor também escreve automaticamente esse prefixo.

Exceções

InvalidOperationException

O escritor está fechado.

-ou-

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

EncoderFallbackException

Existe um carácter no buffer que é um carácter XML válido, mas não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.

Observações

Depois de chamar este método, pode escrever atributos, ou criar conteúdo usando WriteComment, WriteString, ou WriteStartElement para elementos filhos. Pode fechar o elemento com ou WriteEndElementWriteFullEndElement. Por exemplo, o seguinte código C#:

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

Gera a seguinte saída:

<item>some text</item>

Para a versão assíncrona deste método, veja WriteStartElementAsync.

Aplica-se a

WriteStartElement(String, String, String)

Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs
Origem:
XmlWriter.cs

Quando sobreposta numa classe derivada, escreve a etiqueta inicial especificada e associa-a ao namespace e prefixo dados.

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)

Parâmetros

prefix
String

O prefixo de namespace do elemento.

localName
String

O nome local do elemento.

ns
String

O URI do namespace para associar ao elemento.

Exceções

InvalidOperationException

O escritor está fechado.

-ou-

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

EncoderFallbackException

Existe um carácter no buffer que é um carácter XML válido, mas não é válido para a codificação de saída. Por exemplo, se a codificação de saída for ASCII, deve usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O carácter inválido pode estar no argumento deste método ou num argumento de métodos anteriores que estavam a escrever para o buffer. Tais caracteres são evitados por referências a entidades de carácter sempre que possível (por exemplo, em nós de texto ou valores de atributos). No entanto, a referência da entidade de carácter não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou secções CDATA.

Exemplos

O exemplo seguinte escreve um fragmento 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

Observações

Para a versão assíncrona deste método, veja WriteStartElementAsync.

Aplica-se a