Condividi tramite

Esercitazione: Creare una libreria di classi .NET con Visual Studio Code

  • Articolo

In questa esercitazione viene creata una semplice libreria di utilità che contiene un singolo metodo di gestione delle stringhe.

Una libreria di classi definisce tipi e metodi chiamati da un'applicazione. Se la libreria è destinata a .NET Standard 2.0, può essere chiamata da qualsiasi implementazione di .NET (incluso .NET Framework) che supporti .NET Standard 2.0. Se la libreria è destinata a .NET 9, può essere chiamata da qualsiasi applicazione destinata a .NET 9. Questa esercitazione illustra come prendere di mira .NET 9.

Quando si crea una libreria di classi, è possibile distribuirla come componente di terze parti o come componente in bundle con una o più applicazioni.

Prerequisiti

Creare un progetto di libreria di classi

Per iniziare, creare un progetto di libreria di classi .NET denominato "StringLibrary" e una soluzione associata. Una soluzione funge da contenitore per uno o più progetti. Si aggiungeranno altri progetti correlati alla stessa soluzione.

  1. Avvia Visual Studio Code.

  2. Passare alla visualizzazione Esplora risorse e selezionare Crea progetto .NET. In alternativa, è possibile visualizzare il riquadro comandi usando CTRL+MAIUSC+P (Comando+MAIUSC+P in MacOS) e quindi digitare ".NET" e trovare e selezionare il comando .NET: Nuovo progetto.

  3. Dopo aver selezionato il comando, è necessario scegliere il modello di progetto. Scegliere Libreria di Classi.

  4. Selezionare quindi il percorso in cui si vuole creare il nuovo progetto.

  5. Selezionare quindi il percorso in cui si vuole creare il nuovo progetto: Creare una cartella denominata ClassLibraryProjects e selezionarla.

  6. Denominare il progetto StringLibrary, selezionare Mostra tutte le opzioni del modello, selezionare .NET 9 e selezionare Crea progetto.

  7. Assegnare al progetto il nome StringLibrary e selezionare Crea Progetto.

  8. Premere invio al prompt il progetto verrà creato nel percorso <>.

  9. Verificare che la libreria sia destinata a .NET 9. In Explorer, apri StringLibrary/StringLibrary.csproj.

    L'elemento TargetFramework mostra che il progetto è destinato a .NET 9.0.

    <Project Sdk="Microsoft.NET.Sdk">

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

</Project>

  10. Aprire Class1.cs e sostituire il codice con il codice seguente.

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

    La libreria di classi, UtilityLibraries.StringLibrary, contiene un metodo denominato StartsWithUpper. Questo metodo restituisce un valore Boolean che indica se l'istanza della stringa corrente inizia con un carattere maiuscolo. Lo standard Unicode distingue i caratteri maiuscoli dai caratteri minuscoli. Il metodo Char.IsUpper(Char) restituisce true se un carattere è maiuscolo.

    StartsWithUpper viene implementato come metodo di estensione in modo da poterlo chiamare come se fosse un membro della classe String.

  11. Salvare il file.

  12. Espandere Esplora Soluzioni nella parte inferiore della vista Esplora.

  13. Fare clic con il pulsante destro del mouse sulla soluzione in Esplora soluzioni e selezionare Compila, oppure aprire la Palette dei comandi e selezionare .NET: Compila per compilare la soluzione e verificare che il progetto venga compilato senza errori.

    L'output del terminale è simile all'esempio seguente:

    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

Aggiungere un'app console alla soluzione

Aggiungere un'applicazione console che usa la libreria di classi. L'app chiederà all'utente di immettere una stringa e di segnalare se la stringa inizia con un carattere maiuscolo.

  1. Fare clic con il pulsante destro del mouse sulla soluzione in Esplora soluzioni e selezionare Nuovo progettooppure nel Command Palette selezionare .NET: Nuovo progetto.

  2. selezionare applicazione console.

  3. Dai il nome ShowCase, seleziona il percorso predefinito e seleziona Crea Progetto.

  4. Aprire ShowCase/Program.cs e sostituire tutto il codice con il codice seguente.

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

    Il codice usa la variabile row per mantenere un conteggio del numero di righe di dati scritti nella finestra della console. Ogni volta che è maggiore o uguale a 25, il codice cancella la finestra della console e visualizza un messaggio all'utente.

    Il programma richiede all'utente di immettere una stringa. Indica se la stringa inizia con un carattere maiuscolo. Se l'utente preme il tasto INVIO senza immettere una stringa, l'applicazione termina e la finestra della console viene chiusa.

  5. Salvare le modifiche.

Aggiungere un riferimento al progetto

Inizialmente, il nuovo progetto di app console non ha accesso alla libreria di classi. Per consentire al programma di chiamare i metodi nella libreria di classi, creare un riferimento al progetto della libreria di classi.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto ShowCase e selezionare Aggiungi riferimento al progetto.

  2. Selezionare StringLibrary.

Eseguire l'app

  1. Selezionare Esegui>Esegui senza eseguire il debug.

  2. Selezionare C#.

  3. Selezionare ShowCase.

    Se viene visualizzato un errore che indica che non viene caricato alcun programma C#, chiudere la cartella aperta e aprire la cartella ShowCase. Provare quindi a eseguire di nuovo l'app.

  4. Provare il programma immettendo stringhe e premendo il tasto INVIO, quindi premere il tasto INVIO per uscire.

    L'output del terminale è simile all'esempio seguente:

    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

Risorse aggiuntive

Passaggi successivi

In questa esercitazione è stato creato un progetto di libreria e è stato aggiunto un progetto di app console che usa la libreria. Nell'esercitazione successiva si aggiunge un progetto di unit test alla soluzione.

Testare una libreria di classi .NET con .NET usando Visual Studio Code