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

  • Referencia

Definición

Espacio de nombres:
Microsoft.CSharp
Ensamblado:
cscompmgd.dll

Compila los orígenes de C# dados para el archivo 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[]

Matriz de cadenas de tipo, cada una con código de C#.

sourceTextNames
String[]

Matriz de cadenas de tipo que contiene los nombres de archivo de cada elemento sourceTexts.

target
String

Nombre del archivo de salida. Este argumento es obligatorio.

imports
String[]

Matriz de cadenas de tipo, con archivos a los que hacer referencia.

options
IDictionary

IDictionary de opciones del compilador.

Devoluciones

CompilerError[]

Devuelve mensajes de diagnóstico como una matriz de tipo CompilerError. Si la matriz está vacía o todos los elementos son advertencias, la compilación se ha realizado correctamente.

Excepciones

ArgumentNullException

sourceTexts es null.

O bien

sourceTextNames es null.

O bien

target es null.

ArgumentOutOfRangeException

sourceTexts es una matriz vacía.

O bien

sourceTextNames no tiene el mismo tamaño que sourceTexts.

Comentarios

Cada cadena del sourceTexts parámetro es el equivalente de un único archivo de código fuente. Debe haber al menos un sourceTexts elemento.

Los nombres de archivo del parámetro se usan para el diagnóstico del compilador y sourceTextNames la información de depuración. La matriz es necesaria, pero se puede invalidar localmente mediante el uso de la #line directiva . La matriz debe tener el mismo número de elementos que el sourceTexts parámetro .

El imports parámetro es el mismo que la opción del /reference compilador. Este parámetro puede ser null.

Para el options parámetro , la clave es la forma corta de la opción del compilador. El valor es el valor deseado para la opción. El options parámetro puede ser null . Algunas opciones del compilador no se reconocen. En la tabla siguiente se muestran las opciones y los valores reconocidos.

Nombre de clave Uso
addmodule Lista de módulos que se incluirán en este ensamblado. Los nombres de módulo deben estar separados por el carácter vertical de barra o barra vertical. El valor debe ser de tipo String . Vea -addmodule (Opciones del compilador de C#).
baseaddress Dirección base de las bibliotecas. El valor debe ser de tipo UInt32 . Vea -baseaddress (Opciones del compilador de C#).
bugreport Genera el archivo de informe de errores. El valor debe ser de tipo String . Vea -bugreport (Opciones del compilador de C#).
checked Establezca la evaluación de expresiones predeterminada en activada (o desactivada). El valor debe ser de tipo Boolean . Vea -checked (Opciones del compilador de C#).
d Lista de símbolos separados por punto y coma que se definirán. El valor debe ser de tipo String . Vea -define (Opciones del compilador de C#).
debug Emita información de depuración con la salida. El valor debe ser de tipo Boolean . No se puede especificar full o pdb-only. Vea -debug (Opciones del compilador de C#).
doc Nombre de archivo en el que se colocarán los comentarios XML. El valor debe ser de tipo String . Vea -doc (Opciones del compilador de C#).
filealign Tamaño de alineación de la sección PE. El valor debe ser de tipo UInt32 . Vea -filealign (Opciones del compilador de C#).
incr Habilite la recompilación incremental. El valor debe ser de tipo Boolean .
lib Rutas de acceso adicionales para buscar al buscar módulos y ensamblados a los que se hace referencia. El valor debe ser de tipo String . Vea -lib (Opciones del compilador de C#).
linkres Vincule un recurso administrado al ensamblado. El valor debe ser de tipo String . Vea -linkresource (Opciones del compilador de C#).
m Escriba para buscar el método Main. El valor debe ser de tipo String . Vea -main (Opciones del compilador de C#).
nostdlib No haga referencia automática a mscorlib.dll. El valor debe ser de tipo Boolean . Vea -nostdlib (Opciones del compilador de C#).
nowarn Lista de números de advertencia separados por punto y coma que no se va a notificar. El valor debe ser de tipo String . Vea -nowarn (Opciones del compilador de C#).
o Habilite las optimizaciones del compilador. El valor debe ser de tipo Boolean . Vea -optimize (Opciones del compilador de C#).
r Ensamblados a los que se hace referencia. El valor debe ser de tipo String. Si se especifica más de un ensamblado, el nombre de archivo debe estar separado por el carácter de barra vertical o barra vertical. Vea -reference (Opciones del compilador de C#).
res Insertar un recurso administrado. El valor debe ser de tipo String . Vea -resource (Opciones del compilador de C#).
target Tipo de destino del archivo de salida, uno de los siguientes: "library", "exe", "winexe" o "module". El valor debe ser de tipo String . Vea -target (Opciones del compilador de C#).
unsafe Permitir construcciones no seguras. El valor debe ser de tipo Boolean . Vea -unsafe (Opciones del compilador de C#).
w Nivel de advertencia (0-4). El valor debe ser de tipo String . Vea -warn (Opciones del compilador de C#).
warnaserror Notificar diagnósticos de advertencia como errores. El valor debe ser de tipo Boolean . Vea -warnaserror (Opciones del compilador de C#).
win32icon Icono de Win32 para el recurso Win32 generado automáticamente. El valor debe ser de tipo String . Vea -win32icon (Opciones del compilador de C#).
win32res Archivo de recursos Win32. El valor debe ser de tipo String . Vea -win32res (Opciones del compilador de C#).

Se aplica a

Consulte también