Inicio rápido: Instalar y usar un paquete con la CLI de dotnetQuickstart: Install and use a package using the dotnet CLI

Los paquetes de NuGet son unidades de código reutilizable que otros desarrolladores ponen a su disposición para que los use en sus proyectos.NuGet packages contain reusable code that other developers make available to you for use in your projects. Consulte ¿Qué es NuGet? para obtener más información.See What is NuGet? for background. Los paquetes se instalan en un proyecto de .NET Core con el comando dotnet add package tal y como se describe en este artículo para el popular paquete Newtonsoft.Json.Packages are installed into a .NET Core project using the dotnet add package command as described in this article for the popular Newtonsoft.Json package.

Una vez instalado, haga referencia al paquete en el código con using <namespace>, donde <namespace> es específico del paquete que está usando.Once installed, refer to the package in code with using <namespace> where <namespace> is specific to the package you're using. A continuación, puede usar la API del paquete.You can then use the package's API.

Sugerencia

Comience con nuget.org: la exploración de nuget.org es la forma en que los desarrolladores de .NET suelen buscar componentes que pueden reutilizar en sus propias aplicaciones.Start with nuget.org: Browsing nuget.org is how .NET developers typically find components they can reuse in their own applications. Puede buscar directamente en nuget.org o buscar e instalar paquetes en Visual Studio, tal y como se indica en este artículo.You can search nuget.org directly or find and install packages within Visual Studio as shown in this article.

Requisitos previosPrerequisites

Crear un proyectoCreate a project

Los paquetes NuGet pueden instalarse en todo tipo de proyecto de .NET.NuGet packages can be installed into a .NET project of some kind. En este tutorial, cree un proyecto simple de consola de .NET Core de la siguiente manera:For this walkthrough, create a simple .NET Core console project as follows:

  1. Cree una carpeta para el proyecto.Create a folder for the project.

  2. Cree el proyecto con el comando siguiente:Create the project using the following command:

    dotnet new console
    
  3. Utilice dotnet run para comprobar que la aplicación se ha creado correctamente.Use dotnet run to test that the app has been created properly.

Agregar el paquete de NuGet Newtonsoft.JsonAdd the Newtonsoft.Json NuGet package

  1. Use el comando siguiente para instalar el paquete Newtonsoft.json:Use the following command to install the Newtonsoft.json package:

    dotnet add package Newtonsoft.Json
    
  2. Una vez completado el comando, abra el archivo .csproj para ver la referencia agregada:After the command completes, open the .csproj file to see the added reference:

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

Usar la API de Newtonsoft.Json en la aplicaciónUse the Newtonsoft.Json API in the app

  1. Abra el archivo Program.cs y agréguele la línea siguiente al principio:Open the Program.cs file and add the following line at the top of the file:

    using Newtonsoft.Json;
    
  2. Agregue el código siguiente antes de llamar a la línea class Program:Add the following code before the class Program line:

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
  3. reemplace la función Main por lo siguiente:Replace the Main function with the following:

    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);
    }
    
  4. Compile y ejecute la aplicación mediante el comando dotnet run.Build and run the app by using the dotnet run command. El resultado debe ser la representación JSON del objeto Account en el código:The output should be the JSON representation of the Account object in the code:

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