Freigeben über


XmlTextReader.LocalName-Eigenschaft

Ruft den lokalen Namen des aktuellen Knotens ab.

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

Syntax

'Declaration
Public Overrides ReadOnly Property LocalName As String
'Usage
Dim instance As XmlTextReader
Dim value As String

value = instance.LocalName
public override string LocalName { get; }
public:
virtual property String^ LocalName {
    String^ get () override;
}
/** @property */
public String get_LocalName ()
public override function get LocalName () : String

Eigenschaftenwert

Der Name des aktuellen Knotens ohne das Präfix. Der LocalName für das <bk:book>-Element lautet z. B. book. Bei unbenannten Knotentypen wie Text, Comment usw. gibt diese Eigenschaft String.Empty zurück.

Hinweise

Hinweis

Die empfohlene Vorgehensweise für die Version Microsoft .NET Framework, Version 2.0 besteht darin, mithilfe der System.Xml.XmlReader.Create-Methode XmlReader-Instanzen zu erstellen. So können Sie die neuen Features dieser Version in vollem Umfang nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Readern.

Beispiel

Im folgenden Beispiel werden der lokale Name jedes Knotens und, sofern vorhanden, das Präfix und der Namespace-URI angezeigt.

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            ' Load the reader with the XML file.
            reader = New XmlTextReader("book2.xml")
            
            ' Parse the file.  If they exist, display the prefix and 
            ' namespace URI of each node.
            While reader.Read()
                If reader.IsStartElement() Then
                    If reader.Prefix = String.Empty Then
                        Console.WriteLine("<{0}>", reader.LocalName)
                    Else
                        Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName)
                        Console.WriteLine(" The namespace URI is " & reader.NamespaceURI)
                    End If
                End If
            End While
        
        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub 'Main 
End Class 'Sample
using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {
  
    XmlTextReader reader = null;

    try {

       // Load the reader with the XML file.
       reader = new XmlTextReader("book2.xml");
  
       // Parse the file.  If they exist, display the prefix and 
       // namespace URI of each node.
       while (reader.Read()) {
         if (reader.IsStartElement()) {
           if (reader.Prefix==String.Empty)
              Console.WriteLine("<{0}>", reader.LocalName);
           else {
               Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName);
               Console.WriteLine(" The namespace URI is " + reader.NamespaceURI);
           }
         }
       }       

     } 
     finally {
        if (reader != null)
          reader.Close();
      }
  }  
} // End class
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   try
   {
      
      // Load the reader with the XML file.
      reader = gcnew XmlTextReader( "book2.xml" );
      
      // Parse the file.  If they exist, display the prefix and 
      // namespace URI of each node.
      while ( reader->Read() )
      {
         if ( reader->IsStartElement() )
         {
            if ( reader->Prefix == String::Empty )
                        Console::WriteLine( "<{0}>", reader->LocalName );
            else
            {
               Console::Write( "<{0}:{1}>", reader->Prefix, reader->LocalName );
               Console::WriteLine( " The namespace URI is {0}", reader->NamespaceURI );
            }
         }
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlTextReader reader = null;
        try {

            // Load the reader with the XML file.
            reader = new XmlTextReader("book2.xml");

            // Parse the file.  If they exist, display the prefix and 
            // namespace URI of each node.
            while(reader.Read()) {
                if (reader.IsStartElement()) {
                    if (reader.get_Prefix().Equals(String.Empty)) {
                        Console.WriteLine("<{0}>", reader.get_LocalName());
                    }
                    else {
                        Console.Write("<{0}:{1}>", reader.get_Prefix(), 
                            reader.get_LocalName());
                        Console.WriteLine(" The namespace URI is " 
                            + reader.get_NamespaceURI());
                    }
                }
            }
        }
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } //main
} // End class Sample

Im Beispiel wird die Datei book2.xml als Eingabe verwendet.

<book xmlns:bk='urn:samples'>
  <title>Pride And Prejudice</title>
  <bk:genre>novel</bk:genre>
</book>

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlTextReader-Klasse
XmlTextReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"