Compiler.Compile(String[], String[], String, String[], IDictionary) Método

Definição

Namespace:

Microsoft.CSharp

Assembly:

cscompmgd.dll

Compila as fontes C# determinadas para o arquivo de destino especificado.

public:
 static cli::array <Microsoft::CSharp::CompilerError ^> ^ Compile(cli::array <System::String ^> ^ sourceTexts, cli::array <System::String ^> ^ sourceTextNames, System::String ^ target, cli::array <System::String ^> ^ imports, System::Collections::IDictionary ^ options);

public static Microsoft.CSharp.CompilerError[] Compile (string[] sourceTexts, string[] sourceTextNames, string target, string[] imports, System.Collections.IDictionary options);

static member Compile : string[] * string[] * string * string[] * System.Collections.IDictionary -> Microsoft.CSharp.CompilerError[]

Public Shared Function Compile (sourceTexts As String(), sourceTextNames As String(), target As String, imports As String(), options As IDictionary) As CompilerError()

Parâmetros

sourceTexts

String[]

Uma matriz do tipo cadeia de caracteres, cada uma com código C#.

sourceTextNames

String[]

Uma matriz do tipo de cadeia de caracteres que contém os nomes de arquivo para cada sourceTexts.

target

String

O nome do arquivo de saída. Esse argumento é necessário.

imports

String[]

Uma matriz de cadeia de caracteres de tipo, com arquivos a referenciar.

options

IDictionary

Um IDictionary de opções do compilador.

Retornos

CompilerError[]

Retorna mensagens de diagnóstico como uma matriz do tipo CompilerError. Se a matriz está vazia ou todos os elementos são avisos, a compilação foi bem-sucedida.

Exceções

ArgumentNullException

sourceTexts é null.

- ou -

sourceTextNames é null.

- ou -

target é null.

ArgumentOutOfRangeException

sourceTexts é uma matriz vazia.

- ou -

sourceTextNames não é do mesmo tamanho que sourceTexts.

Comentários

Cada cadeia de caracteres no sourceTexts parâmetro é o equivalente a um único arquivo de origem. Deve haver pelo menos um sourceTexts elemento.

Os nomes de arquivo no sourceTextNames parâmetro são usados para diagnóstico do compilador e informações de depuração. A matriz é necessária, mas pode ser substituída localmente pelo uso da #line diretiva . A matriz deve ter o mesmo número de elementos que o sourceTexts parâmetro .

O imports parâmetro é o mesmo que a opção do /reference compilador. Esse parâmetro pode ser null.

Para o options parâmetro , a chave é a forma curta da opção do compilador. O valor é o valor desejado para a opção . O options parâmetro pode ser null. Algumas opções do compilador não são reconhecidas. A tabela a seguir mostra as opções e os valores reconhecidos.

Nome da Chave	Uso
addmodule	Lista de módulos a serem incluídos neste assembly. Os nomes dos módulos devem ser separados pela barra vertical ou pelo caractere de pipe. O valor deve ser do tipo String. Consulte -addmodule (Opções do compilador C#).
baseaddress	Endereço base para bibliotecas. O valor deve ser do tipo UInt32. Consulte -baseaddress (Opções do compilador C#).
bugreport	Produz o arquivo de relatório de bugs. O valor deve ser do tipo String. Consulte -bugreport (Opções do compilador C#).
checked	Defina a avaliação de expressão padrão como marcada (ou desmarcada). O valor deve ser do tipo Boolean. Consulte -checked (Opções do compilador C#).
d	Lista de símbolos separados por ponto e vírgula a serem definidos. O valor deve ser do tipo String. Consulte -define (Opções do Compilador C#).
debug	Emita informações de depuração com saída. O valor deve ser do tipo Boolean. Full ou pdb-only não podem ser especificados. Consulte -debug (Opções do Compilador C#).
doc	Nome do arquivo no qual colocar comentários XML. O valor deve ser do tipo String. Consulte -doc (Opções do Compilador C#).
filealign	Tamanho do alinhamento da seção PE. O valor deve ser do tipo UInt32. Consulte -filealign (Opções do compilador C#).
incr	Habilite a recompilação incremental. O valor deve ser do tipo Boolean.
lib	Caminhos adicionais para pesquisar ao localizar módulos e assemblies referenciados. O valor deve ser do tipo String. Consulte -lib (Opções do Compilador C#).
linkres	Vincule um recurso gerenciado ao assembly. O valor deve ser do tipo String. Consulte -linkresource (Opções do compilador C#).
m	Digite para pesquisar o método Main. O valor deve ser do tipo String. Consulte -main (Opções do compilador C#).
nostdlib	Não faça referência automática mscorlib.dll. O valor deve ser do tipo Boolean. Consulte -nostdlib (Opções do compilador C#).
nowarn	Lista de números de aviso separados por ponto e vírgula para não relatar. O valor deve ser do tipo String. Consulte -nowarn (Opções do compilador C#).
o	Habilitar otimizações do compilador. O valor deve ser do tipo Boolean. Consulte -optimize (Opções do Compilador C#).
r	Assemblies referenciados. O valor deve ser do tipo String. Se mais de um assembly for especificado, o nome do arquivo deverá ser separado pela barra vertical ou pelo caractere de pipe. Consulte -reference (Opções do compilador C#).
res	Insira um recurso gerenciado. O valor deve ser do tipo String. Consulte -resource (Opções do Compilador C#).
target	Tipo de destino do arquivo de saída, um dos seguintes: "library", "exe", "winexe" ou "module". O valor deve ser do tipo String. Consulte -target (Opções do compilador C#).
unsafe	Permitir constructos não seguros. O valor deve ser do tipo Boolean. Consulte -unsafe (Opções do compilador C#).
w	Nível de aviso (0-4). O valor deve ser do tipo String. Consulte -warn (Opções do compilador C#).
warnaserror	O aviso de relatório diagnóstico como erros. O valor deve ser do tipo Boolean. Consulte -warnaserror (Opções do compilador C#).
win32icon	Ícone do Win32 para o recurso Win32 gerado automaticamente. O valor deve ser do tipo String. Consulte -win32icon (Opções do compilador C#).
win32res	Arquivo de recurso win32. O valor deve ser do tipo String. Consulte -win32res (Opções do compilador C#).

Confira também

• Compiler
• #line (Referência de C#)
• -reference (opções do compilador do C#)
• Opções do compilador de C#