XmlNode.Prefix プロパティ

定義

このノードの名前空間プリフィックスを取得または設定します。Gets or sets the namespace prefix of this node.

public:
 virtual property System::String ^ Prefix { System::String ^ get(); void set(System::String ^ value); };
public virtual string Prefix { get; set; }
member this.Prefix : string with get, set
Public Overridable Property Prefix As String

プロパティ値

String

このノードの名前空間プリフィックス。The namespace prefix of this node. たとえば、Prefix は、<bk: book>要素の bk です。For example, Prefix is bk for the element <bk:book>. プリフィックスがない場合、このプロパティは 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.

指定したプレフィックスが "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".

このノードが属性で、指定したプレフィックスが "xmlns" で、このノードの namespaceURI が "http://www.w3.org/2000/xmlns/" と異なります。This node is an attribute and the specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/ ".

このノードが属性で、このノードの qualifiedName が "xmlns" です。This node is an attribute and the qualifiedName of this node is "xmlns".

注釈

このプロパティを設定すると、許可されている場合は、要素ノードと属性ノードに限定名を保持する Name プロパティが変更されます。Setting this property, when permitted, changes the Name property, which holds the qualified name, on Element and Attribute nodes. プレフィックスを持たないノード型 (Text、Comment、EntityReference、CDATA、ProcessingInstruction、Document、DocumentFragment など) でこのプロパティを設定しても効果はありません。Setting this property on node types that cannot have a prefix (such as Text, Comment, EntityReference, CDATA, ProcessingInstruction, Document, and DocumentFragment) has no effect. 既定値が設定されていることがわかっている属性のプレフィックスを変更しても、既定値を持つ新しい属性は作成されず、元のプレフィックスが表示されます。これは、名前空間 URI とローカル名が変更されないためです。Changing the prefix of an attribute that is known to have a default value, does not make a new attribute with the default value and the original prefix appear, since the namespace URI and local name do not change.

注意 (継承者)

派生クラスで Prefix をオーバーライドする場合、このプロパティを設定することはできません。When overriding Prefix in a derived class, this property cannot be set.

適用対象