CodeDomProvider.GetLanguageFromExtension メソッド

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

CodeDomProvider.GetLanguageFromExtension メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

CodeDomProvider のコンパイラ構成セクションに構成されている、指定したファイル名拡張子に関連付けられた言語名を返します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Shared Function GetLanguageFromExtension
 ( _
    extension As String _
) As String

Visual Basic (使用法)

Dim extension As String
Dim returnValue As String

returnValue = CodeDomProvider.GetLanguageFromExtension(extension)

C#

[ComVisibleAttribute(false)] 
public static string GetLanguageFromExtension
 (
    string extension
)

C++

[ComVisibleAttribute(false)] 
public:
static String^ GetLanguageFromExtension (
    String^ extension
)

J#

/** @attribute ComVisibleAttribute(false) */ 
public static String GetLanguageFromExtension
 (
    String extension
)

JScript

ComVisibleAttribute(false) 
public static function GetLanguageFromExtension
 (
    extension : String
) : String

パラメータ

extension

ファイル名拡張子。

戻り値
CodeDomProvider のコンパイラ構成設定に構成されている、ファイル名拡張子に関連付けられた言語名。

例外

例外の種類	条件
ConfigurationException	このコンピュータには、extension の構成済みの言語プロバイダがありません。
ConfigurationErrorsException	extension が null 参照 (Visual Basic では Nothing) です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

マシン構成ファイル (Machine.config) の <system.codedom> 要素 には、コンピュータ上の各 CodeDomProvider 実装の言語プロバイダおよびコンパイラの構成設定が格納されます。GetLanguageFromExtension メソッドは、指定したファイル名拡張子の各プロバイダ構成要素を検索します。

IsDefinedExtension メソッドは、少なくとも 1 つのプロバイダ実装が特定のファイル名拡張子をサポートしているかどうかをチェックします。GetLanguageFromExtension にファイル名拡張子を渡す前に、IsDefinedExtension を使用してそのファイル名拡張子を検証できます。これにより、GetLanguageFromExtension が、サポートされていないファイル名拡張子に対して System.Configuration.ConfigurationException をスローするのを防ぐことができます。

プロバイダ実装が入力ファイル名拡張子をサポートしており、そのプロバイダ用に構成された複数のサポート言語が存在する場合、GetLanguageFromExtension は、そのプロバイダの最初の言語名を返します。入力ファイル名拡張子に対して複数のプロバイダ実装が構成されている場合、GetLanguageFromExtension は、最後に一致するプロバイダ構成要素の言語名を返します。

言語名とファイル名拡張子では、大文字と小文字は区別されません。

使用例

入力ファイル名拡張子の CodeDomProvider 実装を確認し、その言語プロバイダの構成済みの設定を表示するコード例を次に示します。

Visual Basic

If Not fileExtension.StartsWith(".")
 Then
   fileExtension = "." + fileExtension
End If

