XmlWriter.WriteQualifiedName(String, String) 메서드

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

파생 클래스에서 재정의되면 네임스페이스로 한정된 이름을 작성합니다. 이 메서드는 지정된 네임스페이스의 범위에 속하는 접두사를 찾습니다.

public:
 virtual void WriteQualifiedName(System::String ^ localName, System::String ^ ns);

public virtual void WriteQualifiedName (string localName, string? ns);

abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit

Public Overridable Sub WriteQualifiedName (localName As String, ns As String)

매개 변수

localName

String

작성할 로컬 이름입니다.

ns

String

이름의 네임스페이스 URI입니다.

예외

ArgumentException

localName가 null 또는 String.Empty입니다.

localName이 올바른 이름이 아닌 경우

InvalidOperationException

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

예제

이 예제에서는 다음 요소를 씁니다.

<root xmlns:x="urn:abc">
  <item href="#x:test"/>
</root>

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings))
{
    writer.WriteStartElement("root");
    writer.WriteAttributeString("xmlns", "x", null, "urn:abc");
    writer.WriteStartElement("item");
    writer.WriteStartAttribute("href", null);
    writer.WriteString("#");
    writer.WriteQualifiedName("test", "urn:abc");
    writer.WriteEndAttribute();
    writer.WriteEndElement();
    writer.WriteEndElement();
}

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.OmitXmlDeclaration = True
Using writer As XmlWriter = XmlWriter.Create(Console.Out, settings)
  writer.WriteStartElement("root")
  writer.WriteAttributeString("xmlns", "x", Nothing, "urn:abc")
  writer.WriteStartElement("item")
  writer.WriteStartAttribute("href", Nothing)
  writer.WriteString("#")
  writer.WriteQualifiedName("test", "urn:abc")
  writer.WriteEndAttribute()
  writer.WriteEndElement()
  writer.WriteEndElement()
End Using

설명

현재 기본 네임스페이스에 매핑되는 경우 ns 접두사는 생성되지 않습니다.

특성 값을 작성할 때 이 메서드는 가 없는 경우 ns 접두사를 생성합니다. 요소 콘텐츠를 작성할 때 가 없으면 ns 예외가 throw됩니다.

참고

에서 파생된 클래스가 재정의 XmlWriter 되지 않는 경우 이 메서드 localName 는 유효한 W3C XML 이름으로 확인되지 않습니다. 이 경우 이 메서드를 호출하기 전에 메서드를 통해 IsName 문자열의 유효성을 확인할 수 있습니다.

이 메서드의 비동기 버전은 를 참조하세요 WriteQualifiedNameAsync.