Oktatóanyag: .NET-osztálytár létrehozása a Visual Studio Code használatával

Ebben az oktatóanyagban egy egyszerű segédprogramtárat hoz létre, amely egyetlen sztringkezelési módszert tartalmaz.

A osztálykódtár definiálja az alkalmazás által meghívott típusokat és metódusokat. Ha a kódtár a .NET Standard 2.0-t célozza meg, azt bármely .NET-implementáció meghívhatja (beleértve a .NET-keretrendszert is), amely támogatja a .NET Standard 2.0-t. Ha a kódtár a .NET 9-et célozza meg, azt bármely olyan alkalmazás meghívhatja, amely a .NET 9-et célozza. Ez az oktatóanyag bemutatja, hogyan célozhatja meg a .NET 9-et.

Osztálytár létrehozásakor terjesztheti külső összetevőként vagy egy vagy több alkalmazással együtt csomagolt összetevőként.

Előfeltételek

A legújabb .NET SDK
Visual Studio Code szerkesztő
A C# DevKit

Telepítési utasítások

Windows rendszeren ez a WinGet konfigurációs fájl az összes előfeltétel telepítéséhez. Ha már telepített valamit, a WinGet kihagyja ezt a lépést.

Töltse le a fájlt, és kattintson rá duplán a futtatáshoz.
Olvassa el a licencszerződést, írja be y, és válassza Adja meg, amikor a rendszer kéri az elfogadást.
Ha a tálcán megjelenik egy villogó Felhasználói fiókok felügyelete (UAC) kérés, engedélyezze a telepítés folytatását.

Más platformokon külön kell telepítenie ezeket az összetevőket.

Töltse le az ajánlott telepítőt a .NET SDK letöltési oldaláról, majd kattintson rá duplán a futtatásához. A letöltési oldal észleli a platformot, és a legújabb telepítőt javasolja a platformhoz.
Töltse le a legújabb telepítőt a Visual Studio Code kezdőlapjáról, és kattintson rá duplán a futtatásához. Ez az oldal a platformot is észleli, és a hivatkozásnak helyesnek kell lennie a rendszer számára.
Kattintson a "Telepítés" gombra a C# DevKit bővítménylapon. Ez megnyitja a Visual Studio-kódot, és megkérdezi, hogy szeretné-e telepíteni vagy engedélyezni a bővítményt. Válassza a "telepítés" lehetőséget.

Osztálytárprojekt létrehozása

Először hozzon létre egy "StringLibrary" nevű .NET-osztálytárprojektet és egy társított megoldást. A megoldás egy vagy több projekt tárolójaként szolgál. Ugyanahhoz a megoldáshoz további, kapcsolódó projekteket fog hozzáadni.

Indítsa el a Visual Studio Code-ot.
Lépjen az Explorer nézetre, és válassza .NET-projekt létrehozásalehetőséget. Másik lehetőségként a Ctrl+Shift+P (MacOS-en Command+Shift+P) billentyűkombinációval is létrehozhatja a parancskatalógust, majd beírhatja a ".NET" szót, és megkeresheti és kiválaszthatja a .NET: New Project parancsot.
A parancs kiválasztása után ki kell választania a projektsablont. Válassza az Osztálytár lehetőséget.
Ezután válassza ki azt a helyet, ahol létre szeretné hozni az új projektet.
Ezután válassza ki azt a helyet, ahol létre szeretné hozni az új projektet: Hozzon létre egy ClassLibraryProjects nevű mappát, és jelölje ki.
Nevezze el a projektet StringLibrary, válassza a Az összes sablonbeállítás megjelenítéselehetőséget, válassza a .NET 9 , majd a Projekt létrehozásalehetőséget.
Nevezze el a projektet StringLibrary, majd válassza a Projekt létrehozásalehetőséget.
Nyomja le az Enter billentyűt a megjelenő üzenetnél A projekt létre lesz hozva a <útvonalon>.
Ellenőrizze, hogy a kódtár a .NET 9-et célozza-e meg. Nyissa meg a Explorerprogramban a StringLibrary/StringLibrary.csprojfájlt.

