XmlElement.Prefix Свойство

Определение

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

System.Xml

Сборки:

System.Xml.dll, System.Xml.XmlDocument.dll

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.XmlDocument.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Возвращает или задает префикс пространства имен данного узла.

public:
 virtual property System::String ^ Prefix { System::String ^ get(); void set(System::String ^ value); };

public override string Prefix { get; set; }

member this.Prefix : string with get, set

Public Overrides Property Prefix As String

Значение свойства

String

Префикс пространства имен данного узла. Если префикс отсутствует, данное свойство возвращает String.Empty.

Исключения

ArgumentException

Этот узел доступен только для чтения.

XmlException

Указанный префикс содержит недопустимый символ.

Указанный префикс имеет неправильный формат.

URI пространства имен данного узла является null.

Указанный префикс — "xml", а URI пространства имен данного узла отличается от http://www.w3.org/XML/1998/namespace.

Примеры

В следующем примере отображаются сведения об элементе ISBN.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book xmlns:bk='urn:samples'>"
   "<bk:ISBN>1-861001-57-5</bk:ISBN>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   
   // Display information on the ISBN element.
   XmlElement^ elem = dynamic_cast<XmlElement^>(doc->DocumentElement->FirstChild);
   Console::Write( "{0}:{1} = {2}", elem->Prefix, elem->LocalName, elem->InnerText );
   Console::WriteLine( "\t namespaceURI={0}", elem->NamespaceURI );
}

// This code produces the following output.
// bk:ISBN = 1-861001-57-5  namespaceURI=urn:samples

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples'>" +
                "<bk:ISBN>1-861001-57-5</bk:ISBN>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    // Display information on the ISBN element.
    XmlElement elem = (XmlElement) doc.DocumentElement.FirstChild;
    Console.Write("{0}:{1} = {2}", elem.Prefix, elem.LocalName, elem.InnerText);
    Console.WriteLine("\t namespaceURI=" + elem.NamespaceURI);
  }
}

// This code produces the following output.
// bk:ISBN = 1-861001-57-5  namespaceURI=urn:samples

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book xmlns:bk='urn:samples'>" & _
                "<bk:ISBN>1-861001-57-5</bk:ISBN>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")

    ' Display information on the ISBN element.
    Dim elem as XmlElement 
    elem = CType(doc.DocumentElement.ChildNodes.Item(0),XmlElement) 
    Console.Write("{0}:{1} = {2}", elem.Prefix, elem.LocalName, elem.InnerText)
    Console.WriteLine("  namespaceURI=" + elem.NamespaceURI)
  end sub
end class

' This code produces the following output.
' bk:ISBN = 1-861001-57-5  namespaceURI=urn:samples

Комментарии

Задание этого свойства изменяет Name свойство, которое содержит полное имя для XmlElementобъекта . Однако изменение префикса не изменяет универсальный код ресурса (URI) пространства имен элемента.