Strona kompilacji, Projektant projektu (C#)

Artykuł
03/02/2024

Użyj strony Kompilacja Projektant projektu, aby określić właściwości konfiguracji kompilacji projektu. Ta strona dotyczy tylko projektów Visual C#.

Aby uzyskać dostęp do strony Kompilacja, wybierz węzeł projektu (a nie węzeł rozwiązania) w Eksplorator rozwiązań. Następnie wybierz pozycję Widok, Strony właściwości w menu. Po wyświetleniu Projektant Project wybierz kartę Kompilacja.

Uwaga

Na komputerze mogą być wyświetlane różne nazwy lub lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio w tym artykule. Być może używasz innej wersji programu Visual Studio lub innych ustawień środowiska. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Konfiguracja i platforma

Poniższe opcje umożliwiają wybranie konfiguracji i platformy do wyświetlenia lub zmodyfikowania.

Uwaga

W przypadku uproszczonych konfiguracji kompilacji system projektu określa, czy utworzyć wersję debugowania, czy wydania. W związku z tym te opcje nie są wyświetlane. Aby uzyskać więcej informacji, zobacz How to: Set debug and release configurations (Instrukcje: ustawianie konfiguracji debugowania i wydawania).

Konfiguracja

Określa, które ustawienia konfiguracji mają być wyświetlane lub modyfikowane. Ustawienia mogą być aktywne (debugowanie) (jest to ustawienie domyślne), Debugowanie, Wydanie lub Wszystkie konfiguracje.

Platforma

Określa, które ustawienia platformy mają być wyświetlane lub modyfikowane. Ustawieniem domyślnym jest Aktywny (dowolny procesor) . Aktywną platformę można zmienić przy użyciu programu Configuration Manager. Aby uzyskać więcej informacji, zobacz How to: Create and Edit Configurations (Instrukcje: tworzenie i edytowanie konfiguracji).

Ogólne

Poniższe opcje umożliwiają skonfigurowanie kilku ustawień kompilatora języka C#.

Symbole kompilacji warunkowej

Określa symbole, na których ma być wykonywana kompilacja warunkowa. Oddzielaj symbole średnikami (";"). Aby uzyskać więcej informacji, zobacz /define (Opcje kompilatora C#).

Definiowanie stałej DEBUG

Definiuje debugowanie jako symbol we wszystkich plikach kodu źródłowego w aplikacji. Wybranie tej opcji jest równoważne użyciu /define:DEBUG opcji wiersza polecenia.

Definiowanie stałej TRACE

Definiuje funkcję TRACE jako symbol we wszystkich plikach kodu źródłowego w aplikacji. Wybranie tej opcji jest równoważne użyciu /define:TRACE opcji wiersza polecenia.

Element docelowy platformy

Określa procesor, który ma być docelowy przez plik wyjściowy. Wybierz x86 dla 32-bitowego procesora zgodnego z procesorem Intel, wybierz x64 dla 64-bitowego procesora Intel zgodnego z procesorem Intel, wybierz arm dla procesorów ARM lub wybierz dowolny procesor, aby określić, że dowolny procesor jest akceptowalny. Każdy procesor CPU jest wartością domyślną dla projektów, ponieważ umożliwia aplikacji uruchamianie na najszerszym zakresie sprzętu.

Aby uzyskać więcej informacji, zobacz /platform (Opcje kompilatora C#).

Nullable

Określa kontekst dopuszczalny do wartości null dla całego projektu w języku C#. Ta opcja interfejsu użytkownika została wprowadzona w programie Visual Studio 16.5 i jest włączona tylko dla projektów korzystających z języka C# 8.0 lub nowszego.

Aby uzyskać więcej informacji, zobacz Konteksty dopuszczane do wartości null.

Preferuj 32-bitowe

Jeśli pole wyboru Prefer32-bitowe jest zaznaczone, aplikacja działa jako aplikacja 32-bitowa zarówno w 32-bitowych, jak i 64-bitowych wersjach systemu Windows. Jeśli pole wyboru zostanie wyczyszczone, aplikacja działa jako aplikacja 32-bitowa w 32-bitowych wersjach systemu Windows i jako aplikacja 64-bitowa w 64-bitowych wersjach systemu Windows.

Jeśli uruchamiasz aplikację jako aplikację 64-bitową, rozmiar wskaźnika podwaja się, a problemy ze zgodnością mogą wystąpić z innymi bibliotekami, które są wyłącznie 32-bitowe. Warto uruchomić aplikację 64-bitową tylko wtedy, gdy potrzebuje więcej niż 4 GB pamięci lub instrukcji 64-bitowych, co zapewnia znaczną poprawę wydajności.

To pole wyboru jest dostępne tylko wtedy, gdy spełnione są wszystkie następujące warunki:

Na stronie kompilacji lista docelowa platformy jest ustawiona na Dowolne procesory CPU.
Na stronie aplikacji lista Typ danych wyjściowych określa, że projekt jest aplikacją.
Na stronie aplikacji lista Platforma docelowa określa program .NET Framework 4.5.

Zezwalaj na niebezpieczny kod

Umożliwia kompilowanie kodu, który używa niebezpiecznego słowa kluczowego. Aby uzyskać więcej informacji, zobacz /unsafe (Opcje kompilatora C#).

Optymalizowanie kodu

Włącz lub wyłącz optymalizacje wykonywane przez kompilator, aby plik wyjściowy był mniejszy, szybszy i bardziej wydajny. Aby uzyskać więcej informacji, zobacz /optimize (Opcje kompilatora C#).

Błędy i ostrzeżenia

Następujące ustawienia służą do konfigurowania opcji błędów i ostrzeżeń dla procesu kompilacji.

Poziom ostrzeżenia

Określa poziom do wyświetlenia dla ostrzeżeń kompilatora. Aby uzyskać więcej informacji, zobacz /warn (Opcje kompilatora C#).

Pomijanie ostrzeżeń

Blokuje możliwość generowania co najmniej jednego ostrzeżenia przez kompilatora. Rozdziel wiele numerów ostrzeżeń przecinkami lub średnikami. Aby uzyskać więcej informacji, zobacz /nowarn (Opcje kompilatora C#).

Traktuj ostrzeżenia jako błędy

Następujące ustawienia służą do określania, które ostrzeżenia są traktowane jako błędy. Wybierz jedną z następujących opcji, aby wskazać, jakie warunki mają zwracać błąd, gdy kompilacja napotka ostrzeżenie. Aby uzyskać więcej informacji, zobacz /warnaserror (Opcje kompilatora C#).

Brak — nie traktuje żadnych ostrzeżeń jako błędów.

Wszystkie — traktuje wszystkie ostrzeżenia jako błędy.

Określone ostrzeżenia — traktuje określone ostrzeżenia jako błędy. Rozdziel wiele numerów ostrzeżeń przecinkami lub średnikami.

Napiwek

Jeśli nie chcesz, aby ostrzeżenia analizy kodu były traktowane jako błędy, zobacz Często zadawane pytania dotyczące analizy kodu.

Wyjście

Następujące ustawienia służą do konfigurowania opcji danych wyjściowych dla procesu kompilacji.

Ścieżka wyjściowa

Określa lokalizację plików wyjściowych dla konfiguracji tego projektu. Wprowadź ścieżkę danych wyjściowych kompilacji w tym polu lub wybierz przycisk Przeglądaj , aby określić ścieżkę. Ścieżka jest względna; Jeśli wprowadzisz ścieżkę bezwzględną, zostanie on zapisany jako względny. Ścieżka domyślna to bin\Debug lub bin\Release\.

W przypadku uproszczonych konfiguracji kompilacji system projektu określa, czy utworzyć wersję debugowania, czy wydania. Polecenie Kompilacja z menu Debug (F5) spowoduje umieszczenie kompilacji w lokalizacji debugowania niezależnie od określonej ścieżki wyjściowej. Jednak polecenie Kompilacja z menu Kompilacja umieszcza je w określonej lokalizacji. Aby uzyskać więcej informacji, zobacz Opis konfiguracji kompilacji.

Plik dokumentacji XML

Określa nazwę pliku, do którego będą przetwarzane komentarze dokumentacji. Aby uzyskać więcej informacji, zobacz /doc (Opcje kompilatora C#).

Zarejestruj się w celu współdziałania modelu COM

Wskazuje, że aplikacja zarządzana uwidacznia obiekt COM (otokę wywoływaną com), która umożliwia obiektowi COM interakcję z aplikacją zarządzaną. Właściwość Typ danych wyjściowych na stronie Aplikacja Projektant projektu dla tej aplikacji musi być ustawiona na wartość Biblioteka klas, aby właściwość Międzyoperajnia rejestracji dla modelu COM mogła być dostępna. Przykładowa klasa, którą można uwzględnić w aplikacji Visual C# i uwidocznić jako obiekt COM, zobacz Przykładowa klasa COM.

Generowanie zestawu serializacji

Określa, czy kompilator będzie używać narzędzia generatora serializatora XML (Sgen.exe) do tworzenia zestawów serializacji XML. Zestawy serializacji mogą zwiększyć wydajność XmlSerializer uruchamiania, jeśli użyto tej klasy do serializacji typów w kodzie. Domyślnie ta opcja jest ustawiona na Wartość Automatyczna, która określa, że zestawy serializacji są generowane tylko wtedy, gdy zostały użyte XmlSerializer do kodowania typów w kodzie do formatu XML. Ustawienie Wyłączone określa, że zestawy serializacji nigdy nie są generowane, niezależnie od tego, czy kod używa elementu XmlSerializer. On określa, że zestawy serializacji zawsze są generowane. Zestawy serializacji mają nazwę TypeName. XmlSerializers.dll. Aby uzyskać więcej informacji, zobacz XML Serializer Generator Tool (Sgen.exe).

Zaawansowany

Kliknij, aby wyświetlić okno dialogowe Zaawansowane Ustawienia kompilacji (C#).