Compartir a través de

Inicio rápido: Instalación y uso de un paquete con la CLI de dotnet

Los paquetes NuGet contienen código binario compilado que los desarrolladores hacen disponibles para que otros desarrolladores los usen en sus proyectos. Para obtener más información, consulte ¿Qué es NuGet? En este inicio rápido se describe cómo instalar el popular paquete NuGet Newtonsoft.Json en un proyecto de .NET mediante el comando dotnet add package .

Se refiere a los paquetes instalados en el código con una using <namespace> directiva, donde <namespace> a menudo es el nombre del paquete. Después, puede usar la API del paquete en el proyecto.

Sugerencia

Examine nuget.org/packages para buscar paquetes que puede reutilizar en sus propias aplicaciones. Puede buscar directamente en https://nuget.orgo buscar e instalar paquetes desde Visual Studio. Para obtener más información, consulte Búsqueda y evaluación de paquetes NuGet para el proyecto.

Prerrequisitos

  • El SDK de .NET, que proporciona la dotnet herramienta de línea de comandos. A partir de Visual Studio 2017, la CLI de dotnet se instala automáticamente con cualquier carga de trabajo relacionada con .NET o .NET Core.

Creación de un proyecto

Puede instalar paquetes NuGet en un proyecto de .NET. Para este tutorial, cree un proyecto de consola de .NET simple mediante la CLI de dotnet, como se indica a continuación:

  1. Cree una carpeta denominada Nuget.Quickstart para el proyecto.

  2. Abra una línea de comandos y cambie a la carpeta nueva.

  3. Cree el proyecto mediante el comando siguiente:

    dotnet new console

  4. Use dotnet run para probar la aplicación. Debería ver el resultado Hello, World!.

Añade el paquete NuGet Newtonsoft.Json

  1. Use el comando siguiente para instalar el paquete Newtonsoft.json:

    dotnet add package Newtonsoft.Json

  2. Una vez completado el comando, abra el archivo Nuget.Quickstart.csproj en Visual Studio para ver la referencia del paquete NuGet agregada:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

Uso de la API Newtonsoft.Json en la aplicación

  1. En Visual Studio, abra el archivo Program.cs y agregue la siguiente línea en la parte superior del archivo:

    using Newtonsoft.Json;

  2. Agregue el código siguiente para reemplazar la Console.WriteLine("Hello, World!"); instrucción :

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Guarde el archivo y, a continuación, compile y ejecute la aplicación mediante el dotnet run comando . La salida es la representación JSON del Account objeto en el código:

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

Enhorabuena por instalar y usar su primer paquete NuGet.

Encuentra más vídeos de NuGet en Channel 9 y YouTube.

Pasos siguientes

Obtenga más información sobre cómo instalar y usar paquetes NuGet con la CLI de dotnet:

Instalación y uso de paquetes mediante la CLI de dotnet