This documentation is archived and is not being maintained.

XmlTextReader.Prefix Property

Gets the namespace prefix associated with the current node.

[Visual Basic]
Overrides Public ReadOnly Property Prefix As String
[C#]
public override string Prefix {get;}
[C++]
public: __property String* get_Prefix();
[JScript]
public override function get Prefix() : String;

Property Value

The namespace prefix associated with the current node.

Example

[Visual Basic, C#, C++] The following example displays the local name of each node, and, if they exist, the prefix and namespace URI.

[Visual Basic] 
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

[C#] 
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

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main() {

   XmlTextReader* reader = 0;

   try {

      // Load the reader with the XML file.
      reader = new XmlTextReader(S"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(S"<{0}>", reader->LocalName);
            else {
               Console::Write(S"<{0}:{1}>", reader->Prefix, reader->LocalName);
               Console::WriteLine(S" The namespace URI is {0}", reader->NamespaceURI);
            }
         }
      }       

   } 
   __finally {
      if (reader != 0)
         reader->Close();
   }
}  

The example uses the file, book2.xml, as input.

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

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

XmlTextReader Class | XmlTextReader Members | System.Xml Namespace

Show: