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
Werk met ons samen op GitHub
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en bekijken. Raadpleeg onze gids voor inzenders voor meer informatie.