XmlWriter.WriteAttributeString 메서드

정의

네임스페이스:
System.Xml
어셈블리:
System.Xml.dll, System.Xml.ReaderWriter.dll
어셈블리:
netstandard.dll, System.Xml.ReaderWriter.dll
어셈블리:
System.Xml.ReaderWriter.dll
어셈블리:
System.Xml.dll
어셈블리:
netstandard.dll

파생 클래스에서 재정의되는 경우 지정된 값을 사용하여 특성을 씁니다.

오버로드

Name Description
WriteAttributeString(String, String, String, String)

파생 클래스에서 재정의된 경우 지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 씁니다.
WriteAttributeString(String, String, String)

파생 클래스에서 재정의되는 경우 지정된 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 씁니다.
WriteAttributeString(String, String)

파생 클래스에서 재정의되는 경우 지정된 로컬 이름과 값을 사용하여 특성을 씁니다.

설명

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

WriteAttributeString(String, String, String, String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

파생 클래스에서 재정의된 경우 지정된 접두사, 로컬 이름, 네임스페이스 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

또는 localNamens 입니다 null.

예제

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

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와 연결합니다. 이 경우 인수는 .일 ns 수 있습니다 null.

WriteAttributeString 은 다음을 수행합니다.

  • 특성 값에 큰따옴표 또는 작은따옴표가 포함된 경우 각각과 함께 "' 바뀝니다.

  • 특성을 작성하는 xml:space 경우 작성기는 특성 값이 유효한지 확인합니다. (유효한 값은 preserve . default)

  • 특성을 작성하는 xml:lang 경우 작성기는 W3C XML 1.0 권장 사항에 따라 특성 값이 유효한지 확인하지 않습니다.

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

적용 대상

WriteAttributeString(String, String, String)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

파생 클래스에서 재정의되는 경우 지정된 로컬 이름, 네임스페이스 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 거나 작성기가 닫혀 있습니다.

-또는-

XmlWriter 이전 비동기 작업이 완료되기 전에 메서드가 호출되었습니다. 이 경우 InvalidOperationException "비동기 작업이 이미 진행 중입니다."라는 메시지와 함께 throw됩니다.

ArgumentException

xml:space 또는 xml:lang 특성 값이 잘못되었습니다.

예제

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

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)

Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

파생 클래스에서 재정의되는 경우 지정된 로컬 이름과 값을 사용하여 특성을 씁니다.

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;
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.

적용 대상