XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) Method

정의

파생 클래스에서 재정의되면 네임스페이스로 한정된 이름을 작성합니다.When overridden in a derived class, writes out the namespace-qualified name. 이 메서드는 지정된 네임스페이스의 범위에 속하는 접두사를 찾습니다.This method looks up the prefix that is in scope for the given namespace.

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 String String String

작성할 로컬 이름입니다.The local name to write.

ns
String String String String

이름의 네임스페이스 URI입니다.The namespace URI for the name.

예외

localNamenull 또는 String.Empty입니다.localName is either null or String.Empty.

localName이 올바른 이름이 아닌 경우localName is not a valid name.

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

예제

이 예제에서는 다음 요소를 씁니다.The example writes the following element:

<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 매핑되는 현재 기본 네임 스페이스 접두사가 생성 됩니다.If ns maps to the current default namespace, no prefix is generated.

특성 값을 작성할 때이 메서드는 경우 접두사를 생성 하는 ns 찾을 수 없습니다.When writing attribute values, this method generates a prefix if ns is not found. 요소 콘텐츠를 작성할 때 예외가 발생 하는 경우 ns 찾을 수 없습니다.When writing element content, it throws an exception if ns is not found.

참고

파생 된 클래스는 XmlWriter 이 메서드를 재정의 하지 않습니다 localName 유효한 W3C XML 이름으로 선택 하지 않으면.If a class derived from the XmlWriter does not override this method localName is not checked to be a valid W3C XML name. 이 경우이 메서드를 호출 하기 전에 문자열의 유효성을 검사 여 확인할 수 있습니다 IsName 메서드.In such case, before calling this method, the validity of the string can be checked by IsName method.

이 메서드의 비동기 버전을 참조 하세요. WriteQualifiedNameAsync합니다.For the asynchronous version of this method, see WriteQualifiedNameAsync.

적용 대상