CodeDomProvider.CreateProvider メソッド

リファレンス

定義

名前空間:: System.CodeDom.Compiler

アセンブリ:: System.CodeDom.dll

アセンブリ:: System.dll

パッケージ:: System.CodeDom v6.0.0

パッケージ:: System.CodeDom v7.0.0

パッケージ:: System.CodeDom v8.0.0

パッケージ:: System.CodeDom v9.0.0-preview.2.24128.5

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した言語の CodeDomProvider インスタンスを取得します。

オーバーロード

CreateProvider(String)	指定した言語の CodeDomProvider インスタンスを取得します。
CreateProvider(String, IDictionary<String,String>)	指定された言語オプションおよびプロバイダーオプションの CodeDomProvider インスタンスを取得します。

CreateProvider(String)

ソース:: CodeDomProvider.cs

ソース:: CodeDomProvider.cs

ソース:: CodeDomProvider.cs

指定した言語の CodeDomProvider インスタンスを取得します。

public:
 static System::CodeDom::Compiler::CodeDomProvider ^ CreateProvider(System::String ^ language);

public static System.CodeDom.Compiler.CodeDomProvider CreateProvider (string language);

[System.Runtime.InteropServices.ComVisible(false)]
public static System.CodeDom.Compiler.CodeDomProvider CreateProvider (string language);

static member CreateProvider : string -> System.CodeDom.Compiler.CodeDomProvider

[<System.Runtime.InteropServices.ComVisible(false)>]
static member CreateProvider : string -> System.CodeDom.Compiler.CodeDomProvider

Public Shared Function CreateProvider (language As String) As CodeDomProvider

パラメーター

language: String

言語名。

戻り値

CodeDomProvider

指定した言語名に対して実装される CodeDOM プロバイダー。

属性: ComVisibleAttribute

例外

ConfigurationErrorsException

このコンピューターには、language の構成済みのプロバイダーがありません。

ArgumentNullException

language が null です。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

例

次のコード例では、入力言語の CodeDomProvider 実装を決定し、言語プロバイダーの構成済みの設定を表示します。このコード例は、CompilerInfo クラスのために提供されている大規模な例の一部です。

CodeDomProvider^ provider = nullptr;

// Check for a provider corresponding to the input language.  
if ( CodeDomProvider::IsDefinedLanguage( language ) )
{
   provider = CodeDomProvider::CreateProvider( language );
   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.
      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 provider configured for input language \"{0}\".", language );

CodeDomProvider provider;

// Check for a provider corresponding to the input language.
if (CodeDomProvider.IsDefinedLanguage(language))
{
    provider = CodeDomProvider.CreateProvider(language);

    // 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.

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

Dim provider As CodeDomProvider

' Check for a provider corresponding to the input language.  
If CodeDomProvider.IsDefinedLanguage(language) Then
   provider = CodeDomProvider.CreateProvider(language)
   
   ' 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 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)
Else
   ' Tell the user that the language provider was not found.
   Console.WriteLine("There is no provider configured for input language ""{0}"".", _
       language)
End If

注釈

注意

このメソッドは、必要に応じて複数のプロバイダーのいずれかを使用できるアプリケーションでコードプロバイダーのインスタンスを作成するために最も一般的に使用されます。 CreateProvider では、インスタンス化するコードプロバイダーを実行時に指定できます。デザイン時に使用するコードプロバイダーがわかっている場合は、メソッドを使用するのではなく、そのコードプロバイダーのインスタンスを作成する CreateProvider 必要があります。

メソッドは CreateProvider 、特定の CodeDomProvider 言語名のインスタンスを返します。これは、言語プロバイダーの型を使用してメソッドを Activator.CreateInstance 呼び出すのと似ています。言語名の構成済みプロバイダー実装を動的に検索する場合に使用 CreateProvider します。

言語名に対して複数のプロバイダー実装が構成されている場合は、 CreateProvider 最後に一致する構成要素のプロバイダーインスタンスを返します。

特定の言語プロバイダーの Activator.CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo) 実装が必要な場合は、メソッドオーバーロードを使用します。たとえば、メソッドを CreateProvider 使用して、言語名 "CSharp"をサポートするプロバイダーインスタンスを取得します。メソッドオーバーロードを Activator.CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo) 使用して、実装専用のプロバイダーインスタンスを Microsoft.CSharp.CSharpCodeProvider 取得します。 1 つの言語に Activator.CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[]) 対して複数のコードプロバイダーがあり、特定のコードプロバイダーをインスタンス化する場合は、メソッドを使用します。

メソッドは IsDefinedLanguage 、少なくとも 1 つのプロバイダー実装が特定の言語をサポートしているかどうかを確認します。に渡す前に、を使用して IsDefinedLanguage 言語名を CreateProvider検証できます。サポートされていない言語名をにCreateProvider System.Configuration.ConfigurationException渡すと、がスローされます。

メソッドをGetAllCompilerInfo使用すると、コンピューター構成ファイル (Machine.config) の system.codedom> 要素で<識別される開発者やコンパイラベンダーによって提供される追加の実装を含め、コンピューター上のすべてのCodeDomProvider実装を決定できます。

メソッドは CreateProvider 、特定の言語の実装の CodeDomProvider インスタンスを返します。

言語名では大文字と小文字は区別されません。

こちらもご覧ください

IsDefinedLanguage(String)

適用対象

CreateProvider(String, IDictionary<String,String>)

ソース:: CodeDomProvider.cs

ソース:: CodeDomProvider.cs

ソース:: CodeDomProvider.cs

指定された言語オプションおよびプロバイダーオプションの CodeDomProvider インスタンスを取得します。

public:
 static System::CodeDom::Compiler::CodeDomProvider ^ CreateProvider(System::String ^ language, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ providerOptions);

public static System.CodeDom.Compiler.CodeDomProvider CreateProvider (string language, System.Collections.Generic.IDictionary<string,string> providerOptions);

[System.Runtime.InteropServices.ComVisible(false)]
public static System.CodeDom.Compiler.CodeDomProvider CreateProvider (string language, System.Collections.Generic.IDictionary<string,string> providerOptions);

static member CreateProvider : string * System.Collections.Generic.IDictionary<string, string> -> System.CodeDom.Compiler.CodeDomProvider

[<System.Runtime.InteropServices.ComVisible(false)>]
static member CreateProvider : string * System.Collections.Generic.IDictionary<string, string> -> System.CodeDom.Compiler.CodeDomProvider

Public Shared Function CreateProvider (language As String, providerOptions As IDictionary(Of String, String)) As CodeDomProvider

パラメーター

language: String

言語名。

providerOptions: IDictionary<String,String>

構成ファイルのプロバイダーオプションのコレクション。

戻り値

CodeDomProvider

指定した言語名およびオプションに対して実装される CodeDOM プロバイダー。

属性: ComVisibleAttribute

例

次の例は、パラメーターを使用してプロバイダーのインスタンスを作成する方法を providerOptions 示しています。

using System;
using System.CodeDom.Compiler;
using Microsoft.CSharp;
using Microsoft.VisualBasic;
using System.Collections.Generic;

namespace ProviderOptions
{
    class Program
    {
        static void Main(string[] args)
        {
            DisplayCSharpCompilerInfo();
            DisplayVBCompilerInfo();
            Console.WriteLine("Press Enter key to exit.");
            Console.ReadLine();
        }
        static void DisplayCSharpCompilerInfo()
        {
            Dictionary<string, string> provOptions =
            new Dictionary<string, string>();

            provOptions.Add("CompilerVersion", "v4");
            // Get the provider for Microsoft.CSharp
            CodeDomProvider provider = CodeDomProvider.CreateProvider("CSharp", provOptions);

            // Display the C# language provider information.
            Console.WriteLine("CSharp provider is {0}",
                provider.ToString());
            Console.WriteLine("  Provider hash code:     {0}",
                provider.GetHashCode().ToString());
            Console.WriteLine("  Default file extension: {0}",
                provider.FileExtension);

            Console.WriteLine();
        }

        static void DisplayVBCompilerInfo()
        {
            Dictionary<string, string> provOptions =
            new Dictionary<string, string>();

            provOptions.Add("CompilerVersion", "v3.5");
            // Get the provider for Microsoft.VisualBasic
            CodeDomProvider provider = CodeDomProvider.CreateProvider("VisualBasic", provOptions);

            // Display the Visual Basic language provider information.
            Console.WriteLine("Visual Basic provider is {0}",
                provider.ToString());
            Console.WriteLine("  Provider hash code:     {0}",
                provider.GetHashCode().ToString());
            Console.WriteLine("  Default file extension: {0}",
                provider.FileExtension);

            Console.WriteLine();
        }
    }
}

Imports System.CodeDom.Compiler
Imports Microsoft.CSharp
Imports System.Collections.Generic



Class Program

    Shared Sub Main(ByVal args() As String)
        DisplayCSharpCompilerInfo()
        DisplayVBCompilerInfo()
        Console.WriteLine("Press Enter key to exit.")
        Console.ReadLine()

    End Sub

    Shared Sub DisplayCSharpCompilerInfo()
        Dim provOptions As New Dictionary(Of String, String)
        provOptions.Add("CompilerVersion", "v4")
        ' Get the provider for Microsoft.CSharp
        Dim provider As CodeDomProvider = CodeDomProvider.CreateProvider("CSharp", provOptions)

        ' Display the C# language provider information.
        Console.WriteLine("CSharp provider is {0}", provider.ToString())
        Console.WriteLine("  Provider hash code:     {0}", provider.GetHashCode().ToString())
        Console.WriteLine("  Default file extension: {0}", provider.FileExtension)

        Console.WriteLine()

    End Sub


    Shared Sub DisplayVBCompilerInfo()
        Dim provOptions As New Dictionary(Of String, String)
        provOptions.Add("CompilerVersion", "v3.5")
        ' Get the provider for Microsoft.VisualBasic
        Dim provider As CodeDomProvider = CodeDomProvider.CreateProvider("VisualBasic", provOptions)

        ' Display the Visual Basic language provider information.
        Console.WriteLine("Visual Basic provider is {0}", provider.ToString())
        Console.WriteLine("  Provider hash code:     {0}", provider.GetHashCode().ToString())
        Console.WriteLine("  Default file extension: {0}", provider.FileExtension)

        Console.WriteLine()

    End Sub
End Class

注釈

注意

このメソッドは、必要に応じて複数のプロバイダーのいずれかを使用できるアプリケーションでコードプロバイダーのインスタンスを作成するために最も一般的に使用されます。 CreateProvider(String, IDictionary<String,String>) を使用すると、インスタンス化するコードプロバイダーのバージョンを実行時に指定できます。デザイン時に使用するコードプロバイダーがわかっている場合は、メソッドを使用するのではなく、そのコードプロバイダーのインスタンスを作成する CreateProvider(String, IDictionary<String,String>) 必要があります。

特定の言語とオプションに対して構成されたプロバイダー実装を動的に検索する場合に使用 CreateProvider(String, IDictionary<String,String>) します。言語名では大文字と小文字は区別されません。サポートされているプロバイダーオプションの詳細については、特定の CodeDOM プロバイダーのドキュメントを参照してください。

プロバイダーの検証と、言語名に対して複数のプロバイダー実装が構成されている場合のプロバイダーの呼び出しについては、メソッドの「解説」セクションを CreateProvider(String) 参照してください。

適用対象

次の方法で共有

CodeDomProvider.CreateProvider メソッド

定義

オーバーロード

CreateProvider(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

CreateProvider(String, IDictionary<String,String>)

パラメーター

戻り値

例

注釈

適用対象

その他のリソース