XmlNode.Prefix プロパティ
このノードの名前空間プリフィックスを取得または設定します。
Public Overridable Property Prefix As String
[C#]
public virtual string Prefix {get; set;}
[C++]
public: __property virtual String* get_Prefix();public: __property virtual void set_Prefix(String*);
[JScript]
public function get Prefix() : String;public function set Prefix(String);
プロパティ値
このノードの名前空間プリフィックス。たとえば、プリフィックスは要素 <bk:book> の bk です。プリフィックスがない場合、このプロパティは String.Empty を返します。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | このノードは読み取り専用です。 |
| XmlException | 指定したプリフィックスに無効な文字が含まれています。
指定されたプリフィックスの書式が正しくありません。 指定したプリフィックスが "xml" であり、このノードの namespaceURI が "http://www.w3.org/XML/1998/namespace" と異なっています。 このノードが属性で、指定したプリフィックスが "xmlns" で、このノードの namespaceURI が "http://www.w3.org/2000/xmlns/ " と異なります。 このノードが属性で、このノードの qualifiedName が "xmlns" です。 |
解説
このプロパティの設定が許可されている場合、プロパティを設定すると、Element ノードおよび Attribute ノードの限定名を保持している Name プロパティが変更されます。プリフィックスのないノード型 (Text、Comment、EntityReference、CDATA、ProcessingInstruction、Document、DocumentFragment など) でこのプロパティを設定しても無効です。既定値があることがわかっている属性のプリフィックスを変更しても、その既定値を持つ新しい属性は作成されず、元のプリフィックスが表示されます。これは、名前空間 URI とローカル名が変更されないためです。
継承時の注意: 派生クラスで Prefix をオーバーライドする場合、このプロパティは設定できません。
必要条件
プラットフォーム: 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