XmlConvert.VerifyName(String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlConvert.cs

Memverifikasi bahwa nama tersebut adalah nama yang valid sesuai dengan rekomendasi W3C Extended Markup Language.

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

Parameter

name

String

Nama untuk diverifikasi.

Mengembalikan

String

Nama, jika itu adalah nama XML yang valid.

Pengecualian

XmlException

name bukan nama XML yang valid.

ArgumentNullException

name adalah null atau String.Empty.

Contoh

Contoh berikut menggunakan VerifyName metode untuk menulis nama elemen.

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

Keterangan

Metode ini dapat digunakan dengan kelas dengan XmlWriter cara berikut.

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

Lihat juga

• VerifyNCName(String)