Udostępnij za pośrednictwem

Compiler.Compile(String[], String[], String, String[], IDictionary) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.CSharp
Zestaw:
cscompmgd.dll

Kompiluje dane źródła języka C# do określonego pliku docelowego.

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()

Parametry

sourceTexts
String[]

Tablica typu ciąg, z których każdy ma kod w języku C#.

sourceTextNames
String[]

Tablica typu ciąg zawierająca nazwy plików dla każdego elementu sourceTexts.

target
String

Nazwa pliku wyjściowego. Ten argument jest wymagany.

imports
String[]

Tablica typu ciąg z plikami do odwołania.

options
IDictionary

Element IDictionary opcji kompilatora.

Zwraca

CompilerError[]

Zwraca komunikaty diagnostyczne jako tablicę typu CompilerError. Jeśli tablica jest pusta lub wszystkie elementy są ostrzeżeniami, kompilacja zakończyła się pomyślnie.

Wyjątki

ArgumentNullException

sourceTexts to null.

-lub-

sourceTextNames to null.

-lub-

target to null.

ArgumentOutOfRangeException

sourceTexts jest pustą tablicą.

-lub-

sourceTextNames nie jest tym samym rozmiarem co sourceTexts.

Uwagi

Każdy ciąg w parametrze sourceTexts jest odpowiednikiem pojedynczego pliku źródłowego. Musi istnieć co najmniej jeden sourceTexts element.

Nazwy plików w parametrze sourceTextNames są używane do diagnostyki kompilatora i informacji debugowania. Tablica jest wymagana, ale można ją lokalnie zastąpić za pomocą #line dyrektywy . Tablica musi mieć taką samą liczbę elementów jak sourceTexts parametr .

Parametr imports jest taki sam jak opcja kompilatora /reference . Ten parametr może mieć wartość null.

Dla parametru options klucz jest krótką formą opcji kompilatora. Wartość jest wartością żądaną dla opcji. Parametr options może mieć wartość null. Niektóre opcje kompilatora nie są rozpoznawane. W poniższej tabeli przedstawiono rozpoznane opcje i wartości.

Nazwa klucza Użycie
addmodule Lista modułów do uwzględnienia w tym zestawie. Nazwy modułów muszą być oddzielone znakiem pionowego paska lub potoku. Wartość musi być typu String. Zobacz -addmodule (opcje kompilatora C#).
baseaddress Podstawowy adres bibliotek. Wartość musi być typu UInt32. Zobacz -baseaddress (Opcje kompilatora C#).
bugreport Tworzy plik raportu o błędach. Wartość musi być typu String. Zobacz -bugreport (Opcje kompilatora C#).
checked Ustaw domyślną ocenę wyrażenia na zaznaczoną (lub niezaznaczoną). Wartość musi być typu Boolean. Zobacz -checked (Opcje kompilatora C#).
d Lista symboli rozdzielonych średnikami do zdefiniowania. Wartość musi być typu String. Zobacz -define (Opcje kompilatora C#).
debug Emituj informacje debugowania z danymi wyjściowymi. Wartość musi być typu Boolean. Nie można określić tylko pełnych lub pdb. Zobacz -debug (opcje kompilatora języka C#).
doc Nazwa pliku do umieszczenia komentarzy XML. Wartość musi być typu String. Zobacz -doc (Opcje kompilatora C#).
filealign Rozmiar wyrównania sekcji PE. Wartość musi być typu UInt32. Zobacz -filealign (opcje kompilatora C#).
incr Włącz kompilowanie przyrostowe. Wartość musi być typu Boolean.
lib Dodatkowe ścieżki do wyszukiwania podczas lokalizowania modułów i zestawów, do których się odwołujesz. Wartość musi być typu String. Zobacz -lib (Opcje kompilatora C#).
linkres Połącz zasób zarządzany z zestawem. Wartość musi być typu String. Zobacz -linkresource (opcje kompilatora C#).
m Wpisz , aby wyszukać metodę Main. Wartość musi być typu String. Zobacz -main (Opcje kompilatora C#).
nostdlib Nie odwołuj się automatycznie mscorlib.dll. Wartość musi być typu Boolean. Zobacz -nostdlib (opcje kompilatora C#).
nowarn Lista rozdzielonych średnikami numerów ostrzeżeń, które nie mają być raportowane. Wartość musi być typu String. Zobacz -nowarn (opcje kompilatora C#).
o Włącz optymalizacje kompilatora. Wartość musi być typu Boolean. Zobacz -optimize (Opcje kompilatora C#).
r Zestawy, do których odwołuje się odwołanie. Wartość musi być typu Ciąg. Jeśli określono więcej niż jeden zestaw, nazwa pliku musi być oddzielona pionowym paskiem lub znakiem potoku. Zobacz -reference (Opcje kompilatora C#).
res Osadź zasób zarządzany. Wartość musi być typu String. Zobacz -resource (Opcje kompilatora C#).
target Typ docelowy pliku wyjściowego, jeden z następujących: "library", "exe", "winexe" lub "module". Wartość musi być typu String. Zobacz -target (Opcje kompilatora C#).
unsafe Zezwalaj na niebezpieczne konstrukcje. Wartość musi być typu Boolean. Zobacz -unsafe (Opcje kompilatora języka C#).
w Poziom ostrzeżenia (0–4). Wartość musi być typu String. Zobacz -warn (Opcje kompilatora języka C#).
warnaserror Zgłoś diagnostykę ostrzegawczą jako błędy. Wartość musi być typu Boolean. Zobacz -warnaserror (opcje kompilatora C#).
win32icon Ikona Win32 dla automatycznie wygenerowanego zasobu Win32. Wartość musi być typu String. Zobacz -win32icon (opcje kompilatora C#).
win32res Plik zasobów Win32. Wartość musi być typu String. Zobacz -win32res (opcje kompilatora C#).

Dotyczy

Zobacz też