Samouczek: tworzenie biblioteki klas platformy .NET przy użyciu programu Visual Studio Code

Artykuł
12/20/2024

W tym samouczku utworzysz prostą bibliotekę narzędzi zawierającą jedną metodę obsługi ciągów.

Biblioteka klas definiuje typy i metody wywoływane przez aplikację. Jeśli biblioteka jest przeznaczona dla platformy .NET Standard 2.0, może być wywoływana przez dowolną implementację platformy .NET (w tym .NET Framework), która obsługuje platformę .NET Standard 2.0. Jeśli biblioteka jest przeznaczona dla platformy .NET 9, może być wywoływana przez dowolną aplikację docelową platformy .NET 9. Ten samouczek pokazuje, jak ukierunkować na .NET 9.

Podczas tworzenia biblioteki klas można ją dystrybuować jako składnik innej firmy lub jako składnik powiązany z co najmniej jedną aplikacją.

Warunki wstępne

programu Visual Studio Code z zainstalowanym rozszerzeniem zestawu deweloperskiego języka C# .

Aby uzyskać informacje o tym, jak instalować rozszerzenia w programie Visual Studio Code, zobacz Marketplace rozszerzeń VS Code.
Zestaw SDK platformy .NET 9 .

Tworzenie projektu biblioteki klas

Zacznij od utworzenia projektu biblioteki klas platformy .NET o nazwie "StringLibrary" i skojarzonego rozwiązania. Rozwiązanie służy jako kontener dla co najmniej jednego projektu. Dodasz dodatkowe, powiązane projekty do tego samego rozwiązania.

Uruchom program Visual Studio Code.
Przejdź do widoku Eksploratora i wybierz pozycję Utwórz projekt platformy .NET. Alternatywnie możesz wyświetlić paletę poleceń przy użyciu Ctrl+Shift+P (Command+Shift+P w systemie MacOS), a następnie wpisać ".NET" i znaleźć i wybrać polecenie .NET: New Project.
Po wybraniu polecenia należy wybrać szablon projektu. Wybierz Bibliotekę klas.
Następnie wybierz lokalizację, w której chcesz utworzyć nowy projekt.
Następnie wybierz lokalizację, w której chcesz utworzyć nowy projekt: utwórz folder o nazwie ClassLibraryProjects i wybierz go.
Nadaj projektowi nazwę StringLibrary, wybierz pozycję Pokaż wszystkie opcje szablonu, wybierz pozycję .NET 9 i wybierz pozycję Utwórz projekt.
Nadaj projektowi nazwę StringLibrary i wybierz pozycję Utwórz projekt.
Naciśnij Enter po wyświetleniu monitu Project zostanie utworzony w ścieżce <>.
Upewnij się, że biblioteka jest przeznaczona dla platformy .NET 9. W programie Explorerotwórz StringLibrary/StringLibrary.csproj.

Element TargetFramework pokazuje, że projekt jest przeznaczony dla platformy .NET 9.0.
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>
```
Otwórz Class1.cs i zastąp kod następującym kodem.
```
using System;

