XmlNode.Prefix Eigenschaft

Definition

Namespace:

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

Ruft das Namespacepräfix dieses Knotens ab oder legt dieses fest.

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

Eigenschaftswert

String

Das Namespacepräfix dieses Knotens. Prefix Beispielsweise ist bk für das Element <bk:book>. Wenn kein Präfix vorhanden ist, gibt diese Eigenschaft String.Empty zurück.

Ausnahmen

ArgumentException

Dieser Knoten ist schreibgeschützt.

XmlException

Das angegebene Präfix enthält ein ungültiges Zeichen.

Das angegebene Präfix ist falsch formatiert.

Das angegebene Präfix ist „xml“, und der namespaceURI dieses Knotens unterscheidet sich von „http://www.w3.org/XML/1998/namespace“.

Dieser Knoten ist ein Attribut, das angegebene Präfix ist „xmlns“, und der namespaceURI dieses Knotens unterscheidet von „http://www.w3.org/2000/xmlns/“.

Dieser Knoten ist ein Attribut, und der qualifiedName dieses Knotens ist "xmlns".

Hinweise

Wenn diese Eigenschaft festgelegt wird, ändert sich die Name Eigenschaft, die den qualifizierten Namen enthält, auf Element- und Attributknoten. Das Festlegen dieser Eigenschaft auf Knotentypen, die kein Präfix (z. B. Text, Kommentar, EntityReference, CDATA, ProcessingInstruction, Document und DocumentFragment) aufweisen können, hat keine Auswirkung. Wenn Sie das Präfix eines Attributs ändern, das bekannt ist, einen Standardwert hat, wird kein neues Attribut mit dem Standardwert erstellt und das ursprüngliche Präfix angezeigt, da der Namespace-URI und der lokale Name nicht geändert werden.

Hinweise für Vererber

Wenn sie in einer abgeleiteten Klasse außer Kraft Prefix gesetzt werden, kann diese Eigenschaft nicht festgelegt werden.