Csc — Zadanie

Opakowuje plik csc.exe i tworzy pliki wykonywalne (pliki exe), biblioteki linku dynamicznego (pliki dll) lub moduły kodu (pliki .netmodule). Aby uzyskać więcej informacji na temat pliku csc.exe, zobacz Opcje kompilatora języka C#.

Parametry

W poniższej tabeli opisano parametry Csc zadania.

Parametr	Opis
AdditionalLibPaths	Opcjonalny String[] parametr. Określa dodatkowe katalogi do wyszukiwania odwołań. Aby uzyskać więcej informacji, zobacz -lib (opcje kompilatora C#).
AddModules	Opcjonalny String parametr. Określa co najmniej jeden moduł, który ma być częścią zestawu. Aby uzyskać więcej informacji, zobacz -addmodule (opcje kompilatora języka C#).
AllowUnsafeBlocks	Opcjonalny Boolean parametr. Jeśli trueelement , kompiluje kod, który używa niebezpiecznego słowa kluczowego. Aby uzyskać więcej informacji, zobacz -unsafe (opcje kompilatora języka C#).
ApplicationConfiguration	Opcjonalny String parametr. Określa plik konfiguracji aplikacji zawierający ustawienia powiązania zestawu.
BaseAddress	Opcjonalny String parametr. Określa preferowany adres podstawowy, pod którym ma być ładowana biblioteka DLL. Domyślny adres podstawowy biblioteki DLL jest ustawiany przez środowisko uruchomieniowe języka wspólnego programu .NET Framework. Aby uzyskać więcej informacji, zobacz -baseaddress (opcje kompilatora języka C#).
CheckForOverflowUnderflow	Opcjonalny Boolean parametr. Określa, czy arytmetyka całkowita, która przepełnia granice typu danych, powoduje wyjątek w czasie wykonywania. Aby uzyskać więcej informacji, zobacz -checked (opcje kompilatora C#).
ChecksumAlgorithm	Opcjonalny String parametr. Określa algorytm obliczania sumy kontrolnej pliku źródłowego przechowywanej w pliku PDB. Algorytm musi mieć wartość SHA1 (wartość domyślna) lub SHA256. Zobacz ChecksumAlgorithm.
CodeAnalysisRuleset	Opcjonalny String parametr. Określa plik zestawu reguł, który wyłącza określoną diagnostykę. Zobacz CodeAnalysisRuleset.
CodePage	Opcjonalny Int32 parametr. Określa stronę kodów, która ma być używana dla wszystkich plików kodu źródłowego w kompilacji. Aby uzyskać więcej informacji, zobacz -codepage (opcje kompilatora C#).
DebugType	Opcjonalny String parametr. Określa typ debugowania. DebugType może mieć wartość full lub pdbonly. Wartość domyślna to full, która umożliwia dołączanie debugera do uruchomionego programu. Określenie umożliwia debugowanie pdbonly kodu źródłowego po uruchomieniu programu w debugerze, ale wyświetla asemblera tylko wtedy, gdy uruchomiony program jest dołączony do debugera. Ten parametr zastępuje EmitDebugInformation parametr . Aby uzyskać więcej informacji, zobacz -debug (opcje kompilatora języka C#).
DefineConstants	Opcjonalny String parametr. Definiuje symbole preprocesora. Aby uzyskać więcej informacji, zobacz -define (opcje kompilatora języka C#).
DelaySign	Opcjonalny Boolean parametr. Jeśli trueparametr określa, że chcesz umieścić klucz publiczny tylko w zestawie. Jeśli falseparametr określa, że chcesz w pełni podpisanego zestawu Ten parametr nie ma żadnego efektu, chyba że jest używany z parametrem KeyFile lub KeyContainer . Aby uzyskać więcej informacji, zobacz -delaysign (opcje kompilatora C#).
Deterministic	Opcjonalny Boolean parametr. Jeśli truepolecenie , powoduje, że kompilator wyprowadza zestaw, którego zawartość binarna jest identyczna w kompilacjach, jeśli dane wejściowe są identyczne. Aby uzyskać więcej informacji, zobacz -deterministyczne (opcje kompilatora języka C#).
DisabledWarnings	Opcjonalny String parametr. Określa listę ostrzeżeń, które mają być wyłączone. Aby uzyskać więcej informacji, zobacz -nowarn (opcje kompilatora C#).
DocumentationFile	Opcjonalny String parametr. Przetwarza komentarze dokumentacji do pliku XML. Aby uzyskać więcej informacji, zobacz -doc (opcje kompilatora C#).
EmbedAllSources	Opcjonalny Boolean parametr. Osadź wszystkie pliki źródłowe w pliku PDB. Aby uzyskać więcej informacji, zobacz -embed (opcje kompilatora języka C#)
EmitDebugInformation	Opcjonalny Boolean parametr. Jeśli truezadanie generuje informacje debugowania i umieszcza je w pliku bazy danych programu (.pdb). Jeśli falsezadanie nie emituje żadnych informacji debugowania. Wartość domyślna to false. Aby uzyskać więcej informacji, zobacz -debug (opcje kompilatora języka C#).
ErrorLog	Opcjonalny String parametr. Określa plik do rejestrowania wszystkich diagnostyki kompilatora i analizatora. Zobacz Dziennik błędów.
ErrorReport	Opcjonalny String parametr. Zapewnia wygodny sposób zgłaszania błędu wewnętrznego języka C# firmie Microsoft. Ten parametr może mieć wartość prompt, sendlub none. Jeśli parametr ma wartość prompt, zostanie wyświetlony monit po wystąpieniu wewnętrznego błędu kompilatora. Monit umożliwia wysłanie raportu o usterce elektronicznie do firmy Microsoft. Jeśli parametr jest ustawiony na sendwartość , raport o usterce zostanie wysłany automatycznie. Jeśli parametr jest ustawiony na nonewartość , błąd jest zgłaszany tylko w danych wyjściowych tekstu kompilatora. Wartość domyślna to none. Aby uzyskać więcej informacji, zobacz -errorreport (opcje kompilatora języka C#).
FileAlignment	Opcjonalny Int32 parametr. Określa rozmiar sekcji w pliku wyjściowym. Aby uzyskać więcej informacji, zobacz -filealign (opcje kompilatora języka C#).
GenerateFullPaths	Opcjonalny Boolean parametr. Jeśli trueparametr określa ścieżkę bezwzględną do pliku w danych wyjściowych kompilatora. Jeśli falseparametr określa nazwę pliku. Wartość domyślna to false. Aby uzyskać więcej informacji, zobacz -fullpaths (opcje kompilatora języka C#).
HighEntropyVA	Opcjonalny Boolean parametr Włącz losowe układy przestrzeni adresowej o wysokiej entropii (ASLR). Zobacz HighEntropyVA.
KeyContainer	Opcjonalny String parametr. Określa nazwę kontenera kluczy kryptograficznych. Aby uzyskać więcej informacji, zobacz -keycontainer (opcje kompilatora języka C#).
KeyFile	Opcjonalny String parametr. Określa nazwę pliku zawierającą klucz kryptograficzny. Aby uzyskać więcej informacji, zobacz -keyfile (opcje kompilatora języka C#).
LangVersion	Opcjonalny String parametr. Określa wersję języka do użycia. Aby uzyskać więcej informacji, zobacz -langversion (opcje kompilatora C#).
LinkResources	Opcjonalny ITaskItem[] parametr. Tworzy link do zasobu programu .NET Framework w pliku wyjściowym; plik zasobu nie jest umieszczany w pliku wyjściowym. Elementy przekazane do tego parametru mogą mieć opcjonalne wpisy metadanych o nazwach i LogicalName Access. LogicalName odpowiada parametrowi identifier przełącznika /linkresource i Access odpowiada parametrowi accessibility-modifier . Aby uzyskać więcej informacji, zobacz -linkresource (opcje kompilatora C#).
MainEntryPoint	Opcjonalny String parametr. Określa lokalizację Main metody. Aby uzyskać więcej informacji, zobacz -main (opcje kompilatora C#).
ModuleAssemblyName	Opcjonalny String parametr. Określa nazwę zestawu, który będzie częścią tego modułu.
NoConfig	Opcjonalny Boolean parametr. Jeśli truepolecenie , informuje kompilator, aby nie kompilować przy użyciu pliku csc.rsp . Aby uzyskać więcej informacji, zobacz -noconfig (opcje kompilatora języka C#).
NoLogo	Opcjonalny Boolean parametr. Jeśli truewartość , pomija wyświetlanie informacji baneru kompilatora. Aby uzyskać więcej informacji, zobacz -nologo (opcje kompilatora C#).
NoStandardLib	Opcjonalny Boolean parametr. Jeśli trueprogram uniemożliwia importowanie biblioteki mscorlib.dll, która definiuje całą przestrzeń nazw systemu. Użyj tego parametru, jeśli chcesz zdefiniować lub utworzyć własną przestrzeń nazw systemu i obiekty. Aby uzyskać więcej informacji, zobacz -nostdlib (opcje kompilatora języka C#).
NoWin32Manifest	Opcjonalny Boolean parametr. Jeśli trueparametr nie zawiera domyślnego manifestu Win32.
Nullable	Opcjonalny String parametr. Określa kontekst dopuszczalny do wartości null. Argument musi być jednym z enable, disable, warningslub annotations. Zobacz Dopuszczanie wartości null.
Optimize	Opcjonalny Boolean parametr. Jeśli trueprogram włącza optymalizacje. Jeśli falseprogram wyłączy optymalizacje. Aby uzyskać więcej informacji, zobacz -optimize (opcje kompilatora języka C#).
OutputAssembly	Opcjonalny String parametr wyjściowy. Określa nazwę pliku wyjściowego. Aby uzyskać więcej informacji, zobacz -out (opcje kompilatora C#).
OutputRefAssembly	Opcjonalny String parametr. Określa nazwę wyjściowego pliku zestawu odwołania. Aby uzyskać więcej informacji, zobacz -refout (opcje kompilatora języka C#).
PathMap	Opcjonalny String parametr. Określa sposób mapowania ścieżek fizycznych na nazwy ścieżek źródłowych wyjściowych przez kompilator. Zobacz PathMap (Mapa ścieżki).
PdbFile	Opcjonalny String parametr. Określa nazwę pliku informacji debugowania. Domyślną nazwą jest nazwa pliku wyjściowego z rozszerzeniem .pdb .
Platform	Opcjonalny String parametr. Określa platformę procesora, która ma być objęta plikiem wyjściowym. Ten parametr może mieć wartość x86, x64lub anycpu. Wartość domyślna to anycpu. Aby uzyskać więcej informacji, zobacz -platform (opcje kompilatora języka C#).
PreferredUILang	Opcjonalny String parametr. Określa język, w którym kompilator języka C# wyświetla dane wyjściowe, takie jak komunikaty o błędach. Zobacz PreferredUILang.
PublicSign	Opcjonalny Boolean parametr. Podpisz publicznie zestaw wyjściowy. Zobacz PublicSign.
References	Opcjonalny ITaskItem[] parametr. Powoduje, że zadanie importuje informacje o typie publicznym z określonych elementów do bieżącego projektu. Aby uzyskać więcej informacji, zobacz -reference (opcje kompilatora języka C#). Alias odwołania w języku C# można określić w pliku MSBuild, dodając metadane Aliases do oryginalnego elementu "Odwołanie". Aby na przykład ustawić alias "LS1" w następującym wierszu polecenia Csc: CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs należy użyć: <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	Opcjonalny Boolean parametr. Utwórz zestaw referencyjny zamiast pełnego zestawu jako podstawowe dane wyjściowe. Zobacz Artykuł ProduceOnlyReferenceAssembly.
ReportAnalyzer	Opcjonalny Boolean parametr. Zgłaszanie dodatkowych informacji analizatora, takich jak czas wykonywania. Zobacz ReportAnalyzer.
Resources	Opcjonalny ITaskItem[] parametr. Osadza zasób .NET Framework w pliku wyjściowym. Elementy przekazane do tego parametru mogą mieć opcjonalne wpisy metadanych o nazwach i LogicalName Access. LogicalName odpowiada parametrowi identifier przełącznika /resource i Access odpowiada parametrowi accessibility-modifier . Aby uzyskać więcej informacji, zobacz -resource (opcje kompilatora języka C#).
ResponseFiles	Opcjonalny String parametr. Określa plik odpowiedzi zawierający polecenia dla tego zadania. Aby uzyskać więcej informacji, zobacz @ (Określ plik odpowiedzi).
Sources	Opcjonalny ITaskItem[] parametr. Określa co najmniej jeden plik źródłowy języka C#.
TargetType	Opcjonalny String parametr. Określa format pliku wyjściowego. Ten parametr może mieć wartość library, która tworzy bibliotekę kodu, exe, która tworzy aplikację konsolową , module, która tworzy moduł lub winexe, co tworzy program systemu Windows. Wartość domyślna to library. Aby uzyskać więcej informacji, zobacz -target (opcje kompilatora języka C#).
TreatWarningsAsErrors	Opcjonalny Boolean parametr. Jeśli trueparametr traktuje wszystkie ostrzeżenia jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (opcje kompilatora C#).
UseHostCompilerIfAvailable	Opcjonalny Boolean parametr. Nakazuje zadaniu użycie obiektu kompilatora w procesie, jeśli jest dostępny. Używane tylko przez program Visual Studio.
Utf8Output	Opcjonalny Boolean parametr. Rejestruje dane wyjściowe kompilatora przy użyciu kodowania UTF-8. Aby uzyskać więcej informacji, zobacz -utf8output (opcje kompilatora C#).
WarningLevel	Opcjonalny Int32 parametr. Określa poziom ostrzeżenia dla kompilatora do wyświetlenia. Aby uzyskać więcej informacji, zobacz -warn (opcje kompilatora C#).
WarningsAsErrors	Opcjonalny String parametr. Określa listę ostrzeżeń, które mają być traktowane jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (opcje kompilatora C#). Ten parametr zastępuje TreatWarningsAsErrors parametr .
WarningsNotAsErrors	Opcjonalny String parametr. Określa listę ostrzeżeń, które nie są traktowane jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (opcje kompilatora C#). Ten parametr jest przydatny tylko wtedy, gdy TreatWarningsAsErrors parametr jest ustawiony na truewartość .
Win32Icon	Opcjonalny String parametr. Wstawia plik ico do zestawu, który daje plik wyjściowy żądany wygląd w Eksplorator plików. Aby uzyskać więcej informacji, zobacz -win32icon (opcje kompilatora C#).
Win32Manifest	Opcjonalny String parametr. Określa manifest Win32, który ma zostać uwzględniony.
Win32Resource	Opcjonalny String parametr. Wstawia plik zasobu Win32 (res) do pliku wyjściowego. Aby uzyskać więcej informacji, zobacz -win32res (opcje kompilatora C#).

Parametry toolTaskExtension

To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.

W poniższej tabeli opisano parametry klas bazowych:

Parametr	Opis
EchoOff	Opcjonalny bool parametr. Gdy jest ustawiona wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout.
EnvironmentVariables	Opcjonalny String parametr tablicy. Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2.
ExitCode	Opcjonalny Int32 parametr tylko do odczytu. Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1.
LogStandardErrorAsError	Opcjonalny bool parametr. Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy.
StandardErrorImportance	Opcjonalny String parametr. Ważność rejestrowania tekstu ze standardowego strumienia błędów.
StandardOutputImportance	Opcjonalny String parametr. Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego.
Timeout	Opcjonalny Int32 parametr. Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach.
ToolExe	Opcjonalny string parametr. Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName.
ToolPath	Opcjonalny string parametr. Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
UseCommandProcessor	Opcjonalny bool parametr. Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia.
YieldDuringToolExecution	Opcjonalny bool parametr. Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane.

Przykład

W poniższym przykładzie użyto Csc zadania do skompilowania pliku wykonywalnego z plików źródłowych w kolekcji Compile elementów.

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

Zobacz też

• Dokumentacja zadania
• Zadania