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

Definição

Espaço de Nomes:
Microsoft.CSharp
Assemblagem:
cscompmgd.dll

Compila as fontes C# dadas para o ficheiro 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[]

Um array de cadeias de tipos, cada uma com código C#.

sourceTextNames
String[]

Um array de cadeia de tipos que contém os nomes dos ficheiros de cada sourceText.

target
String

O nome do arquivo de saída. Este argumento é obrigatório.

imports
String[]

Um array de cadeias de tipos, com ficheiros para referência.

options
IDictionary

Uma IDictionary das opções do compilador.

Devoluções

CompilerError[]

Devolve mensagens de diagnóstico como um array do tipo CompilerError. Se o array estiver vazio ou todos os elementos forem avisos, a compilação teve sucesso.

Exceções

ArgumentNullException

sourceTexts é null.

-ou-

sourceTextNames é null.

-ou-

target é null.

ArgumentOutOfRangeException

sourceTexts é um array vazio.

-ou-

sourceTextNames não tem o mesmo tamanho que sourceTexts.

Observações

Cada cadeia do sourceTexts parâmetro equivale a um único ficheiro fonte. Tem de haver pelo menos um sourceTexts elemento.

Os nomes dos ficheiros no sourceTextNames parâmetro são usados para diagnóstico do compilador e informação de depuração. O array é obrigatório, mas pode ser sobreposto localmente através do uso da #line diretiva. O array deve ter o mesmo número de elementos que o sourceTexts parâmetro.

O imports parâmetro é o mesmo da /reference opção do compilador. Este parâmetro pode ser null.

Para o options parâmetro, a chave é a forma abreviada 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 seguinte mostra as opções e valores reconhecidos.

Nome da chave Utilização
addmodule Lista de módulos a incluir nesta assembleia. Os nomes dos módulos devem ser separados pelo carácter vertical de barra ou tubo. O valor deve ser do tipo String. Ver -addmodule (Opções do compilador C#).
baseaddress Endereço base para bibliotecas. O valor deve ser do tipo UInt32. Ver -baseaddress (Opções do compilador C#).
bugreport Produz um ficheiro de relatório de bugs. O valor deve ser do tipo String. Ver -bugreport (Opções do compilador C#).
checked Defina a avaliação de expressão por defeito para verificada (ou desmarcada). O valor deve ser do tipo Boolean. Ver -verificado (Opções do compilador C#).
d Lista de símbolos separados por ponto e vírgula a definir. O valor deve ser do tipo String. Ver -define (Opções do compilador C#).
debug Emitir informação de depuração com saída. O valor deve ser do tipo Boolean. Não se pode especificar o total ou apenas PDB. Ver -debug (Opções do compilador C#).
doc Nome do ficheiro para colocar comentários XML. O valor deve ser do tipo String. Ver -doc (Opções do compilador C#).
filealign Tamanho do alinhamento da secção PE. O valor deve ser do tipo UInt32. Ver -filealign (Opções do compilador C#).
incr Permitir a reconstrução incremental. O valor deve ser do tipo Boolean.
lib Caminhos adicionais para pesquisa ao localizar módulos e assemblagens referenciadas. O valor deve ser do tipo String. Ver -lib (Opções do compilador C#).
linkres Liga um recurso gerido à assembleia. O valor deve ser do tipo String. Veja -linkresource (Opções do compilador C#).
m Escreva para pesquisar o método principal. O valor deve ser do tipo String. Ver -main (Opções do compilador C#).
nostdlib Não faça referência automática mscorlib.dll. O valor deve ser do tipo Boolean. Ver -nostdlib (Opções do compilador C#).
nowarn Lista de números de aviso separados por ponto e vírgula para não reportar. O valor deve ser do tipo String. Ver -nowarn (Opções do compilador C#).
o Ativar as otimizações do compilador. O valor deve ser do tipo Boolean. Veja -optimize (Opções do compilador C#).
r Montagens referenciadas. O valor deve ser do tipo String. Se for especificado mais do que um conjunto, o nome do ficheiro deve ser separado pelo carácter vertical da barra ou do pipe. Veja -reference (Opções do compilador C#).
res Incorpore um recurso gerido. O valor deve ser do tipo String. Ver -resource (Opções do compilador C#).
target Tipo de alvo do ficheiro de saída, um dos seguintes: "library", "exe", "winexe" ou "module". O valor deve ser do tipo String. Ver -target (Opções do compilador C#).
unsafe Permitir construções inseguras. O valor deve ser do tipo Boolean. Ver -unsafe (Opções do compilador C#).
w Nível de aviso (0-4). O valor deve ser do tipo String. Ver -warn (Opções do compilador C#).
warnaserror Reporte os diagnósticos de aviso como erros. O valor deve ser do tipo Boolean. Ver -warnaserror (Opções do compilador C#).
win32icon Ícone Win32 para recurso Win32 gerado automaticamente. O valor deve ser do tipo String. Veja -win32icon (Opções do compilador C#).
win32res Ficheiro de recurso Win32. O valor deve ser do tipo String. Ver -win32res (Opções do compilador C#).

Aplica-se a

Ver também