XmlWriter.WriteQualifiedName(String, String) Метод

Определение

При переопределении в производном классе считывает полное имя пространства имен.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:
 abstract void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public virtual void WriteQualifiedName (string localName, string ns);
public abstract void WriteQualifiedName (string localName, string ns);
abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit
abstract member WriteQualifiedName : string * string -> unit
Public Overridable Sub WriteQualifiedName (localName As String, ns As String)
Public MustOverride Sub WriteQualifiedName (localName As String, ns As String)

Параметры

localName
String

Локальное имя для записи.The local name to write.

ns
String

URI пространства имен для имени.The namespace URI for the name.

Исключения

localName имеет значение null или 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 с сообщением "Асинхронная операция уже выполняется".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 не проверяется как допустимое имя XML консорциума W3C.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.

Применяется к