XmlElement.Prefix 屬性

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlElement.cs

取得或設定這個節點的命名空間前置詞。

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

指定的前置詞包含無效的字元。

指定的前置詞格式不正確。

此節點的 namespaceURI 為 null。

指定的前置詞為 "xml"，且此節點的 namespaceURI 與 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。