A TargetFramework elem azt mutatja, hogy a projekt a .NET 9.0-t célozza.
```
<Project Sdk="Microsoft.NET.Sdk">

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

</Project>
```
Nyissa meg Class1.cs, és cserélje le a kódot a következő kódra.
```
namespace UtilityLibraries;

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

        return char.IsUpper(str[0]);
    }
}
```
A UtilityLibraries.StringLibraryosztálykódtár egy StartsWithUppernevű metódust tartalmaz. Ez a metódus egy Boolean értéket ad vissza, amely jelzi, hogy az aktuális sztringpéldány nagybetűvel kezdődik-e. A Unicode szabvány megkülönbözteti a nagybetűket a kisbetűktől. A Char.IsUpper(Char) metódus true ad vissza, ha egy karakter nagybetűs.

StartsWithUpper meg van valósítva bővítménymetódusként, ezért úgy hívhatja, mintha a String osztály tagja lenne.
Mentse a fájlt.
Terjessze ki a Megoldásböngésző-t a Explorer nézet alján.

Kattintson a jobb gombbal a megoldásra Megoldáskezelőben, és válassza a Buildlehetőséget, vagy nyissa meg a parancskatalógust, és válassza a .NET: Build lehetőséget a megoldás létrehozásához, és ellenőrizze, hogy a projekt hiba nélkül áll-e le.

A terminálkimenet a következő példához hasonlóan néz ki:

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

Konzolalkalmazás hozzáadása a megoldáshoz

Adjon hozzá egy olyan konzolalkalmazást, amely az osztálytárat használja. Az alkalmazás megkéri a felhasználót, hogy írjon be egy sztringet, és jelentse, hogy a sztring nagybetűvel kezdődik-e.

Kattintson a jobb gombbal a megoldásra Megoldáskezelő, és válassza Új projektlehetőséget, vagy a parancskatalógusban válassza a .NET: Új projektlehetőséget.
Válassza a Konzolalkalmazás lehetőséget.
Adja meg a nevet ShowCase, válassza ki az alapértelmezett helyet, és válassza a Projekt létrehozásalehetőséget.

Nyissa meg ShowCase/Program.cs, és cserélje le az összes kódot a következő kódra.

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

A kód a row változót használja a konzolablakba írt adatsorok számának fenntartásához. Ha 25-nél nagyobb vagy egyenlő, a kód törli a konzolablakot, és üzenetet jelenít meg a felhasználónak.

A program kéri a felhasználót, hogy adjon meg egy karakterláncot. Azt jelzi, hogy a karakterlánc nagybetűvel kezdődik-e. Ha a felhasználó sztring beírása nélkül lenyomja az Enter billentyűt, az alkalmazás véget ér, és bezárul a konzolablak.

Mentse a módosításokat.

Projekthivatkozás hozzáadása

Az új konzolalkalmazás-projekt kezdetben nem rendelkezik hozzáféréssel az osztálytárhoz. Ha engedélyezni szeretné, hogy metódusokat hívjon meg az osztálytárban, hozzon létre egy projekthivatkozást az osztálytár projektre.

A Megoldáskezelőben kattintson a jobb gombbal a ShowCase projektre, és válassza a Projekthivatkozás hozzáadásalehetőséget.
Válassza a StringLibrary lehetőséget.

Az alkalmazás futtatása

Válassza Futtatás>Futtatás hibakeresés nélkül.
Válassza C#lehetőséget.
Válassza a „ShowCase” lehetőséget.

Ha olyan hibaüzenet jelenik meg, amely szerint nincs betöltve C#-program, zárja be a megnyitott mappát, és nyissa meg a ShowCase mappát. Ezután próbálkozzon újra az alkalmazás futtatásával.

Próbálja ki a programot karakterláncok beírásával és a Enterbillentyű lenyomásával, majd a kilépéshez nyomja le a Enter billentyűt.

A terminálkimenet a következő példához hasonlóan néz ki:

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

További erőforrások

Következő lépések

Ebben az oktatóanyagban létrehozott egy kódtárprojektet, és hozzáadott egy konzolalkalmazás-projektet, amely a tárat használja. A következő oktatóanyagban egy egységteszt-projektet ad hozzá a megoldáshoz.

.NET osztálykönyvtár tesztelése a .NET segítségével a Visual Studio Code-ban

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-03-28