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

Definición

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

Compila los orígenes de C# especificados en 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 tipo cadena, cada una con código de C#.

sourceTextNames
String[]

Matriz de tipo cadena que contiene los nombres de archivo de cada sourceTexts.

target
String

Nombre del archivo de salida. Este argumento es obligatorio.

imports
String[]

Matriz de tipo cadena, con archivos a los que se va a hacer referencia.

options
IDictionary

de IDictionary 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 realizó 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 es el mismo tamaño que sourceTexts.

Comentarios

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

Los nombres de archivo del sourceTextNames parámetro se usan para el diagnóstico del compilador y 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 /reference opción del compilador. Este parámetro puede ser null.

Para el options parámetro , la clave es la forma abreviada 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 valores reconocidos.

Nombre de clave Usage
addmodule Lista de módulos que se van a incluir en este ensamblado. Los nombres de módulo deben estar separados por la barra vertical o el carácter de canalización. El valor debe ser de tipo String. Consulte -addmodule (Opciones del compilador de C#).
baseaddress Dirección base de las bibliotecas. El valor debe ser de tipo UInt32. Consulte -baseaddress (Opciones del compilador de C#).
bugreport Genera un archivo de informe de errores. El valor debe ser de tipo String. Consulte -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. Consulte -checked (Opciones del compilador de C#).
d Lista de símbolos separados por punto y coma que se van a definir. El valor debe ser de tipo String. Consulte -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 solo pdb o completo. Consulte -debug (Opciones del compilador de C#).
doc Nombre de archivo en el que se van a colocar comentarios XML. El valor debe ser de tipo String. Consulte -doc (Opciones del compilador de C#).
filealign Tamaño de alineación de sección pe. El valor debe ser de tipo UInt32. Consulte -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. Consulte -lib (Opciones del compilador de C#).
linkres Vincule un recurso administrado al ensamblado. El valor debe ser de tipo String. Consulte -linkresource (Opciones del compilador de C#).
m Escriba para buscar el método Main. El valor debe ser de tipo String. Consulte -main (Opciones del compilador de C#).
nostdlib No haga referencia automática mscorlib.dll. El valor debe ser de tipo Boolean. Consulte -nostdlib (Opciones del compilador de C#).
nowarn Lista de números de advertencia separados por punto y coma que no se van a notificar. El valor debe ser de tipo String. Consulte -nowarn (Opciones del compilador de C#).
o Habilite las optimizaciones del compilador. El valor debe ser de tipo Boolean. Consulte -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 la barra vertical o el carácter de canalización. Consulte -reference (Opciones del compilador de C#).
res Inserción de un recurso administrado. El valor debe ser de tipo String. Consulte -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. Consulte -target (Opciones del compilador de C#).
unsafe Permitir construcciones no seguras. El valor debe ser de tipo Boolean. Consulte -unsafe (Opciones del compilador de C#).
w Nivel de advertencia (0-4). El valor debe ser de tipo String. Consulte -warn (Opciones del compilador de C#).
warnaserror Notificar diagnósticos de advertencias como errores. El valor debe ser de tipo Boolean. Consulte -warnaserror (Opciones del compilador de C#).
win32icon Icono de Win32 para el recurso Win32 generado automáticamente. El valor debe ser de tipo String. Consulta -win32icon (Opciones del compilador de C#).
win32res Archivo de recursos win32. El valor debe ser de tipo String. Consulte -win32res (Opciones del compilador de C#).

Se aplica a

Consulte también