' Get the language associated with the file extension.
If CodeDomProvider.IsDefinedExtension(fileExtension) Then
   Dim provider As CodeDomProvider
   Dim language As String
 = CodeDomProvider.GetLanguageFromExtension(fileExtension)
   
   Console.WriteLine("The language ""{0}""
 is associated with file extension ""{1}""",
 _
       language, fileExtension)
   Console.WriteLine()
   
   ' Check for a corresponding language provider.
   If CodeDomProvider.IsDefinedLanguage(language) Then
      provider = CodeDomProvider.CreateProvider(language)
      
      ' Display information about this language provider.
      Console.WriteLine("Language provider:  {0}",
 _
         provider.ToString())
      Console.WriteLine()
      
      ' Get the compiler settings for this language.
      Dim langCompilerInfo As CompilerInfo
 = CodeDomProvider.GetCompilerInfo(language)
      Dim langCompilerConfig As CompilerParameters
 = langCompilerInfo.CreateDefaultCompilerParameters()
      
      Console.WriteLine("  Compiler options:        {0}",
 _
          langCompilerConfig.CompilerOptions)
      Console.WriteLine("  Compiler warning level:  {0}",
 _
          langCompilerConfig.WarningLevel)
   End If
Else
   ' Tell the user that the language provider was not found.
   Console.WriteLine("There is no language provider associated
 with input file extension ""{0}"".",
 fileExtension)
End If

C#

if (fileExtension[0] != '.')
{
    fileExtension = "." + fileExtension;
}

// Get the language associated with the file extension.
if (CodeDomProvider.IsDefinedExtension(fileExtension))
{
    CodeDomProvider provider;
    String language = CodeDomProvider.GetLanguageFromExtension(fileExtension);

    Console.WriteLine("The language \"{0}\" is associated with file
 extension \"{1}\"", 
        language, fileExtension);
    Console.WriteLine();

    // Next, check for a corresponding language provider.

    if (CodeDomProvider.IsDefinedLanguage(language))
    {
        provider = CodeDomProvider.CreateProvider(language);

        // Display information about this language provider.

        Console.WriteLine("Language provider:  {0}", 
            provider.ToString());
        Console.WriteLine();

        // Get the compiler settings for this language.

        CompilerInfo langCompilerInfo = CodeDomProvider.GetCompilerInfo(language);
        CompilerParameters langCompilerConfig = langCompilerInfo.CreateDefaultCompilerParameters();

        Console.WriteLine("  Compiler options:        {0}", 
            langCompilerConfig.CompilerOptions);
        Console.WriteLine("  Compiler warning level:  {0}", 
            langCompilerConfig.WarningLevel);
    }
}
else 
{
    // Tell the user that the language provider was not found.
    Console.WriteLine("There is no language provider associated with input file
 extension \"{0}\".", 
        fileExtension);
}

C++

if (  !fileExtension->StartsWith(  "." ) )
{
   fileExtension = String::Concat( ".", fileExtension );
}


// Get the language associated with the file extension.
CodeDomProvider^ provider = nullptr;
if ( CodeDomProvider::IsDefinedExtension( fileExtension ) )
{
   String^ language = CodeDomProvider::GetLanguageFromExtension( fileExtension );
   if ( language )
   {
      Console::WriteLine( "The language \"{0}\" is associated with
 file extension \"{1}\"", language, fileExtension );
      Console::WriteLine();
   }

   
   // Check for a corresponding language provider.
   if ( language && CodeDomProvider::IsDefinedLanguage(
 language ) )
   {
      provider = CodeDomProvider::CreateProvider( language );
      if ( provider )
      {
         
         // Display information about this language provider.
         Console::WriteLine( "Language provider:  {0}", provider->ToString()
 );
         Console::WriteLine();
         
         // Get the compiler settings for this language.
         CompilerInfo^ langCompilerInfo = CodeDomProvider::GetCompilerInfo( language
 );
         if ( langCompilerInfo )
         {
            CompilerParameters^ langCompilerConfig = langCompilerInfo->CreateDefaultCompilerParameters();
            if ( langCompilerConfig )
            {
               Console::WriteLine( "  Compiler options:        {0}", langCompilerConfig->CompilerOptions
 );
               Console::WriteLine( "  Compiler warning level:  {0}", langCompilerConfig->WarningLevel.ToString()
 );
            }
         }
      }
   }
}

if ( provider == nullptr )
{
   
   // Tell the user that the language provider was not found.
   Console::WriteLine( "There is no language provider associated with input
 file extension \"{0}\".", fileExtension );
}

.NET Framework のセキュリティ

• SecurityPermission  (CodeDomProvider のメンバを呼び出すためのアクセス許可)。要求値 : LinkDemand、関連する PermissionState 列挙値 : Unrestricted、名前付きアクセス許可セット : FullTrust。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
CodeDomProvider クラス
CodeDomProvider メンバ
System.CodeDom.Compiler 名前空間
IsDefinedExtension
CreateProvider
その他の技術情報
コンパイラおよび言語プロバイダ設定のスキーマ