XmlWriter.WriteStartElement Método

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblies:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Quando substituído em uma classe derivada, grava a marca inicial especificada.

Sobrecargas

Nome Description
WriteStartElement(String)

Quando substituído em uma classe derivada, grava uma marca inicial com o nome local especificado.
WriteStartElement(String, String)

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace fornecido.
WriteStartElement(String, String, String)

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace e ao prefixo fornecidos.

Comentários

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

WriteStartElement(String)

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

Quando substituído em uma classe derivada, grava uma marca inicial 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 gravador está fechado.

- ou -

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

EncoderFallbackException

Há um caractere no buffer que é um caractere 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, você deverá usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O caractere inválido pode estar no argumento desse método ou em um argumento de métodos anteriores que estavam gravando no buffer. Esses caracteres são escapados por referências de entidade de caractere quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caractere não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou seções CDATA.

Exemplos

O exemplo a seguir grava 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

Comentários

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

Aplica-se a

WriteStartElement(String, String)

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

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace fornecido.

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 a ser associado ao elemento. Se esse namespace já estiver no escopo e tiver um prefixo associado, o gravador também gravará automaticamente esse prefixo.

Exceções

InvalidOperationException

O gravador está fechado.

- ou -

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

EncoderFallbackException

Há um caractere no buffer que é um caractere 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, você deverá usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O caractere inválido pode estar no argumento desse método ou em um argumento de métodos anteriores que estavam gravando no buffer. Esses caracteres são escapados por referências de entidade de caractere quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caractere não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou seções CDATA.

Comentários

Depois de chamar esse método, você pode escrever atributos ou criar conteúdo usando WriteComment, WriteStringou WriteStartElement para elementos filho. Você pode fechar o elemento com ou WriteEndElementWriteFullEndElement. Por exemplo, o seguinte código C#:

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

Isso gera a saída a seguir:

<item>some text</item>

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

Aplica-se a

WriteStartElement(String, String, String)

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

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace e ao prefixo fornecidos.

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 do namespace do elemento.

localName
String

O nome local do elemento.

ns
String

O URI do namespace a ser associado ao elemento.

Exceções

InvalidOperationException

O gravador está fechado.

- ou -

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

EncoderFallbackException

Há um caractere no buffer que é um caractere 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, você deverá usar apenas caracteres do intervalo de 0 a 127 para nomes de elementos e atributos. O caractere inválido pode estar no argumento desse método ou em um argumento de métodos anteriores que estavam gravando no buffer. Esses caracteres são escapados por referências de entidade de caractere quando possível (por exemplo, em nós de texto ou valores de atributo). No entanto, a referência de entidade de caractere não é permitida em nomes de elementos e atributos, comentários, instruções de processamento ou seções CDATA.

Exemplos

O exemplo a seguir grava 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

Comentários

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

Aplica-se a