XmlConvert.VerifyName メソッド

.NET Framework クラス ライブラリ リファレンス

XmlConvert.VerifyName メソッド

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Shared Function VerifyName
 ( _
    name As String _
) As String

Visual Basic (使用法)

Dim name As String
Dim returnValue As String

returnValue = XmlConvert.VerifyName(name)

C#

public static string VerifyName
 (
    string name
)

C++

public:
static String^ VerifyName (
    String^ name
)

J#

public static String VerifyName (
    String name
)

JScript

public static function VerifyName
 (
    name : String
) : String

パラメータ

name

検証対象となる名前。

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

例外

例外の種類	条件
XmlException	name が有効な XML 名ではありません。
ArgumentNullException	name が null 参照 (Visual Basic では Nothing) または String.Empty です。

解説

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

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

使用例

VerifyName メソッドを使用して、要素名を書き込む例を次に示します。

Visual Basic

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 <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();
}

J#

import System.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        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.get_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();
    } //main 
} //Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlConvert クラス
XmlConvert メンバ
System.Xml 名前空間
VerifyNCName