XmlConvert.VerifyName(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Sprawdza, czy nazwa jest prawidłową nazwą zgodnie z zaleceniem 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
Parametry
- name
- String
Nazwa do zweryfikowania.
Zwraca
Nazwa, jeśli jest prawidłową nazwą XML.
Wyjątki
name
nie jest prawidłową nazwą XML.
name
is null
lub String.Empty.
Przykłady
W poniższym przykładzie użyto VerifyName
metody do napisania nazwy elementu.
#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
Uwagi
Tej metody można używać z klasą XmlWriter w następujący sposób.
try{
writer.WriteStartElement(XmlConvert.VerifyName("item"),"bar");
}
catch(Exception e)
{
Console.WriteLine("error");
}