Compiler.Compile(String[], String[], String, String[], IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Компилирует данные источники C# в указанный файл назначения.
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()
Параметры
- sourceTexts
- String[]
Массив строкового типа, каждый из которых имеет код C#.
- sourceTextNames
- String[]
Массив строкового типа, содержащий имена файлов для каждого sourceTexts.
- target
- String
Имя выходного файла. Этот аргумент обязателен.
- imports
- String[]
Массив строкового типа с файлами для ссылки.
- options
- IDictionary
Объект IDictionary параметров компилятора.
Возвращаемое значение
Возвращает диагностические сообщения в виде массива типа CompilerError. Если массив пуст или все элементы являются предупреждениями, компиляция прошла успешно.
Исключения
sourceTexts
имеет значение null
.
-или-
sourceTextNames
имеет значение null
.
-или-
target
имеет значение null
.
sourceTexts
является пустым массивом.
-или-
sourceTextNames
отличается по размеру от sourceTexts
.
Комментарии
Каждая строка в параметре sourceTexts
является эквивалентом одного исходного файла. Должен быть хотя бы один sourceTexts
элемент.
Имена файлов в параметре sourceTextNames
используются для диагностика компилятора и сведений об отладке. Массив является обязательным, но его можно переопределить локально с помощью директивы #line
. Массив должен содержать то же количество элементов, что и sourceTexts
параметр .
Параметр imports
совпадает с параметром компилятора /reference
. Этот параметр может иметь значение null
.
options
Для параметра ключ является короткой формой параметра компилятора. Значение — это значение, требуемое для параметра. Параметр options
может иметь значение null
. Некоторые параметры компилятора не распознаются. В следующей таблице показаны распознанные параметры и значения.
Имя ключа | Использование |
---|---|
addmodule |
Список модулей для включения в эту сборку. Имена модулей должны быть разделены вертикальной чертой или символом канала. Значение должно иметь тип String. См. раздел -addmodule (параметры компилятора C#). |
baseaddress |
Базовый адрес для библиотек. Значение должно иметь тип UInt32. См. раздел -baseaddress (параметры компилятора C#). |
bugreport |
Создает файл отчета об ошибках. Значение должно иметь тип String. См. раздел -bugreport (параметры компилятора C#). |
checked |
Установите для вычисления выражений по умолчанию значение Checked (or unchecked). Значение должно иметь тип Boolean. См. раздел -checked (параметры компилятора C#). |
d |
Список символов, разделенных точкой с запятой, для определения. Значение должно иметь тип String. См. раздел -define (параметры компилятора C#). |
debug |
Выдача отладочной информации с выходными данными. Значение должно иметь тип Boolean. Невозможно указать full или pdb-only. См. раздел -debug (параметры компилятора C#). |
doc |
Имя файла для вставки XML-комментариев. Значение должно иметь тип String. См. раздел -doc (параметры компилятора C#). |
filealign |
Размер выравнивания разделов PE. Значение должно иметь тип UInt32. См. раздел -filealign (параметры компилятора C#). |
incr |
Включите добавочное перестроение. Значение должно иметь тип Boolean. |
lib |
Дополнительные пути для поиска при поиске модулей и сборок, на которые есть ссылки. Значение должно иметь тип String. См. раздел -lib (параметры компилятора C#). |
linkres |
Связывание управляемого ресурса со сборкой. Значение должно иметь тип String. См. раздел -linkresource (параметры компилятора C#). |
m |
Введите , чтобы найти метод Main. Значение должно иметь тип String. См. раздел -main (параметры компилятора C#). |
nostdlib |
Не указывайте автоматические ссылки на mscorlib.dll. Значение должно иметь тип Boolean. См. раздел -nostdlib (параметры компилятора C#). |
nowarn |
Список номеров предупреждений, разделенных точкой с запятой, которые не следует сообщать. Значение должно иметь тип String. См. раздел -nowarn (параметры компилятора C#). |
o |
Включите оптимизацию компилятора. Значение должно иметь тип Boolean. См. раздел -optimize (параметры компилятора C#). |
r |
Сборки, на которые есть ссылки. Значение должно иметь тип String. Если указано несколько сборок, имя файла должно быть разделено вертикальной чертой или символом канала. См. раздел -reference (параметры компилятора C#). |
res |
Внедрение управляемого ресурса. Значение должно иметь тип String. См. раздел -resource (параметры компилятора C#). |
target |
Тип целевого объекта выходного файла: "library", "exe", "winexe" или "module". Значение должно иметь тип String. См. раздел -target (параметры компилятора C#). |
unsafe |
Разрешить небезопасные конструкции. Значение должно иметь тип Boolean. См. раздел -unsafe (параметры компилятора C#). |
w |
Уровень предупреждения (0–4). Значение должно иметь тип String. См. раздел -warn (параметры компилятора C#). |
warnaserror |
Сообщите диагностика предупреждения как об ошибках. Значение должно иметь тип Boolean. См. раздел -warnaserror (параметры компилятора C#). |
win32icon |
Значок Win32 для автоматически созданного ресурса Win32. Значение должно иметь тип String. См. раздел -win32icon (параметры компилятора C#). |
win32res |
Файл ресурсов Win32. Значение должно иметь тип String. См. раздел -win32res (параметры компилятора C#). |