XmlWriter.WriteAttributeString 메서드

참조

정의

네임스페이스:: System.Xml

어셈블리:: System.Xml.ReaderWriter.dll

어셈블리:: System.Xml.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

파생 클래스에서 재정의되면 지정된 값이 있는 특성을 작성합니다.

오버로드

WriteAttributeString(String, String, String, String)	파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.
WriteAttributeString(String, String, String)	파생 클래스에서 재정의되면 지정된 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.
WriteAttributeString(String, String)	파생 클래스에서 재정의되면 지정된 로컬 이름 및 값이 있는 특성을 작성합니다.

설명

이 메서드의 비동기 버전은 다음을 참조하세요 WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.

public:
 void WriteAttributeString(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public void WriteAttributeString (string prefix, string localName, string ns, string value);

public void WriteAttributeString (string? prefix, string localName, string? ns, string? value);

member this.WriteAttributeString : string * string * string * string -> unit

Public Sub WriteAttributeString (prefix As String, localName As String, ns As String, value As String)

매개 변수

prefix: String

특성의 네임스페이스 접두사입니다.

localName: String

특성의 로컬 이름입니다.

ns: String

특성의 네임스페이스 URI입니다.

value: String

특성 값

예외

InvalidOperationException

판독기 상태가 WriteState.Element가 아니거나 판독기가 닫힌 경우

또는 이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

ArgumentException

xml:space 또는 xml:lang 특성 값이 잘못된 경우

XmlException

localName 또는 ns가 null인 경우

예제

다음 예제에서는 메서드를 WriteAttributeString 사용하여 네임스페이스 선언을 작성합니다.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"19.95" );
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML to file and close the writer.
   writer->Flush();
   writer->Close();
}

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

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

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

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

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

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

설명

이 메서드는 사용자 정의 네임스페이스 접두사로 특성을 작성하고 지정된 네임스페이스와 연결합니다. 접두사 "xmlns"인 경우 이 메서드는 이를 네임스페이스 선언으로 처리하고 선언된 접두사와 지정된 특성 값에 제공된 네임스페이스 URI를 연결합니다. 이 경우 인수null는 .ns

WriteAttributeString은 다음을 수행합니다.

특성 값에 큰따옴표 또는 큰따옴표가 포함된 경우 각각과 함께 " ' 바뀝니다.
특성을 작성하는 xml:space 경우 작성기는 특성 값이 유효한지 확인합니다. (유효한 값은 preserve 또는 default.)
특성을 작성하는 xml:lang 경우 작성기는 W3C XML 1.0 권장 사항에 따라 특성 값이 유효한지 확인하지 않습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteAttributeStringAsync.

적용 대상

WriteAttributeString(String, String, String)

파생 클래스에서 재정의되면 지정된 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.

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

public void WriteAttributeString (string localName, string ns, string value);

public void WriteAttributeString (string localName, string? ns, string? value);

member this.WriteAttributeString : string * string * string -> unit

Public Sub WriteAttributeString (localName As String, ns As String, value As String)

매개 변수

localName: String

특성의 로컬 이름입니다.

ns: String

특성에 연결할 네임스페이스 URI입니다.

value: String

특성 값

예외

InvalidOperationException

판독기 상태가 WriteState.Element가 아니거나 판독기가 닫힌 경우

ArgumentException

xml:space 또는 xml:lang 특성 값이 잘못된 경우

예제

다음 예제에서는 메서드를 WriteAttributeString 사용하여 네임스페이스 선언을 작성합니다.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"19.95" );
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML to file and close the writer.
   writer->Flush();
   writer->Close();
}

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

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

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

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

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

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

설명

이 메서드는 사용자 정의 네임스페이스 접두사로 특성을 작성하고 지정된 네임스페이스와 연결합니다. "xmlns"이면 localName 이 메서드도 이를 네임스페이스 선언으로 처리합니다. 이 경우 인수는 .일 ns 수 있습니다 null.

WriteAttributeString은 다음을 수행합니다.

특성 값에 큰따옴표 또는 큰따옴표가 포함된 경우 각각과 함께 " ' 바뀝니다.
특성을 작성하는 xml:space 경우 작성기는 특성 값이 유효한지 확인합니다. (유효한 값은 preserve 또는 default.)
특성을 작성하는 xml:lang 경우 작성기는 W3C XML 1.0 권장 사항에 따라 특성 값이 유효한지 확인하지 않습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteAttributeStringAsync.

적용 대상

WriteAttributeString(String, String)

파생 클래스에서 재정의되면 지정된 로컬 이름 및 값이 있는 특성을 작성합니다.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ value);

public void WriteAttributeString (string localName, string value);

public void WriteAttributeString (string localName, string? value);

member this.WriteAttributeString : string * string -> unit

Public Sub WriteAttributeString (localName As String, value As String)

매개 변수

localName: String

특성의 로컬 이름입니다.

value: String

특성 값

예외

InvalidOperationException

판독기 상태가 WriteState.Element가 아니거나 판독기가 닫힌 경우

또는

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

ArgumentException

xml:space 또는 xml:lang 특성 값이 잘못된 경우

예제

다음 예제에서는 책을 씁니다.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"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 != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

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

설명

WriteAttributeString은 다음을 수행합니다.

특성 값에 큰따옴표 또는 큰따옴표가 포함된 경우 각각과 함께 " ' 바뀝니다.
특성을 작성하는 xml:space 경우 작성기는 특성 값이 유효한지 확인합니다. (유효한 값은 preserve 또는 default.)
특성을 작성하는 xml:lang 경우 작성기는 W3C XML 1.0 권장 사항에 따라 특성 값이 유효한지 확인하지 않습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteAttributeStringAsync.

적용 대상

XmlWriter.WriteAttributeString 메서드

정의

오버로드

설명

WriteAttributeString(String, String, String, String)

매개 변수

예외

예제

설명

적용 대상

WriteAttributeString(String, String, String)

매개 변수

예외

예제

설명

적용 대상

WriteAttributeString(String, String)

매개 변수

예외

예제

설명

적용 대상

추가 리소스