Inicio rápido: Instalación y uso de un paquete en Visual Studio (solo Windows)

Artículo
12/02/2021
4 minutos para leer

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. Consulte ¿Qué es NuGet? para obtener más información. Los paquetes se instalan en un proyecto de Visual Studio mediante el Administrador de paquetes NuGet, la Consola del Administrador de paquetes o la CLI de dotnet. En este artículo se muestra el proceso con el conocido paquete Newtonsoft.Json y un proyecto de Windows Presentation Foundation (WPF). El mismo proceso se aplica a cualquier otro proyecto de .NET o .NET Core.

Una vez instalado, haga referencia al paquete en el código con using <namespace>, donde <namespace> es específico del paquete que está usando. Una vez efectuada la referencia, puede llamar al paquete a través de su 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. Puede buscar directamente en nuget.org o buscar e instalar paquetes en Visual Studio, tal y como se indica en este artículo. Para información general, consulte Búsqueda y evaluación de paquetes NuGet para el proyecto.

Requisitos previos

Visual Studio 2019 con la carga de trabajo de Desarrollo de escritorio de .NET.

Puede instalar la 2019 Community Edition gratuitamente desde visualstudio.com o usar las ediciones Professional o Enterprise.

Si utiliza Visual Studio para Mac, consulte Instalación y uso de un paquete en Visual Studio para Mac.

Crear un proyecto

Los paquetes NuGet pueden instalarse en cualquier proyecto. NET, siempre que el paquete sea compatible con la misma plataforma de destino que el proyecto.

Para este tutorial, use una aplicación WPF sencilla. Cree un proyecto en Visual Studio archivo nuevo Project , escriba .NET en el cuadro de búsqueda y, a continuación, seleccione la aplicación WPF (.NET Framework). Haga clic en Siguiente. Acepte los valores predeterminados para Marco cuando se le solicite.

Visual Studio crea el proyecto, el que se abre en el Explorador de soluciones.

Agregar el paquete de NuGet Newtonsoft.Json

Para instalar el paquete, puede usar el Administrador de paquetes NuGet o la consola del Administrador de paquetes. Cuando se instala un paquete, NuGet graba la dependencia en el archivo de proyecto o en un archivo packages.config (según el formato del proyecto). Para más información, vea Flujo de trabajo de consumo de paquetes.

Administrador de paquetes de NuGet

En el Explorador de soluciones, haga clic con el botón derecho en Referencias y elija Administrar paquetes NuGet.
Elija "nuget.org" como origen del paquete, seleccione la pestaña Examinar, busque Newtonsoft.Json, seleccione ese paquete en la lista y seleccione Instalar:

Si quiere más información sobre el Administrador de paquetes NuGet, consulte Instalación y administración de paquetes con Visual Studio.
Acepte los mensajes de licencia.
(Solo Visual Studio 2017) Si se le pide que seleccione un formato de administración de paquetes, seleccione PackageReference en archivo de proyecto:
Si se le pide que revise los cambios, seleccione Aceptar.

Consola del Administrador de paquetes

Seleccione el comando demenú NuGet Administrador de paquetesAdministrador de paquetes Consola de herramientas.
Cuando se abra la consola, compruebe que la lista desplegable Proyecto predeterminado muestra el proyecto en el que quiere instalar el paquete. Si tiene un único proyecto en la solución, ya está seleccionado.
Escriba el comando Install-Package Newtonsoft.Json (consulte Install-Package Newtonsoft.Json). La ventana de la consola muestra el resultado del comando. Los errores indican que el paquete no es compatible con la plataforma de destino del proyecto.

Si quiere más información sobre la consola del Administrador de paquetes, consulte Instalación y administración de paquetes mediante la Consola del Administrador de paquetes.

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

Con el paquete Newtonsoft.Json en el proyecto, puede llamar a su método JsonConvert.SerializeObject para convertir un objeto en una cadena legible para el usuario.

Abra MainWindow.xaml y reemplace el elemento Grid existente por lo siguiente:

<Grid Background="White">
    <StackPanel VerticalAlignment="Center">
        <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/>
        <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/>
    </StackPanel>
</Grid>

Abra el archivo MainWindow.xaml.cs (que se encuentra en el nodo MainWindow.xaml del Explorador de soluciones) a inserte el código siguiente en la clase MainWindow:

public class Account
{
    public string Name { get; set; }
    public string Email { get; set; }
    public DateTime DOB { get; set; }
}

private void Button_Click(object sender, RoutedEventArgs e)
{
    Account account = new Account
    {
        Name = "John Doe",
        Email = "john@microsoft.com",
        DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
    };
    string json = JsonConvert.SerializeObject(account, Formatting.Indented);
    TextBlock.Text = json;
}

Aunque haya agregado el paquete Newtonsoft.Json al proyecto, aparecerán subrayados ondulados rojos debajo de JsonConvert porque necesita una instrucción using al principio del archivo de código:
```
using Newtonsoft.Json;
```
Compile y ejecute la aplicación presionando F5 o seleccionando DepurarIniciar depuración:
Seleccione el botón para ver el contenido del TextBlock reemplazado por algún texto JSON: