XmlElement.Prefix プロパティ
このノードの名前空間プリフィックスを取得または設定します。
Overrides Public Property Prefix As String
[C#]
public override string Prefix {get; set;}
[C++]
public: __property String* get_Prefix();public: __property void set_Prefix(String*);
[JScript]
public override function get Prefix() : String;public override function set Prefix(String);
プロパティ値
このノードの名前空間プリフィックス。プリフィックスがない場合、このプロパティは String.Empty を返します。
例外
例外の種類 | 条件 |
---|---|
ArgumentException | このノードは読み取り専用です。 |
XmlException | 指定したプリフィックスに無効な文字が含まれています。
指定されたプリフィックスの書式が正しくありません。 このノードの namespaceURI が null 参照 (Visual Basic では Nothing) です。 指定したプリフィックスが "xml" で、このノードの namespaceURI が http://www.w3.org/XML/1998/namespace と異なっています。 |
解説
このプロパティを設定すると、 XmlElement の限定名を保持している Name プロパティは変更されます。ただし、プリフィックスを変更しても要素の名前空間 URI は変更されません。
使用例
[Visual Basic, C#, C++] ISBN 要素に関する情報を表示する例を次に示します。
Imports System
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
[C#]
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);
}
}
[C++]
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
XmlDocument* doc = new XmlDocument();
doc->LoadXml(S"<book xmlns:bk='urn:samples'>"
S"<bk:ISBN>1-861001-57-5</bk:ISBN>"
S"<title>Pride And Prejudice</title>"
S"</book>");
// Display information on the ISBN element.
XmlElement* elem = dynamic_cast<XmlElement*> (doc->DocumentElement->FirstChild);
Console::Write(S"{0}:{1} = {2}", elem->Prefix, elem->LocalName, elem->InnerText);
Console::WriteLine(S"\t namespaceURI={0}", elem->NamespaceURI);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET