CodeDomProvider.GetCompilerInfo(String) Метод

Определение

Пространство имен:

System.CodeDom.Compiler

Сборка:

System.CodeDom.dll

Пакет:

System.CodeDom v8.0.0

Исходный код:

CodeDomProvider.cs

Возвращает параметры поставщика и компилятора языка для заданного языка.

public:
 static System::CodeDom::Compiler::CompilerInfo ^ GetCompilerInfo(System::String ^ language);

public static System.CodeDom.Compiler.CompilerInfo GetCompilerInfo (string language);

static member GetCompilerInfo : string -> System.CodeDom.Compiler.CompilerInfo

Public Shared Function GetCompilerInfo (language As String) As CompilerInfo

Параметры

language

String

Имя языка.

Возвращаемое значение

CompilerInfo

Объект CompilerInfo, заполненный параметрами настроенной реализации CodeDomProvider.

Исключения

ConfigurationException

Для языка, заданного в параметре language, на данном компьютере не настроен поставщик.

ConfigurationErrorsException

Значение параметра 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

Комментарии

Элемент< system.codedom> в файле конфигурации компьютера содержит параметры конфигурации поставщика языка и компилятора для каждой CodeDomProvider реализации на компьютере. Сведения о файлах конфигурации компьютера см. в разделе Файлы конфигурации компьютера статьи Настройка приложений. Метод GetCompilerInfo выполняет поиск указанного имени языка в каждом элементе конфигурации поставщика. Возвращенный CompilerInfo экземпляр содержит настроенные параметры поставщика языка и компилятора.

Метод IsDefinedLanguage проверяет, поддерживает ли хотя бы одна реализация поставщика определенный язык. Вы можете проверить имя языка с помощью IsDefinedLanguage перед его передачей в GetCompilerInfo. Это предотвращает создание System.Configuration.ConfigurationException при доступе к экземпляру CompilerInfo для неподдерживаемого имени языка.

Если для имени языка ввода настроено несколько реализаций поставщика, GetCompilerInfo возвращает параметры из последнего соответствующего элемента конфигурации поставщика.

В именах языков регистр не учитывается.

См. также раздел

• CompilerInfo
• IsDefinedLanguage(String)
• Схема параметров компилятора и поставщика языка