Kurz: Vytvoření knihovny tříd .NET pomocí editoru Visual Studio Code

V tomto kurzu vytvoříte jednoduchou knihovnu nástrojů, která obsahuje jednu metodu zpracování řetězců.

Knihovna tříd definuje typy a metody volané aplikací. Pokud knihovna cílí na .NET Standard 2.0, může ji volat libovolná implementace .NET (včetně rozhraní .NET Framework), která podporuje .NET Standard 2.0. Pokud knihovna cílí na .NET 9, může ji volat libovolná aplikace, která cílí na .NET 9. V tomto kurzu se dozvíte, jak cílit na .NET 9.

Když vytvoříte knihovnu tříd, můžete ji distribuovat jako komponentu třetí strany nebo jako součást se sadou s jednou nebo více aplikacemi.

Požadavky

Nejnovější sada .NET SDK
editor Visual Studio Code editoru
C# DevKit

Pokyny k instalaci

Ve Windows použijte tento konfigurační soubor WinGet k instalaci všech předpokladů. Pokud už máte něco nainstalovaného, WinGet tento krok přeskočí.

Stáhněte soubor a poklikáním ho spusťte.
Přečtěte si licenční smlouvu, zadejte ya po zobrazení výzvy k přijetí vyberte Enter.
Pokud se na hlavním panelu zobrazí výzva řízení uživatelských účtů (UAC), povolte instalaci pokračovat.

Na jiných platformách je potřeba nainstalovat každou z těchto komponent samostatně.

Stáhněte si doporučený instalační program ze stránky pro stažení .NET SDK a poklikáním ho spusťte. Stránka pro stažení zjistí vaši platformu a doporučí nejnovější instalační program pro vaši platformu.
Stáhněte si nejnovější instalační program z domovské stránky editoru Visual Studio Code a dvojitým kliknutím ho spusťte. Tato stránka také zjistí vaši platformu a odkaz by měl být pro váš systém správný.
Na stránce rozšíření C# DevKit klikněte na tlačítko Nainstalovat. Tím se otevře Visual Studio Code a zobrazí se dotaz, jestli chcete rozšíření nainstalovat nebo povolit. Vyberte "nainstalovat".

Vytvořte projekt knihovny tříd

Začněte vytvořením projektu knihovny tříd .NET s názvem StringLibrary a přidruženým řešením. Řešení slouží jako kontejner pro jeden nebo více projektů. Do stejného řešení přidáte další související projekty.

Spusťte Visual Studio Code.
Přejděte do zobrazení Průzkumníka a vyberte Vytvořit projekt .NET. Alternativně můžete zobrazit paletu příkazů pomocí Ctrl+Shift+P (Command+Shift+P v macOS) a pak zadat .NET a najít a vybrat příkaz .NET: Nový projekt.
Po výběru příkazu budete muset zvolit šablonu projektu. Zvolte knihovnu tříd.
Pak vyberte umístění, kam chcete nový projekt vytvořit.
Pak vyberte umístění, kam chcete vytvořit nový projekt: Vytvořte složku s názvem ClassLibraryProjects a vyberte ji.
Pojmenujte projekt stringLibrary, vyberte Zobrazit všechny možnosti šablon, vyberte .NET 9 a vyberte Vytvořit projekt.
Pojmenujte projekt StringLibrary a vyberte Vytvořit projekt.
Stisknutím klávesy Enter na výzvě Projekt bude vytvořen v <cestě>.
Zkontrolujte, jestli knihovna cílí na .NET 9. V Explorerotevřete StringLibrary/StringLibrary.csproj.

Element TargetFramework ukazuje, že projekt cílí na .NET 9.0.
```
<Project Sdk="Microsoft.NET.Sdk">

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

</Project>
```
Otevřete Class1.cs a nahraďte kód následujícím kódem.
```
namespace UtilityLibraries;

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

        return char.IsUpper(str[0]);
    }
}
```
Knihovna tříd, UtilityLibraries.StringLibrary, obsahuje metodu nazvanou StartsWithUpper. Tato metoda vrátí hodnotu Boolean, která označuje, zda aktuální instance řetězce začíná velkými písmeny. Standard Unicode rozlišuje velká písmena od malých písmen. Metoda Char.IsUpper(Char) vrátí true, pokud je znak velkými písmeny.

StartsWithUpper se implementuje jako metoda rozšíření , abyste ji mohli volat, jako by byla členem třídy String.
Uložte soubor.
Rozbalte Průzkumníka řešení v dolní části zobrazení Exploreru.

Klikněte pravým tlačítkem na řešení v Průzkumníku řešení a vyberte Sestavit, nebo otevřete Paletu příkazů a vyberte .NET: Sestavit, abyste sestavili řešení a ověřili, že projekt se zkompiluje bez chyby.

Výstup terminálu vypadá jako v následujícím příkladu:

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

Přidání konzolové aplikace do řešení

Přidejte konzolovou aplikaci, která používá knihovnu tříd. Aplikace vyzve uživatele, aby zadal řetězec a nahlásil, jestli řetězec začíná velkými písmeny.

Klikněte pravým tlačítkem na řešení v Průzkumníku řešení a vyberte Nový projektnebo v paletě příkazů vyberte .NET: Nový projekt.
Vyberte konzolovou aplikaci.
Pojmenujte ho ShowCase, vyberte výchozí umístění a vyberte Vytvořit projekt.

Otevřete ShowCase/Program.cs a nahraďte veškerý kód následujícím kódem.

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;
        }
    }
}

Kód používá proměnnou row k udržování počtu řádků dat zapsaných do okna konzoly. Kdykoli je větší nebo rovna 25, kód vymaže okno konzoly a zobrazí uživateli zprávu.

Program vyzve uživatele k zadání textu. Určuje, zda řetězec začíná velkým písmenem. Pokud uživatel stiskne klávesu Enter bez zadání řetězce, aplikace skončí a okno konzoly se zavře.

Uložte změny.

Přidání odkazu na projekt

Nový projekt konzolové aplikace zpočátku nemá přístup k knihovně tříd. Pokud chcete povolit volání metod v knihovně tříd, vytvořte odkaz na projekt knihovny tříd.

V Průzkumníku řešení klikněte pravým tlačítkem na projekt ShowCase a vyberte Přidat referenci projektu.
Vyberte StringLibrary.

Spuštění aplikace

Vyberte Spustit>Spustit bez ladění.
Vyberte C#.
Vyberte ShowCase.

Pokud se zobrazí chyba s informací, že není načten žádný program jazyka C#, zavřete složku, kterou jste otevřeli, a otevřete složku ShowCase. Pak zkuste aplikaci spustit znovu.

Vyzkoušejte program zadáním řetězců a stisknutím klávesy Entera stisknutím klávesy Enter ukončete.

Výstup terminálu vypadá jako v následujícím příkladu:

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

Další zdroje informací

Další kroky

V tomto kurzu jste vytvořili projekt knihovny a přidali jste projekt konzolové aplikace, který tuto knihovnu používá. V dalším kurzu přidáte do řešení projekt testování jednotek.

Testování knihovny tříd .NET v prostředí .NET pomocí editoru Visual Studio Code

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-03-25