Inicio rápido: Instalar y usar un paquete con la CLI de dotnet
Artículo
Los paquetes NuGet contienen código binario compilado que los desarrolladores ponen a disposición de otros desarrolladores para que lo utilicen 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.
Puede hacer referencia a los paquetes instalados en el código con una directiva using <namespace>, donde <namespace> suele ser el nombre del paquete. A continuación, puede usar la API del paquete en su proyecto.
El SDK de .NET, que ofrece la herramienta de línea de comandos de dotnet. 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. En este tutorial, cree un proyecto simple de consola de .NET mediante la CLI de dotnet, de la siguiente manera:
Cree una carpeta denominada Nuget.Quickstart para el proyecto.
Abra un símbolo del sistema y cambie a la carpeta nueva.
Cree el proyecto con el comando siguiente:
CLI de .NET
dotnetnew console
Use dotnet run para probar la aplicación. Debería ver el resultado Hello, World!.
Agregar el paquete de NuGet Newtonsoft.Json
Use el comando siguiente para instalar el paquete Newtonsoft.json:
CLI de .NET
dotnetadd package Newtonsoft.Json
Una vez completado el comando, abra el archivo Nuget.Quickstart.csproj en Visual Studio para ver la referencia del paquete NuGet agregada:
En Visual Studio, abra el archivo Program.cs y agregue la siguiente línea al principio del archivo:
cs
using Newtonsoft.Json;
Agregue el código siguiente para reemplazar la instrucción Console.WriteLine("Hello, World!");:
cs
namespaceNuget.Quickstart
{
publicclassAccount
{
publicstring? Name { get; set; }
publicstring? Email { get; set; }
public DateTime DOB { get; set; }
}
internalclassProgram
{
staticvoidMain(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);
}
}
}
Guarde el archivo y, a continuación, compile y ejecute la aplicación mediante el comando dotnet run. El resultado debe ser la representación JSON del objeto Account en el código:
Cree un proyecto de .NET y aprenda a agregar paquetes y a administrar las dependencias de paquete del proyecto. Use la CLI de .NET Core y el registro de NuGet para agregar bibliotecas y herramientas a sus aplicaciones C# mediante Visual Studio Code.