XmlConvert.VerifyName(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.
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
The name to verify.
Returns
The name, if it is a valid XML name.
Exceptions
name
is not a valid XML name.
name
is null
or String.Empty.
Examples
The following example uses the VerifyName
method to write an element name.
#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();
}
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
Remarks
This method can be used with the XmlWriter class in the following manner.
try{
writer.WriteStartElement(XmlConvert.VerifyName("item"),"bar");
}
catch(Exception e)
{
Console.WriteLine("error");
}
Applies to
See also
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk