XmlElement.Prefix XmlElement.Prefix XmlElement.Prefix XmlElement.Prefix Property

定義

取得或設定這個節點的命名空間前置詞。Gets or sets the namespace prefix of this node.

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

屬性值

這個節點的命名空間前置詞。The namespace prefix of this node. 如果沒有前置詞,則這個屬性會傳回 String.Empty。If there is no prefix, this property returns String.Empty.

例外狀況

這個節點是唯讀的。This node is read-only

指定的前置詞包含無效的字元。The specified prefix contains an invalid character.

指定的前置詞格式不正確。The specified prefix is malformed.

這個節點的 namespaceURI 為 nullThe namespaceURI of this node is null.

指定的前置詞為 "xml",且此節點的 namespaceURI 與 http://www.w3.org/XML/1998/namespace (英文) 的不同。The specified prefix is "xml" and the namespaceURI of this node is different from http://www.w3.org/XML/1998/namespace.

範例

下列範例會顯示 ISBN 元素的資訊。The following example displays information on the ISBN element.

#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屬性, 其中保存的限定名稱。 XmlElementSetting this property changes the Name property, which holds the qualified name for an XmlElement. 不過, 變更前置詞並不會變更元素的命名空間 URI。However, changing the prefix does not change the namespace URI of the element.

適用於