Compartir a través de

Tutorial: Creación de una biblioteca de clases de .NET mediante Visual Studio Code

  • Artículo

En este tutorial, creará una biblioteca de utilidades sencilla que contiene un único método de control de cadenas.

Una biblioteca de clases define tipos y métodos utilizados por una aplicación. Si la biblioteca tiene como destino .NET Standard 2.0, se puede llamar a ella mediante cualquier implementación de .NET (incluido .NET Framework) que admita .NET Standard 2.0. Si la biblioteca tiene como destino .NET 9, cualquier aplicación que tenga como destino .NET 9 puede llamarla. En este tutorial se muestra cómo dirigirse a .NET 9.

Al crear una biblioteca de clases, puede distribuirla como un componente de terceros o como un componente agrupado con una o varias aplicaciones.

Prerrequisitos

Creación de un proyecto de biblioteca de clases

Empiece por crear un proyecto de biblioteca de clases de .NET denominado "StringLibrary" y una solución asociada. Una solución actúa como contenedor para uno o varios proyectos. Agregará otros proyectos relacionados a la misma solución.

  1. Inicie Visual Studio Code.

  2. Vaya a la vista Explorador y seleccione Crear proyecto de .NET. Como alternativa, puede abrir la paleta de comandos mediante Ctrl+Mayús+P (Comando+Mayús+P en MacOS) y, a continuación, escribir ".NET" y buscar y seleccionar el comando .NET: Nuevo proyecto.

  3. Después de seleccionar el comando, deberá elegir la plantilla de proyecto. Elija Biblioteca de clases.

  4. A continuación, seleccione la ubicación donde desea que se cree el nuevo proyecto.

  5. A continuación, seleccione la ubicación donde desea que se cree el nuevo proyecto: cree una carpeta denominada ClassLibraryProjects y selecciónela.

  6. Asigne al proyecto el nombre StringLibrary, seleccione Mostrar todas las opciones de plantilla, seleccione .NET 9 y seleccione Crear proyecto.

  7. Asigne al proyecto el nombre StringLibrary y seleccione Crear proyecto.

  8. Pulse Entrar en la solicitud El proyecto se creará en la <ruta de acceso>.

  9. Asegúrese de que la biblioteca tiene como destino .NET 9. En Explorer, abra el archivo StringLibrary/StringLibrary.csproj.

    El elemento TargetFramework muestra que el proyecto tiene como destino .NET 9.0.

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

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

</Project>

  10. Abra Class1.cs y reemplace el código por el código siguiente.

    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 biblioteca de clases, UtilityLibraries.StringLibrary, contiene un método denominado StartsWithUpper. Este método devuelve un valor de Boolean que indica si la instancia de cadena actual comienza con un carácter en mayúsculas. El estándar Unicode distingue caracteres en mayúsculas de caracteres en minúsculas. El método Char.IsUpper(Char) devuelve true si un carácter está en mayúsculas.

    StartsWithUpper se implementa como un método de extensión para que pueda llamarlo como si fuera miembro de la clase String.

  11. Guarde el archivo.

  12. Expanda Explorador de Soluciones en la parte inferior de la vista Explorador.

  13. Haga clic con el botón derecho en la solución en el "Explorador de Soluciones" y seleccione "Compilar"o abra la "Paleta de Comandos" y seleccione ".NET: Compilar" para compilar la solución y comprobar que el proyecto se compila sin errores.

    La salida del terminal es similar al ejemplo siguiente:

    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

Adición de una aplicación de consola a la solución

Agregue una aplicación de consola que use la biblioteca de clases. La aplicación pedirá al usuario que escriba una cadena e informe si la cadena comienza con un carácter en mayúsculas.

  1. Haga clic con el botón derecho en la solución en explorador de soluciones y seleccione Nuevo proyectoo, en la paleta de comandos, seleccione .NET: Nuevo proyecto.

  2. Seleccione Aplicación de consola.

  3. Asígnele el nombre ShowCase, seleccione la ubicación predeterminada y seleccione Crear proyecto.

  4. Abra ShowCase/Program.cs y reemplace todo el código por el código siguiente.

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

    El código usa la variable row para mantener un recuento del número de filas de datos escritos en la ventana de la consola. Siempre que sea mayor o igual que 25, el código borra la ventana de la consola y muestra un mensaje al usuario.

    El programa solicita al usuario que escriba una cadena. Indica si la cadena comienza con un carácter en mayúsculas. Si el usuario presiona la tecla Entrar sin especificar una cadena, la aplicación finaliza y la ventana de la consola se cierra.

  5. Guarde los cambios.

Agregar una referencia de proyecto

Inicialmente, el nuevo proyecto de aplicación de consola no tiene acceso a la biblioteca de clases. Para permitir que llame a métodos en la biblioteca de clases, cree una referencia de proyecto al proyecto de biblioteca de clases.

  1. En el Explorador de soluciones haga clic con el botón derecho en el proyecto ShowCase y seleccione Agregar referencia de proyecto.

  2. Seleccione StringLibrary.

Ejecución de la aplicación

  1. Seleccione Ejecutar>Ejecutar sin depurar.

  2. seleccione C#.

  3. Seleccione ShowCase.

    Si recibe un error que indica que no se carga ningún programa de C#, cierre la carpeta que tiene abierta y abra la carpeta ShowCase. A continuación, vuelva a intentar ejecutar la aplicación.

  4. Para probar el programa, escriba cadenas y presione Entrar y, después, presione Entrar para salir.

    La salida del terminal es similar al ejemplo siguiente:

    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

Recursos adicionales

Pasos siguientes

En este tutorial, ha creado un proyecto de biblioteca y ha agregado un proyecto de aplicación de consola que usa la biblioteca. En el siguiente tutorial, agregará un proyecto de prueba unitaria a la solución.

Probar una biblioteca de clases de .NET con .NET mediante Visual Studio Code