XmlNode.Prefix Propriété

Définition

Espace de noms:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtient ou définit le préfixe de l'espace de noms de ce nœud.

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

Valeur de propriété

String

Préfixe de l'espace de noms de ce nœud. Par exemple, Prefix est bk pour l’élément <bk:book>. En l'absence de préfixe, cette propriété retourne String.Empty.

Exceptions

ArgumentException

Ce nœud est en lecture seule.

XmlException

Le préfixe spécifié contient un caractère non valide.

Le préfixe spécifié est mal formé.

Le préfixe spécifié est « xml » et l’URI d’espace de noms de ce nœud est différent de « http://www.w3.org/XML/1998/namespace ».

Le nœud est un attribut, le préfixe spécifié est « xmlns » et l’URI d’espace de noms de ce nœud est différent de « http://www.w3.org/2000/xmlns/ ».

Ce nœud est un attribut et le qualifiedName de ce nœud est "xmlns".

Remarques

La définition de cette propriété, lorsqu’elle est autorisée, modifie la Name propriété, qui contient le nom qualifié, sur les nœuds Élément et Attribut. La définition de cette propriété sur les types de nœuds qui ne peuvent pas avoir de préfixe (tel que Text, Comment, EntityReference, CDATA, ProcessingInstruction, Document et DocumentFragment) n’a aucun effet. La modification du préfixe d’un attribut connu pour avoir une valeur par défaut n’effectue pas de nouvel attribut avec la valeur par défaut et le préfixe d’origine apparaît, car l’URI de l’espace de noms et le nom local ne changent pas.

Notes pour les héritiers

En cas de Prefix substitution dans une classe dérivée, cette propriété ne peut pas être définie.