CodeDomProvider.GetCompilerInfo(String) Método

Definição

Espaço de Nomes:
System.CodeDom.Compiler
Assemblagem:
System.dll

Devolve as definições do fornecedor de linguagem e do compilador para a linguagem especificada.

public:
 static System::CodeDom::Compiler::CompilerInfo ^ GetCompilerInfo(System::String ^ language);
[System.Runtime.InteropServices.ComVisible(false)]
public static System.CodeDom.Compiler.CompilerInfo GetCompilerInfo(string language);
[<System.Runtime.InteropServices.ComVisible(false)>]
static member GetCompilerInfo : string -> System.CodeDom.Compiler.CompilerInfo
Public Shared Function GetCompilerInfo (language As String) As CompilerInfo

Parâmetros

language
String

Um nome de língua.

Devoluções

CompilerInfo

Um CompilerInfo objeto preenchido com as definições da implementação configurada CodeDomProvider .

Atributos
ComVisibleAttribute

Exceções

ConfigurationException

Não language tem um fornecedor configurado neste computador.

ConfigurationErrorsException

O language é null.

SecurityException

O interlocutor não tem a permissão necessária.

Exemplos

O seguinte exemplo de código determina a CodeDomProvider implementação para uma linguagem de entrada e apresenta as definições configuradas para o fornecedor da linguagem. Este exemplo de código faz parte de um exemplo maior fornecido para a CompilerInfo classe.

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

Observações

O <elemento system.codedom> no ficheiro de configuração da máquina contém as definições de configuração do fornecedor de linguagem e do compilador para cada CodeDomProvider implementação no computador. Para informações sobre ficheiros de configuração de máquina, consulte a secção Ficheiros de Configuração de Máquina em Configurar Aplicações. O GetCompilerInfo método pesquisa em cada elemento de configuração do fornecedor o nome da língua especificado. A instância devolvida CompilerInfo contém o fornecedor de linguagem configurado e as definições do compilador.

O IsDefinedLanguage método verifica se pelo menos uma implementação de fornecedor suporta uma linguagem específica. Pode validar um nome de língua usando IsDefinedLanguage antes de o passar para GetCompilerInfo. Isto impede lançar a System.Configuration.ConfigurationException quando acedes à CompilerInfo instância para um nome de língua não suportado.

Se mais do que uma implementação de fornecedor estiver configurada para o nome da linguagem de entrada, retorna GetCompilerInfo as definições do último elemento de configuração correspondente do fornecedor.

Os nomes das línguas são indiferentes a maiúsculas e maiúsculas.

Aplica-se a

Ver também