XmlWriter.WriteAttributes-Methode

Schreibt beim Überschreiben in einer abgeleiteten Klasse sämtliche an der aktuellen Position gefundenen Attribute in den XmlReader.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Sub WriteAttributes ( _
    reader As XmlReader, _
    defattr As Boolean _
)
'Usage
Dim instance As XmlWriter
Dim reader As XmlReader
Dim defattr As Boolean

instance.WriteAttributes(reader, defattr)

public virtual void WriteAttributes (
    XmlReader reader,
    bool defattr
)

public:
virtual void WriteAttributes (
    XmlReader^ reader, 
    bool defattr
)

public void WriteAttributes (
    XmlReader reader, 
    boolean defattr
)

public function WriteAttributes (
    reader : XmlReader, 
    defattr : boolean
)

Parameter

• reader
  Der XmlReader, aus dem die Attribute kopiert werden sollen.

• defattr
  true, um die Standardattribute aus dem XmlReader zu kopieren, andernfalls false.

Ausnahmen

Hinweise

Wenn der Reader auf einem element-Knoten positioniert ist, kopiert WriteAttributes alle darin enthaltenen Attribute. Wenn der Reader auf einem attribute-Knoten positioniert ist, schreibt diese Methode das aktuelle Attribut und anschließend die verbleibenden Attribute bis zum Endtag des Elements. Wenn der Reader auf einem XmlDeclaration-Knoten positioniert ist, schreibt diese Methode sämtliche Attribute in der Deklaration. Wenn der Reader auf einem anderen Knotentyp positioniert ist, löst diese Methode eine XmlException aus.

Beim Aufruf dieser Methode mit XmlValidatingReader werden alle Inhalte, die aus den Entitäten erweitert wurden und zu einem ungültigen Dokument führen könnten, beim Schreiben ersetzt, um wohlgeformten XML-Code zu gewährleisten. Wenn ein Attribut z. B. eine erweiterte >-Entität enthält, wird das erweiterte ">" beim Schreiben durch > ersetzt, um ein wohlgeformtes Dokument zu gewährleisten.

Beispiel

Im folgenden Beispiel werden alle Elemente in die Ausgabe kopiert, die Tagnamen in Großbuchstaben umgewandelt und sämtliche nicht geänderten Attribute kopiert.

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

    Dim reader As XmlReader = XmlReader.Create("test1.xml")
    Dim settings As XmlWriterSettings = new XmlWriterSettings()
    settings.Indent = true
    Dim writer As XmlWriter = XmlWriter.Create(Console.Out)
        
      While reader.Read()
          If reader.NodeType = XmlNodeType.Element Then
              writer.WriteStartElement(reader.Name.ToUpper())
              writer.WriteAttributes(reader, False)
              If reader.IsEmptyElement Then
                 writer.WriteEndElement()
              End If
          Else
              If reader.NodeType = XmlNodeType.EndElement Then
                  writer.WriteEndElement()
              End If
          End If
      End While
      writer.Close()
      reader.Close()

    End Sub 'Main
End Class 'Sample

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

public class Sample {

  public static void Main() {
 
    XmlReader reader = XmlReader.Create("test1.xml");
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Indent = true;
    XmlWriter writer = XmlWriter.Create(Console.Out);

    while (reader.Read()) {
      if (reader.NodeType == XmlNodeType.Element) {
        writer.WriteStartElement(reader.Name.ToUpper());
        writer.WriteAttributes(reader, false);
        if (reader.IsEmptyElement) writer.WriteEndElement();
      }
      else if (reader.NodeType == XmlNodeType.EndElement) {
        writer.WriteEndElement();
      }
    }
    writer.Close();
    reader.Close();
  }
}

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlReader^ reader = XmlReader::Create( L"test1.xml" );
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out );
   while ( reader->Read() )
   {
      if ( reader->NodeType == XmlNodeType::Element )
      {
         writer->WriteStartElement( reader->Name->ToUpper() );
         writer->WriteAttributes( reader, false );
         if ( reader->IsEmptyElement )
                  writer->WriteEndElement();
      }
      else
      if ( reader->NodeType == XmlNodeType::EndElement )
      {
         writer->WriteEndElement();
      }
   }

   writer->Close();
   reader->Close();
}

Im Beispiel wird die Datei test1.xml als Eingabe verwendet.

<test a="1" b="2">
    <item c="3" d="4" e="5" f="6"/>
</test>

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlWriter-Klasse
XmlWriter-Member
System.Xml-Namespace

Weitere Ressourcen

Schreiben von XML mit dem "XmlWriter"