XmlConvert.VerifyName(String) Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs

Controleert of de naam een geldige naam is volgens de W3C Extended Markup Language-aanbeveling.

public:
 static System::String ^ VerifyName(System::String ^ name);
public static string VerifyName(string name);
static member VerifyName : string -> string
Public Shared Function VerifyName (name As String) As String

Parameters

name
String

De naam die moet worden geverifieerd.

Retouren

String

De naam, als het een geldige XML-naam is.

Uitzonderingen

XmlException

name is geen geldige XML-naam.

ArgumentNullException

name is null of String.Empty.

Voorbeelden

In het volgende voorbeeld wordt de VerifyName methode gebruikt om een elementnaam te schrijven.

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();
  }
}

Imports System.Xml

Public Class Sample

    Public Shared Sub Main()
        Dim writer As 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

Opmerkingen

Deze methode kan op de volgende manier worden gebruikt met de XmlWriter klasse.

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

Van toepassing op

Zie ook