XmlWriter.WriteAttributes(XmlReader, Boolean) XmlWriter.WriteAttributes(XmlReader, Boolean) XmlWriter.WriteAttributes(XmlReader, Boolean) XmlWriter.WriteAttributes(XmlReader, Boolean) Method


派生クラスでオーバーライドされると、XmlReader の現在の位置で見つかったすべての属性を書き込みます。When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

 virtual void WriteAttributes(System::Xml::XmlReader ^ reader, bool defattr);
public virtual void WriteAttributes (System.Xml.XmlReader reader, bool defattr);
abstract member WriteAttributes : System.Xml.XmlReader * bool -> unit
override this.WriteAttributes : System.Xml.XmlReader * bool -> unit
Public Overridable Sub WriteAttributes (reader As XmlReader, defattr As Boolean)


XmlReader XmlReader XmlReader XmlReader

属性のコピー元の XmlReaderThe XmlReader from which to copy the attributes.

Boolean Boolean Boolean Boolean

XmlReader の既定の属性をコピーする場合は true。それ以外の場合は falsetrue to copy the default attributes from the XmlReader; otherwise, false.


リーダーが element ノード、attribute ノード、または XmlDeclaration ノードに配置されていません。The reader is not positioned on an element, attribute or XmlDeclaration node.

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

次の例は、すべての要素を出力にコピー、タグ名を大文字に変更し、変更されていないすべての属性をコピーします。The following example copies all the elements to the output, changes the tag names to upper case, and copies all the attributes unchanged.

#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 )
      if ( reader->NodeType == XmlNodeType::EndElement )

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.WriteAttributes(reader, false);
        if (reader.IsEmptyElement) writer.WriteEndElement();
      else if (reader.NodeType == XmlNodeType.EndElement) {
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.WriteAttributes(reader, False)
              If reader.IsEmptyElement Then
              End If
              If reader.NodeType = XmlNodeType.EndElement Then
              End If
          End If
      End While

    End Sub 'Main
End Class 'Sample

例では、ファイルを使用してtest1.xml、入力として。The example uses the file, test1.xml, as input.

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


リーダーが配置されている場合、elementノードWriteAttributes含まれているすべての属性をコピーします。If the reader is positioned on an element node WriteAttributes copies all the contained attributes. リーダーが配置されている場合、attributeノード、このメソッドは書き込みますし、現在の属性、属性の残りの部分要素の終了タグまでです。If the reader is positioned on an attribute node, this method writes the current attribute, then the rest of the attributes until the element closing tag. リーダーが配置されている場合、XmlDeclaration宣言でノードで、このメソッドの書き込みのすべての属性。If the reader is positioned on an XmlDeclaration node, this method writes all the attributes in the declaration. このメソッドはスローの他のノード型にリーダーが配置されている場合、XmlExceptionします。If the reader is positioned on any other node type this method throws an XmlException.

使用して、このメソッドが呼び出された場合XmlValidatingReader、整形式 XML ドキュメントは無効になる可能性があります (これは、エンティティから拡張された) 内容が書き込まれるときに置き換えられますことを確認します。If this method is called using XmlValidatingReader, to ensure well-formed XML any content (which has been expanded from the entities) that could result in an invalid document is replaced when written. たとえば、属性が含まれている場合、&gt;整形式ドキュメントは、展開されていることを確認して、展開されているエンティティ > は、書き込み時に置き換えられます&gt;For example, if an attribute includes an &gt; entity that has been expanded, to ensure a well-formed document the expanded > is replaced when written out with &gt;.

このメソッドの非同期バージョンを参照してください。WriteAttributesAsyncします。For the asynchronous version of this method, see WriteAttributesAsync.