XmlConvert.VerifyName-Methode

Überprüft, ob der Name ein gültiger Name gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist.

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

Syntax

'Declaration
Public Shared Function VerifyName ( _
    name As String _
) As String
'Usage
Dim name As String
Dim returnValue As String

returnValue = XmlConvert.VerifyName(name)

public static string VerifyName (
    string name
)

public:
static String^ VerifyName (
    String^ name
)

public static String VerifyName (
    String name
)

public static function VerifyName (
    name : String
) : String

Parameter

• name
  Der zu überprüfende Name.

Rückgabewert

Der Name, wenn dieser ein gültiger XML-Name ist.

Ausnahmen

Hinweise

Diese Methode kann mit der XmlWriter-Klasse auf folgende Weise verwendet werden.

 try{
   writer.WriteStartElement(XmlConvert.VerifyName("item"),"bar");
 }
 catch(Exception e)
 {
   Console.WriteLine("error");
 }

Beispiel

Im folgenden Beispiel wird mithilfe der VerifyName-Methode ein Elementname geschrieben.

Imports System
Imports System.Xml

public class Sample

  public shared sub Main()
     Dim writer as XmlTextWriter = new XmlTextWriter ("out.xml", nothing)
     Dim tag as string = "item name"
   
    try
    
     ' Write the root element.
     writer.WriteStartElement("root")

     writer.WriteStartElement(XmlConvert.VerifyName(tag))

     catch e as XmlException
        Console.WriteLine(e.Message)
        Console.WriteLine("Convert to a valid name...")
        writer.WriteStartElement(XmlConvert.EncodeName(tag))
     end try

     writer.WriteString("hammer")
     writer.WriteEndElement()

     ' Write the end tag for the root element.
     writer.WriteEndElement()
 
     writer.Close()
  
  end sub
end class

using System;
using System.Xml;

public class Sample{

  public static void Main(){
     XmlTextWriter writer = new XmlTextWriter ("out.xml", null);
     string tag = "item name";
   
  try{
    
     // Write the root element.
     writer.WriteStartElement("root");

     writer.WriteStartElement(XmlConvert.VerifyName(tag));
             
     }
     catch (XmlException e){
        Console.WriteLine(e.Message);
        Console.WriteLine("Convert to a valid name...");
        writer.WriteStartElement(XmlConvert.EncodeName(tag));
     }

     writer.WriteString("hammer");
     writer.WriteEndElement();

     // Write the end tag for the root element.
     writer.WriteEndElement();
 
     writer.Close();
 
  }

}

#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = gcnew XmlTextWriter( "out.xml", nullptr );
   String^ tag = "item name";
   try
   {
      
      // Write the root element.
      writer->WriteStartElement( "root" );
      writer->WriteStartElement( XmlConvert::VerifyName( tag ) );
   }
   catch ( XmlException^ e ) 
   {
      Console::WriteLine( e->Message );
      Console::WriteLine( "Convert to a valid name..." );
      writer->WriteStartElement( XmlConvert::EncodeName( tag ) );
   }

   writer->WriteString( "hammer" );
   writer->WriteEndElement();
   
   // Write the end tag for the root element.
   writer->WriteEndElement();
   writer->Close();
}

import System.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlTextWriter writer = new XmlTextWriter("out.xml", null);
        String tag = "item name";

        try {
            // Write the root element.
            writer.WriteStartElement("root");

            writer.WriteStartElement(XmlConvert.VerifyName(tag));
        }
        catch (XmlException e) {
            Console.WriteLine(e.get_Message());
            Console.WriteLine("Convert to a valid name...");
            writer.WriteStartElement(XmlConvert.EncodeName(tag));
        }

        writer.WriteString("hammer");
        writer.WriteEndElement();
        // Write the end tag for the root element.
        writer.WriteEndElement();

        writer.Close();
    } //main 
} //Sample

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

XmlConvert-Klasse
XmlConvert-Member
System.Xml-Namespace
VerifyNCName