Wprowadzenie do projektów i rozwiązań
W tym samouczku dowiesz się, co to znaczy utworzyć rozwiązanie i projekt w programie Visual Studio. Rozwiązanie to kontener do organizowania co najmniej jednego powiązanego projektu kodu, takiego jak projekt biblioteki klas i odpowiedni projekt testowy. W rozwiązaniu utworzysz odwołanie z jednego projektu do innego. W tym samouczku opisano również właściwości projektu i niektóre pliki, które może zawierać.
W ramach ćwiczenia, aby zrozumieć koncepcję projektu, tworzysz rozwiązanie i projekt od podstaw. Zazwyczaj do tworzenia nowych projektów należy używać szablonów projektów programu Visual Studio.
Z tego samouczka dowiesz się, jak wykonywać następujące działania:
- Dodawanie elementu do projektu
- Dodawanie drugiego projektu
- Dodawanie odwołania do projektu
- Dodawanie kodu testowego
- Wyświetlanie właściwości projektu
Warunki wstępne
- Jeśli nie masz programu Visual Studio 2019, przejdź na stronę pobierania programu Visual Studio, aby go bezpłatnie zainstalować.
- Jeśli nie masz programu Visual Studio, przejdź do pobrania programu Visual Studio, aby zainstalować go za darmo.
Rozwiązania i projekty
W Visual Studio rozwiązanie nie jest odpowiedzią . Rozwiązanie to po prostu kontener używany przez program Visual Studio do organizowania co najmniej jednego powiązanego projektu. Po otwarciu rozwiązania program Visual Studio automatycznie ładuje wszystkie projekty, które zawiera rozwiązanie.
Notatka
Tworzenie aplikacji w programie Visual Studio nie wymaga rozwiązań i projektów. Możesz po prostu otworzyć folder zawierający kod i rozpocząć kodowanie, kompilowanie i debugowanie. Na przykład sklonowany repozytorium GitHub może nie zawierać projektów i rozwiązań programu Visual Studio. Aby uzyskać więcej informacji, zobacz Programowanie kodu w programie Visual Studio bez projektów lub rozwiązań.
Tworzenie rozwiązania
Rozpocznij eksplorację, tworząc puste rozwiązanie. Po zapoznaniu się z programem Visual Studio prawdopodobnie nie będziesz często tworzyć pustych rozwiązań. Podczas tworzenia nowego projektu program Visual Studio automatycznie tworzy rozwiązanie dla projektu, chyba że rozwiązanie jest już otwarte.
Otwórz program Visual Studio.
W oknie uruchamiania wybierz pozycję Utwórz nowy projekt.
Na stronie Utwórz nowy projekt wprowadź puste rozwiązanie w polu wyszukiwania, wybierz szablon Puste rozwiązanie, a następnie wybierz Dalej.
Napiwek
Jeśli masz zainstalowane kilka obciążeń roboczych, szablon Puste rozwiązanie może nie pojawić się na początku listy wyników wyszukiwania. Spróbuj przewinąć do Inne wyniki na podstawie sekcji wyszukiwania listy. Powinno się tam pojawić.
Nadaj rozwiązaniu nazwę QuickSolution, a następnie wybierz pozycję Utwórz.
Rozwiązanie jest wyświetlane w eksploratorze rozwiązań po prawej stronie okna programu Visual Studio. Prawdopodobnie często będziesz używać eksploratora rozwiązań , aby przeglądać zawartość projektów.
Otwórz program Visual Studio, a następnie w oknie uruchamiania wybierz pozycję Utwórz nowy projekt.
Na stronie Utwórz nowy projekt wpisz puste rozwiązanie w polu wyszukiwania, wybierz szablon Puste rozwiązanie, a następnie wybierz Dalej.
Napiwek
Jeśli masz zainstalowane kilka obciążeń roboczych, szablon Puste rozwiązanie może nie pojawić się na początku listy wyników wyszukiwania. Spróbuj przewinąć przez inne wyniki wyszukiwania, aby znaleźć szablon.
Na stronie Konfigurowanie nowego projektu nadaj rozwiązaniu nazwę QuickSolution, a następnie wybierz pozycję Utwórz.
Rozwiązanie QuickSolution jest wyświetlane w eksploratorze rozwiązań po prawej stronie okna programu Visual Studio. Używasz Eksploratora rozwiązań często do przeglądania zawartości projektów.
Dodawanie projektu
Teraz dodaj swój pierwszy projekt do rozwiązania. Zacznij od pustego projektu i dodaj potrzebne elementy.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy Rozwiązanie "QuickSolution". W menu kontekstowym wybierz pozycję Dodaj>Nowy projekt.
Zostanie otwarte okno dialogowe z komunikatem Dodawanie nowego projektu.
Wprowadź tekst pusty w polu wyszukiwania u góry, a następnie wybierz pozycję C# w obszarze Language.
Wybierz szablon Empty Project (.NET Framework), a następnie wybierz Next.
Nadaj projektowi nazwę QuickDate, a następnie wybierz Utwórz.
Poniżej rozwiązania zostanie wyświetlony projekt o nazwie QuickDate w eksploratorze rozwiązań . Obecnie zawiera on jeden plik o nazwie App.config.
Notatka
Jeśli nie widzisz szablonu Empty Project (.NET Framework), musisz zainstalować obciążenie oprogramowanie dla pulpitu .NET w programie Visual Studio. Program Visual Studio używa instalacji opartej na obciążeniach do instalowania tylko składników potrzebnych dla typu programowania.
Łatwym sposobem na zainstalowanie nowych narzędzi i funkcji podczas tworzenia nowego projektu jest wybranie linku Zainstaluj więcej narzędzi i funkcji poniżej tekstu Nie możesz znaleźć tego, czego szukasz?. Po uruchomieniu Instalatora programu Visual Studio wybierz obciążenie programowanie aplikacji dla pulpitu .NET, a następnie przycisk Modyfikuj.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy Rozwiązanie "QuickSolution". W menu kontekstowym wybierz pozycję Dodaj>Nowy projekt.
Na stronie Dodaj nowy projekt wpisz empty w polu wyszukiwania u góry, a następnie wybierz C# w sekcji Wszystkie języki.
Wybierz szablon Pusty Projekt C# (.NET Framework), a następnie wybierz Dalej.
Notatka
Program Visual Studio używa instalacji opartej na obciążeniach do instalowania tylko składników potrzebnych dla typu programowania. Jeśli nie widzisz szablonu Empty Project (.NET Framework), zainstaluj pakiet roboczy .NET Desktop development Visual Studio.
Łatwym sposobem na zainstalowanie nowego obciążenia przy tworzeniu nowego projektu jest wybranie linku Zainstaluj więcej narzędzi i funkcji pod tekstem Nie można znaleźć tego, czego szukasz?. W Instalatorze programu Visual Studio wybierz obciążenie programowanie aplikacji klasycznych platformy .NET, a następnie wybierz pozycję Modyfikuj.
Na stronie Konfigurowanie nowego projektu nadaj projektowi nazwę QuickDate, a następnie wybierz pozycję Utwórz.
Projekt QuickDate jest wyświetlany w obszarze rozwiązania w eksploratorze rozwiązań . Projekt zawiera węzeł References i pojedynczy plik o nazwie App.config.
Dodawanie elementu do projektu
Dodaj plik kodu do pustego projektu.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt QuickDate. Z menu kontekstowego wybierz pozycję Dodaj>nowy element.
Zostanie otwarte okno dialogowe Dodawanie nowego elementu. Wybierz pozycję Pokaż wszystkie szablony, jeśli zostanie otwarte okno dialogowe w widoku kompaktowym.
Rozwiń węzeł Elementy języka Visual C#, a następnie wybierz Kod. W środkowym okienku wybierz szablon elementu Klasa. W obszarze Nazwawpisz Kalendarz, a następnie wybierz pozycję Dodaj.
Program Visual Studio dodaje plik o nazwie Calendar.cs do projektu.
.cs
na końcu jest rozszerzeniem pliku dla plików kodu języka C#. Plik Calendar.cs zostanie wyświetlony w eksploratorze rozwiązań hierarchii projektu wizualnego, a plik zostanie otwarty w edytorze.Zastąp zawartość pliku Calendar.cs następującym kodem:
using System; namespace QuickDate { internal class Calendar { static void Main(string[] args) { DateTime now = GetCurrentDate(); Console.WriteLine($"Today's date is {now}"); Console.ReadLine(); } internal static DateTime GetCurrentDate() { return DateTime.Now.Date; } } }
Nie musisz jeszcze rozumieć wszystkiego, co robi kod. Uruchom aplikację, naciskając Ctrl+F5. Aplikacja wyświetla dzisiejszą datę w konsoli lub w oknie standardowego wyjścia. Następnie zamknij okno konsoli.
Dodawanie drugiego projektu
Rozwiązania często zawierają więcej niż jeden projekt, a te projekty często odwołują się do siebie. Niektóre projekty w rozwiązaniu mogą być bibliotekami klas, niektóre mogą być aplikacjami wykonywalnym, a niektóre mogą być projektami testów jednostkowych lub witrynami internetowymi.
Aby dodać projekt testu jednostkowego do rozwiązania, zacznij od szablonu projektu, aby nie trzeba było dodawać do projektu innego pliku kodu.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy Rozwiązanie "QuickSolution". Z menu kontekstowego wybierz pozycję Dodaj>Nowy projekt.
W oknie dialogowym Dodawanie nowego projektu wprowadź tekst test jednostkowy w polu wyszukiwania u góry, a następnie wybierz opcję C# w obszarze Język.
Wybierz szablon projektu testów jednostkowych dla platformy .NET Core, a następnie wybierz Dalej.
Notatka
Począwszy od programu Visual Studio 2019 w wersji 16.9, nazwa szablonu projektu MSTest została zmieniona z msTest Unit Test Project (.NET Core) na Unit Test Project. W tej aktualizacji zmieniono kilka kroków tworzenia projektu.
Nadaj projektowi nazwę QuickTest, a następnie wybierz pozycję Next.
Wybierz zalecaną strukturę docelową (.NET Core 3.1) lub .NET 5, a następnie wybierz pozycję Utwórz.
Drugi projekt zostanie dodany do eksploratora rozwiązań , a w edytorze zostanie otwarty plik o nazwie UnitTest1.cs.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy Rozwiązanie "QuickSolution". Z menu kontekstowego wybierz pozycję Dodaj>Nowy projekt.
W oknie dialogowym Dodawanie nowego projektu wpisz test jednostkowy w polu wyszukiwania u góry, a następnie wybierz pozycję C# w obszarze Wszystkie języki.
Wybierz szablon projektu projektu testów jednostkowych w języku C# (.NET Framework), a następnie wybierz pozycję Dalej.
Na stronie Konfigurowanie nowego projektu nadaj projektowi nazwę QuickTest, a następnie kliknij Utwórz.
Program Visual Studio dodaje projekt QuickTest do Eksplorator Rozwiązań, a plik UnitTest1.cs otwiera się w edytorze.
Dodawanie odwołania do projektu
Aby użyć nowego projektu testów jednostkowych do przetestowania metody w projekcie QuickDate, należy dodać odwołanie do QuickDate do projektu QuickTest. Dodanie odwołania powoduje utworzenie zależności kompilacji między dwoma projektami. Podczas budowania rozwiązania QuickDate jest budowany przed QuickTest.
Kliknij prawym przyciskiem myszy węzeł zależności w projekcie QuickTest. Z menu kontekstowego wybierz pozycję Dodaj odwołanie do projektu.
Zostanie otwarte okno dialogowe menedżera odwołań.
W lewym panelu rozwiń Projects, a następnie wybierz Solution. W środkowym okienku zaznacz pole wyboru obok pozycji QuickDate, a następnie wybierz pozycję OK.
Dodano odwołanie do projektu QuickDate.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł Odwołania projektu QuickTest. Z menu kontekstowego wybierz pozycję Dodaj odwołanie.
W oknie dialogowym Menedżera odwołań wybierz pozycję Projects. W środkowym okienku zaznacz pole wyboru obok pozycji QuickDate, a następnie wybierz pozycję OK.
Odwołanie do projektu QuickDate pojawia się pod projektem QuickTest w eksploratorze rozwiązań.
Dodawanie kodu testowego
Teraz dodaj kod testowy do pliku kodu testowego języka C#. Zastąp zawartość UnitTest1.cs następującym kodem:
using System; using Microsoft.VisualStudio.TestTools.UnitTesting; namespace QuickTest { [TestClass] public class UnitTest1 { [TestMethod] public void TestGetCurrentDate() { Assert.AreEqual(DateTime.Now.Date, QuickDate.Calendar.GetCurrentDate()); } } }
Czerwona falowana linia pojawia się pod niektórym kodem. Ten błąd można naprawić, tworząc projekt testowy zestawu QuickDate.
W pliku Calendar.cs dodaj następujące przy użyciu instrukcji i atrybutu InternalsVisibleToAttribute na początku pliku, aby usunąć błąd w projekcie testowym.
using System.Runtime.CompilerServices; [assembly: InternalsVisibleTo("QuickTest")]
Kod Calendar.cs powinien wyglądać następująco:
Uruchamianie testu jednostkowego
Aby sprawdzić, czy test jednostkowy działa, na pasku menu wybierz pozycję Test>Uruchom wszystkie testy. Zostanie otwarte okno Eksploratora testów i powinieneś zobaczyć, że test TestGetCurrentDate przeszedł pozytywnie.
Napiwek
Możesz również otworzyć Eksplorator Testów, wybierając pozycję Test>Eksplorator Testów na pasku menu.
Właściwości projektu
Wiersz w pliku Calendar.cs zawierający atrybut InternalsVisibleToAttribute odwołuje się do nazwy zestawu lub pliku projektu QuickTest. Nazwa zestawu może nie zawsze być taka sama jak nazwa projektu. Aby znaleźć nazwę zestawu projektu, użyj właściwości projektu. Strony właściwości zawierają różne ustawienia projektu.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt QuickTest i wybierz Właściwościlub wybierz projekt i naciśnij Alt+Enter.
Strony właściwości dla projektu otwarte na karcie Application. Nazwa zestawu projektu QuickTest jest rzeczywiście QuickTest.
Jeśli chcesz, możesz zmienić nazwę tutaj. Podczas kompilowania projektu testowego nazwa wynikowego pliku binarnego zmienia się z QuickTest.dll na <NewName>.dll.
Zapoznaj się z innymi kartami właściwości projektu, takimi jak Build oraz Debug. Te karty są różne dla różnych typów projektów.