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

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

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

Примеры

В примере записывается следующий элемент:

<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 оно не найдено.

Note

Если класс, производный от XmlWriter не переопределения этого метода localName , не проверяется, что он является допустимым XML-именем W3C. В таком случае перед вызовом этого метода допустимость строки можно проверить по методу IsName .

Сведения об асинхронной версии этого метода см. в разделе WriteQualifiedNameAsync.