namespace UtilityLibraries
{
    public static class StringLibrary
    {
        public static bool StartsWithUpper(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
                return false;

            char ch = str[0];
            return char.IsUpper(ch);
        }
    }
}
```
Biblioteka klas UtilityLibraries.StringLibraryzawiera metodę o nazwie StartsWithUpper. Ta metoda zwraca wartość Boolean wskazującą, czy bieżące wystąpienie ciągu zaczyna się od wielkiej litery. Standard Unicode rozróżnia wielkie litery od małych liter. Metoda Char.IsUpper(Char) zwraca true, jeśli znak jest wielkimi literami.

StartsWithUpper jest implementowana jako metoda rozszerzenia , aby można było wywołać ją tak, jakby była elementem członkowskim klasy String.
Zapisz plik.
Rozwiń Eksplorator rozwiązań w dolnej części widoku Eksploratora .

Kliknij prawym przyciskiem myszy rozwiązanie w Eksploratorze rozwiązań i wybierz opcję Kompilujlub otwórz paletę poleceń i wybierz .NET: Skompiluj, aby zbudować rozwiązanie i sprawdzić, czy projekt kompiluje się bez błędów.

Dane wyjściowe terminalu wyglądają jak w poniższym przykładzie:

Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
Build succeeded.
    0 Warning(s)
    0 Error(s)
Time Elapsed 00:00:02.78

Dodawanie aplikacji konsolowej do rozwiązania

Dodaj aplikację konsolową korzystającą z biblioteki klas. Aplikacja wyświetli użytkownikowi monit o wprowadzenie ciągu i zgłoszenie, czy ciąg zaczyna się od wielkiej litery.

Kliknij rozwiązanie prawym przyciskiem myszy w eksploratorze rozwiązań i wybierz pozycję Nowy projektlub w palecie poleceń wybierz pozycję .NET: Nowy projekt.
Wybierz pozycję Aplikacja konsolowa.
Nadaj mu nazwę ShowCase, wybierz lokalizację domyślną i wybierz pozycję Utwórz projekt.

Otwórz ShowCase/Program.cs i zastąp cały kod następującym kodem.

using System;
using UtilityLibraries;

class Program
{
    static void Main(string[] args)
    {
        int row = 0;

        do
        {
            if (row == 0 || row >= 25)
                ResetConsole();

            string? input = Console.ReadLine();
            if (string.IsNullOrEmpty(input)) break;
            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
            row += 3;
        } while (true);
        return;

        // Declare a ResetConsole local method
        void ResetConsole()
        {
            if (row > 0)
            {
                Console.WriteLine("Press any key to continue...");
                Console.ReadKey();
            }
            Console.Clear();
            Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
            row = 3;
        }
    }
}

Kod używa zmiennej row, aby zachować liczbę wierszy danych zapisanych w oknie konsoli. Za każdym razem, gdy jest on większy lub równy 25, kod czyści okno konsoli i wyświetla użytkownikowi komunikat.

Program prosi użytkownika o wprowadzenie ciągu znaków. Wskazuje, czy ciąg zaczyna się od wielkiej litery. Jeśli użytkownik naciśnie Enter bez wprowadzania ciągu, aplikacja kończy się, a okno konsoli zostanie zamknięte.

Zapisz zmiany.

Dodawanie odwołania do projektu

Początkowo nowy projekt aplikacji konsolowej nie ma dostępu do biblioteki klas. Aby umożliwić wywoływanie metod w bibliotece klas, utwórz odwołanie projektu do projektu biblioteki klas.

W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt ShowCase i wybierz Dodaj odwołanie do projektu.
Wybierz StringLibrary.

Uruchamianie aplikacji

Wybierz pozycję Uruchom>Uruchom bez debugowania.
Wybierz , C#,.
Wybierz pozycję ShowCase.

Jeśli zostanie wyświetlony komunikat o błędzie informujący o braku załadowanego programu w języku C#, zamknij otwarty folder i otwórz folder ShowCase. Następnie spróbuj ponownie uruchomić aplikację.

Wypróbuj program, wprowadzając ciągi i naciskając Enter, a następnie naciśnij Enter, aby zakończyć.

Dane wyjściowe terminalu wyglądają jak w poniższym przykładzie:

Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

Dodatkowe zasoby

Następne kroki

W tym samouczku utworzyłeś projekt biblioteki i dodałeś projekt aplikacji konsolowej, który używa tej biblioteki. W następnym samouczku dodasz projekt testu jednostkowego do rozwiązania.

Testowanie biblioteki klas .NET za pomocą programu Visual Studio Code

Udostępnij za pośrednictwem

Samouczek: tworzenie biblioteki klas platformy .NET przy użyciu programu Visual Studio Code

Warunki wstępne

Tworzenie projektu biblioteki klas

Dodawanie aplikacji konsolowej do rozwiązania

Dodawanie odwołania do projektu

Uruchamianie aplikacji

Dodatkowe zasoby

Następne kroki

Dodatkowe zasoby