XmlConvert.VerifyName メソッド

W3C 勧告『Extended Markup Language』に従って有効な名前であることを検証します。

Public Shared Function VerifyName( _
   ByVal name As String _) As String
[C#]
public static string VerifyName(stringname);
[C++]
public: static String* VerifyName(String* name);
[JScript]
public static function VerifyName(
   name : String) : String;

パラメータ

• name
  検証対象となる名前。

戻り値

有効な XML 名の場合は、その名前。

例外

解説

このメソッドは、 XmlWriter クラスで次の方法で使用できます。

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

使用例

[Visual Basic, C#, C++] VerifyName メソッドを使用して、要素名を書き込む例を次に示します。

 
Imports System
Imports System.Xml

public class Sample

  public shared sub Main()
     Dim writer as XmlTextWriter = 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

[C#] 
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();
 
  }

}

[C++] 
#using <mscorlib.dll>
#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;

int main()
{
   XmlTextWriter* writer = new XmlTextWriter( S"out.xml", 0 );
   String* tag = S"item name";

   try
   {
      // Write the root element.
      writer->WriteStartElement(S"root");

      writer->WriteStartElement(XmlConvert::VerifyName(tag));

   }
   catch (XmlException* e)
   {
      Console::WriteLine(e->Message);
      Console::WriteLine(S"Convert to a valid name...");
      writer->WriteStartElement(XmlConvert::EncodeName(tag));
   }

   writer->WriteString(S"hammer");
   writer->WriteEndElement();

   // Write the end tag for the root element.
   writer->WriteEndElement();

   writer->Close();
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlConvert クラス | XmlConvert メンバ | System.Xml 名前空間 | VerifyNCName