XPathNavigator.MoveToNamespace-Methode

Artikel
08/20/2007

Verschiebt den XPathNavigator auf den Namespaceknoten mit dem angegebenen Namespacepräfix.

Namespace: System.Xml.XPath
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Function MoveToNamespace ( _
    name As String _
) As Boolean
'Usage
Dim instance As XPathNavigator
Dim name As String
Dim returnValue As Boolean

returnValue = instance.MoveToNamespace(name)

public virtual bool MoveToNamespace (
    string name
)

public:
virtual bool MoveToNamespace (
    String^ name
)

public boolean MoveToNamespace (
    String name
)

public function MoveToNamespace (
    name : String
) : boolean

Parameter

name
Das Namespacepräfix des Namespaceknotens.

Rückgabewert

true, wenn der XPathNavigator auf den angegebenen Namespace verschoben werden konnte, false, wenn kein entsprechender Namespaceknoten gefunden wurde oder der XPathNavigator nicht auf einem Elementknoten positioniert ist. Wenn false, bleibt die Position des XPathNavigator unverändert.

Hinweise

Nachdem der XPathNavigator auf den Namespaceknoten verschoben wurde, spiegelt die Name-Eigenschaft den Namen des Namespaces wider.

Wenn sich der XPathNavigator auf einem Namespaceknoten befindet, können die Methoden MoveToNext, MoveToPrevious und MoveToFirst nicht verwendet werden. Diese Methoden geben immer false zurück und ändern die Position des XPathNavigator nicht. Um zum nächsten Namespaceknoten zu wechseln, können Sie stattdessen MoveToNextNamespace aufrufen.

Sobald die Position des XPathNavigator auf einen Namespaceknoten gesetzt wurde, können Sie MoveToParent aufrufen, um zum Elementknoten zurückzukehren.

Eine Definition der Namespaceknoten finden Sie in Abschnitt 5.4 der W3C-Empfehlung zur XML Path Language (XPath) unter http://www.w3.org/TR/xpath\#data-model (nur auf Englisch verfügbar).

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XPathNavigator-Klasse
XPathNavigator-Member
System.Xml.XPath-Namespace
MoveToNextNamespace
MoveToFirstNamespace
GetNamespace

Freigeben über