Udostępnij za pośrednictwem


Kompilacja za pomocą wiersza polecenia przy użyciu csc.exe

Można wywołać kompilator języka C#, poprzez wpisanie nazwy pliku wykonywalnego (csc.exe) w wierszu polecenia.

W trakcie używania wiersza polecenia Visual Studio, wszystkie niezbędne zmienne środowiskowe są ustawione.W systemie Windows 7, można uzyskać dostęp do tego okna z menu Start, poprzez otwarcie folderu Microsoft Visual Studio Version\Visual Studio Tools.W systemie Windows 8, wiersz polecenia Visual Studio zmienił nazwę na Wiersz polecenia dla deweloperów w programie VS2012. Można go odnaleźć korzystając z wyszukiwarki ekranu Start.

W trakcie korzystania ze standardowego okna wiersza poleceń, należy skorygować ścieżkę kompilatora csc.exe zanim będzie można go wywołać w dowolnym podfolderze komputera.Należy również uruchomić vsvars32.bat aby skonfigurować odpowiednie zmienne środowiskowe do wspierana kompilacji z linii poleceń.Aby uzyskać więcej informacji dotyczących pliku vsvars32.bat, wliczając w to informacje na temat tego gdzie go znaleźć i jak go uruchomić, zobacz Porady: ustawianie zmiennych środowiskowych dla wiersza polecenia programu Visual Studio.

W trakcie pracy na komputerze, który posiada tylko Windows Software Development Kit (SDK), można skorzystać z kompilatora C# w wierszu polecenia SDK, który można uruchomić z menu opcji Microsoft .NET Framework SDK.

Można także skorzystać z MSBuild w celu programowej kompilacji programów napisanych w C#.Aby uzyskać więcej informacji, zobacz MSBuild.

Plik wykonywalny csc.exe zazwyczaj znajduje się w Microsoft.NET\Framework\Version w katalogu Windows.Jego lokalizacja może być różna, w zależności od konfiguracji konkretnego komputera.Jeśli zainstalowana jest więcej niż jedna wersja .NET framework, znajdziesz wiele wersji tego pliku.Aby uzyskać więcej informacji na temat tego typu instalacji, zobacz Określanie zainstalowanych wersji programu .NET Framework.

PoradaPorada

Podczas kompilacji projektu przy użyciu Visual Studio IDE, można wyświetlić polecenie csc i skojarzone z nim opcje kompilatora w oknie Wyjście.W celu wyświetlenia informacji, należy skorzystać z instrukcji Poradnik: Oglądanie, zapisywanie i konfigurowanie plików dziennika kompilacji do zmiany poziomu szczegółowości danych dziennika na Normalny lub Szczegółowy.Po ponownej kompilacji projektu, przeszukaj okno Wyjście w poszukiwaniu csc aby odnaleźć wywołanie kompilatora C#.

W tym temacie

  • Zasady składni wiersza polecenia

  • Przykładowe wiersze poleceń

  • Różnice między kompilatorem C# i danymi wyjściowymi kompilatora C++

Zasady składni wiersza polecenia dla kompilatora C#

Kompilator języka C# korzysta z następujących reguł, podczas interpretacji argumentów przekazanych przez wiersz polecenia systemu operacyjnego:

  • Argumenty są rozdzielone białym znakiem, który może być albo spacją albo tabulatorem.

  • Znak daszka (^) nie jest rozpoznawany jako znak ucieczki lub ogranicznik.Znak jest obsługiwany przez parser linii poleceń systemu operacyjnego przed przekazaniem go do tablicy argv w programie.

  • Ciąg osłonięty podwójnym cudzysłowem ("ciąg") jest interpretowany jako pojedynczy argument niezależnie od zawartych w nim białych znaków.Ciąg w cudzysłowie może być osadzony w argumencie.

  • Podwójny cudzysłów poprzedzony przez ukośnik odwrotny (\ ") jest interpretowany jako literał podwójnego znaku cudzysłowu (").

  • Ukośniki odwrotne są interpretowane dosłownie, chyba że bezpośrednio poprzedzają podwójny znak cudzysłowu.

  • Jeśli parzysta liczba odwrotnych ukośników jest poprzedzona podwójnym znakiem cudzysłowu, to w tablicy argv zostanie umieszczony jeden znak odwrotnego ukośnika dla każdej pary odwrotnych ukośników, a podwójny znak cudzysłowu traktowany będzie jako ogranicznik ciągu.

  • Jeśli nieparzysta liczba odwrotnych ukośników jest poprzedzona podwójnym znakiem cudzysłowu, to w tablicy argv zostanie umieszczony jeden znak odwrotnego ukośnika dla każdej pary odwrotnych ukośników, a podwójny znak cudzysłowu zostanie "zmieniony" przez pozostałe odwrotne ukośniki.To spowoduje dodanie literału podwójnego znaku cudzysłowu do argv.

Przykładowe wiersze poleceń dla kompilatora C#

  • Kompiluje File.cs dając File.exe:

    csc File.cs 
    
  • Kompiluje File.cs dając File.dll:

    csc /target:library File.cs
    
  • Kompiluje File.cs i tworzy My.exe:

    csc /out:My.exe File.cs
    
  • Kompiluje wszystkie pliki C# w bieżącym folderze z włączoną optymalizacją oraz definiuje symbol DEBUG.Wyjście to File2.exe:

    csc /define:DEBUG /optimize /out:File2.exe *.cs
    
  • Kompiluje wszystkie pliki C# w bieżącym folderze tworząc wersję do debugowania pliku File2.dll.Logo i ostrzeżenia nie zostaną wyświetlone:

    csc /target:library /out:File2.dll /warn:0 /nologo /debug *.cs
    
  • Kompiluje wszystkie pliki C# w bieżącym folderze do Something.xyz (DLL):

    csc /target:library /out:Something.xyz *.cs
    

Różnice między kompilatorem C# i danymi wyjściowymi kompilatora C++

W wyniku wywołania kompilatora C# nie są tworzone żadne pliki obiektów (.obj); pliki wyjściowe tworzone są bezpośrednio.W związku z tym, kompilator języka C# nie potrzebuje linkera.

Zobacz też

Zadania

Porady: wyświetlanie argumentów wiersza poleceń (Przewodnik programowania w języku C#)

Porady: uzyskiwanie dostępu do argumentów wiersza poleceń za pomocą instrukcji foreach (Przewodnik programowania w języku C#)

Informacje

Opcje kompilatora C# w porządku alfabetycznym

Opcje kompilatora C# w rozbiciu na kategorie

Argumenty wiersza poleceń (Przewodnik programowania w języku C#)

Zwracane wartości Main() (Przewodnik programowania w języku C#)

Koncepcje

Main() i argumenty wiersza poleceń (Przewodnik programowania w języku C#)

Inne zasoby

Opcje kompilatora C#