Compartir a través de

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

En este inicio rápido, usará Microsoft Visual Studio para instalar y usar un paquete NuGet en un proyecto. Un paquete NuGet contiene código reutilizable que otros desarrolladores le permiten usar en los proyectos.

Puede instalar un paquete NuGet en un proyecto de Visual Studio mediante el NuGet Administrador de paquetes, el Administrador de paquetes Console o la interfaz de línea de comandos (CLI) .NET (CLI). En este inicio rápido se muestra cómo usar el Administrador de paquetes NuGet y la consola de Administrador de paquetes para instalar un paquete. Siga los pasos para crear un proyecto de Windows Presentation Foundation (WPF) que use el popular paquete Newtonsoft.Json. El mismo proceso se aplica a cualquier otro proyecto de .NET.

Este artículo es solo para Windows usuarios. Si usa Visual Studio para Mac, consulte Install y use un paquete en Visual Studio para Mac.

Propina

Para buscar un paquete NuGet, comience con nuget.org. Navegar por nuget.org es la forma en que los desarrolladores de .NET suelen encontrar componentes que pueden reutilizar en sus propias aplicaciones. Puede realizar una búsqueda de nuget.org directamente o buscar e instalar paquetes dentro de Visual Studio como se muestra en este artículo. Para obtener más información, consulte Búsqueda y evaluación de paquetes NuGet para el proyecto.

Prerrequisitos

  • Instale Visual Studio 2026 con la carga de trabajo para desarrollo de aplicaciones de escritorio con .NET.

    Puede instalar la edición 2026 Community de forma gratuita desde visualstudio.microsoft.com, o bien puede usar la edición Professional o Enterprise.

Creación de un proyecto

Puede instalar un paquete NuGet en cualquier proyecto de .NET si ese paquete admite la misma plataforma de destino que el proyecto. Para este inicio rápido, creará un proyecto de aplicación de WPF.

Siga estos pasos:

  1. En Visual Studio, seleccione File>New>Project/Solution.

  2. En la ventana Crear un nuevo proyecto , vaya al cuadro de búsqueda y escriba wpf. En la lista resultante de plantillas de proyecto, seleccione la plantilla WPF Application que tiene C# y Windows y seleccione Next.

  3. En la ventana Configurar el nuevo proyecto, actualice opcionalmente los valores Project name y Solution name y seleccione Siguiente.

  4. En la ventana Adicional, en Framework, seleccione .NET 10.0 (o la versión más reciente) y seleccione Crear.

    Visual Studio crea el proyecto y aparece en Explorador de soluciones.

Añade el paquete NuGet Newtonsoft.Json

Para instalar un paquete NuGet en este inicio rápido, puede usar el Administrador de paquetes NuGet o la consola de Administrador de paquetes. En función del formato del proyecto, la instalación de un paquete NuGet registra la dependencia en el archivo del proyecto o en un archivo packages.config. Para obtener más información, consulte flujo de trabajo de consumo de paquetes.

Administrador de paquetes de NuGet

Para usar el NuGet Administrador de paquetes para instalar el paquete Newtonsoft.Json en Visual Studio, siga estos pasos:

  1. Seleccione Project>Administrar paquetes NuGet.

  2. En la página NuGet Administrador de paquetes, junto a Package source, seleccione nuget.org.

  3. Vaya a la pestaña Examinar y busque Newtonsoft.Json. En la lista, seleccione Newtonsoft.Json y, a continuación, seleccione Instalar.

    Screenshot del Administrador de paquetes de NuGet. El paquete Newtonsoft.Json está seleccionado. Su panel de detalles muestra los datos del paquete y tiene un botón Instalar.

  4. Si se le pide que compruebe la instalación, seleccione Aplicar.

Consola del Administrador de Paquetes

Como alternativa, para usar la consola de Administrador de paquetes en Visual Studio para instalar el paquete Newtonsoft.Json, siga estos pasos:

  1. En Visual Studio, seleccione Tools>NuGet Administrador de paquetes>Administrador de paquetes Console.

  2. En la parte superior de la ventana Administrador de paquetes Console, compruebe que el proyecto Default lista muestra el proyecto en el que desea instalar el paquete. Si tiene un solo proyecto en la solución, se preselecciona.

    Captura de pantalla de la ventana de consola de Administrador de paquetes, que contiene información sobre la versión y licencia. La lista de proyectos predeterminados está resaltada.

  3. En el símbolo del sistema de consola, escriba el comando Install-Package Newtonsoft.Json. Para obtener más información sobre este comando, vea Install-Package.

    La ventana de consola muestra la salida del comando. Los errores suelen indicar que el paquete no es compatible con el marco de destino del proyecto.

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

Después de instalar un paquete NuGet, puede hacer una referencia a él en el código mediante la instrucción using <namespace>, donde <espacio de nombres> es el nombre del paquete que está usando. Después de establecer una referencia, puede llamar al paquete mediante su API.

Con el paquete Newtonsoft.Json en el proyecto, puede llamar a su método JsonConvert.SerializeObject. Para usar este método para convertir un objeto en una cadena legible, siga estos pasos:

  1. En Explorador de soluciones, abra MainWindow.xaml y reemplace el elemento />c2 /> < existente por el código 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>

  2. En Explorador de soluciones, expanda el nodo MainWindow.xaml y abra el archivo MainWindow.xaml.cs. Inserte el código siguiente dentro de la MainWindow clase , después del constructor :

    public class Account
{
    public string ID { get; set; }
    public decimal Balance { get; set; }
    public DateTime Created { get; set; }
}

private void Button_Click(object sender, RoutedEventArgs e)
{
    Account account = new Account
    {
        ID = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
        Balance = 4389.21m,
        Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
    };
    string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
    TextBlock.Text = json;
}

  3. Si MainWindow.xaml.cs no contiene la línea siguiente, agréguela al principio del archivo:

    using Newtonsoft.Json;

    Sin esta línea, Visual Studio marca el objeto JsonConvert con una línea roja y ondulada para indicar un error.

  4. Para compilar y ejecutar la aplicación, seleccione F5 o seleccione Depurar>Iniciar depuración.

    Aparece la ventana siguiente:

    Captura de pantalla de la ventana MainWindow que la aplicación crea en Visual Studio. La ventana contiene un botón Haz clic en mí y el término TextBlock.

  5. Seleccione Haz clic en mí. La aplicación actualiza la ventana reemplazando el TextBlock objeto por texto JSON.

    Screenshot de la ventana MainWindow en Visual Studio, que contiene un botón Click Me y código JSON que enumera los valores ID, Balance y Created.

Para obtener vídeos sobre el uso de NuGet para la administración de paquetes, consulte .NET Administración de paquetes con NuGet para principiantes y NuGet para principiantes.

Contenido relacionado

Para obtener más información sobre cómo instalar y administrar paquetes NuGet, consulte los siguientes artículos:

Para obtener más información sobre NuGet, consulte los siguientes artículos:

  • Last updated on