CompilerInfo.CreateDefaultCompilerParameters メソッド

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

CompilerInfo.CreateDefaultCompilerParameters メソッド

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

言語プロバイダ実装の構成済みのコンパイラ設定を取得します。

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

Visual Basic (宣言)

Public Function CreateDefaultCompilerParameters
 As CompilerParameters

Visual Basic (使用法)

Dim instance As CompilerInfo
Dim returnValue As CompilerParameters

returnValue = instance.CreateDefaultCompilerParameters

C#

public CompilerParameters CreateDefaultCompilerParameters ()

C++

public:
CompilerParameters^ CreateDefaultCompilerParameters ()

J#

public CompilerParameters CreateDefaultCompilerParameters ()

JScript

public function CreateDefaultCompilerParameters
 () : CompilerParameters

戻り値
言語プロバイダ用に構成されたコンパイラ オプションおよびコンパイラ設定を格納する読み取り専用の CompilerParameters インスタンス。

解説

CreateDefaultCompilerParameters メソッドを使用して、CodeDomProvider.GetAllCompilerInfo メソッドおよび CodeDomProvider.GetCompilerInfo メソッドによって返される CompilerInfo のインスタンスのコンパイラ設定をチェックします。

マシン構成ファイルの <system.codedom> 要素 には、コンピュータ上の各 CodeDomProvider 実装の言語プロバイダおよびコンパイラの構成設定が格納されます。各言語プロバイダの構成要素には、compilerOptions 属性と warningLevel 属性を格納することもできます。これらの属性は、CompilerParameters.CompilerOptions プロパティおよび CompilerParameters.WarningLevel プロパティの既定値を定義します。

言語プロバイダの構成要素が compilerOptions 属性を定義していない場合、CompilerParameters.CompilerOptions プロパティ値は、空の文字列 ("") です。言語プロバイダの構成要素が warningLevel 属性を定義していない場合、CompilerParameters.WarningLevel プロパティ値は –1 です。

使用例

コンピュータ上に入力言語の CodeDomProvider 実装が構成されているかどうかを判断するコード例を次に示します。指定した言語用に構成されたプロバイダが存在する場合、この例はその言語プロバイダの構成設定を表示します。このコード例は、CompilerInfo クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Dim info As CompilerInfo = CodeDomProvider.GetCompilerInfo(configLanguage)

' Check whether there is a provider configured for this language.
If info.IsCodeDomProviderTypeValid Then
   ' Get a provider instance using the configured type information.
   Dim provider As CodeDomProvider
   provider = CType(Activator.CreateInstance(info.CodeDomProviderType), CodeDomProvider)
   
   ' Display information about this language provider.
   Console.WriteLine("Language provider:  {0}", _
       provider.ToString())
   Console.WriteLine()
   Console.WriteLine("  Default file extension:  {0}",
 _
       provider.FileExtension)
   Console.WriteLine()
   
   ' Get the compiler settings for this language.
   Dim langCompilerConfig As CompilerParameters
 = info.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 provider configured for input
 language ""{0}"".",
 configLanguage)
End If

C#

CompilerInfo info = CodeDomProvider.GetCompilerInfo(configLanguage);

// Check whether there is a provider configured for this language.
if (info.IsCodeDomProviderTypeValid)
{
    // Get a provider instance using the configured type information.
    CodeDomProvider provider;
    provider = (CodeDomProvider)Activator.CreateInstance(info.CodeDomProviderType);

    // Display information about this language provider.
    Console.WriteLine("Language provider:  {0}", 
        provider.ToString());
    Console.WriteLine();
    Console.WriteLine("  Default file extension:  {0}", 
        provider.FileExtension);
    Console.WriteLine();

    // Get the compiler settings for this language.

    CompilerParameters langCompilerConfig = info.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 provider configured for
 input language \"{0}\".", 
        configLanguage);
}

C++

CodeDomProvider^ provider = nullptr;
CompilerInfo^ info = CodeDomProvider::GetCompilerInfo( configLanguage );

// Check whether there is a provider configured for this language.
if ( info->IsCodeDomProviderTypeValid )
{
   
   // Get a provider instance using the configured type information.
   provider = dynamic_cast<CodeDomProvider^>(Activator::CreateInstance( info->CodeDomProviderType
 ));
   if ( provider )
   {
      
      // Display information about this language provider.
      Console::WriteLine( "Language provider:  {0}", provider->ToString()
 );
      Console::WriteLine();
      Console::WriteLine( "  Default file extension:  {0}", provider->FileExtension
 );
      Console::WriteLine();
      
      // Get the compiler settings for this language.
      CompilerParameters^ langCompilerConfig = info->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 provider configured for
 input language \"{0}\".", configLanguage );
}

.NET Framework のセキュリティ

• SecurityPermission  (CompilerInfo のメンバを呼び出すためのアクセス許可)。要求値 : 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

参照

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