Sdílet prostřednictvím

Rychlý start: Instalace a použití balíčku NuGet v sadě Visual Studio (jenom Windows)

  • Článek

Balíček NuGet obsahuje opakovaně použitelný kód, který vám ostatní vývojáři zpřístupnili pro použití ve svých projektech. Balíček NuGet můžete nainstalovat do projektu sady Microsoft Visual Studio pomocí správce balíčků NuGet, konzoly správce balíčků , nebo rozhraní příkazového řádku .NET CLI . Tento článek ukazuje, jak vytvořit projekt Windows Presentation Foundation (WPF) s oblíbeným balíčkem Newtonsoft.Json. Stejný postup platí pro jakýkoli jiný projekt .NET nebo .NET Core.

Jakmile nainstalujete balíček NuGet, můžete na něj v kódu odkazovat pomocí příkazu using <namespace>, kde <obor názvů> je název balíčku, který používáte. Jakmile vytvoříte odkaz, můžete balíček volat prostřednictvím jeho rozhraní API.

Článek je určený jenom pro uživatele Windows. Pokud používáte Visual Studio pro Mac, přečtěte si téma Instalace a použití balíčku v sadě Visual Studio pro Mac.

Rada

Pokud chcete najít balíček NuGet, začněte nuget.org. Procházení nuget.org je způsob, jakým vývojáři .NET obvykle najdou komponenty, které můžou opakovaně používat ve svých vlastních aplikacích. Můžete vyhledávat nuget.org přímo nebo vyhledávat a instalovat balíčky v sadě Visual Studio, jak je znázorněno v tomto článku. Další informace naleznete v tématu Najít a vyhodnotit balíčky NuGet.

Požadavky

  • Nainstalujte sadu Visual Studio 2022 pro Windows s pracovní zátěží pro vývoj desktopových aplikací .NET.

    Edici Community 2022 můžete nainstalovat zdarma z visualstudio.microsoft.comnebo můžete použít edici Professional nebo Enterprise.

Vytvoření projektu

Balíček NuGet můžete nainstalovat do libovolného projektu .NET, pokud tento balíček podporuje stejnou cílovou architekturu jako projekt. Pro účely tohoto rychlého startu však vytvoříte projekt aplikace WPF (Windows Presentation Foundation).

Postupujte takto:

  1. Ve Visual Studiu vyberte Soubor>Nový>Projekt.

  2. V okně Vytvořit nový projekt zadejte do vyhledávacího pole WPF a v rozevíracích seznamech vyberte C# a Windows. Ve výsledném seznamu šablon projektů vyberte Aplikace WPFa pak vyberte Další.

  3. V okně Konfigurace nového projektu volitelně aktualizujte název projektu a název řešenía pak vyberte Další.

  4. V okně Další informace vyberte .NET 6.0 (nebo nejnovější verzi) pro Frameworka pak vyberte Vytvořit.

    Visual Studio vytvoří projekt a zobrazí se v Průzkumníku řešení.

Přidejte balíček Newtonsoft.Json NuGet

K instalaci balíčku NuGet v tomto rychlém startu můžete použít správce balíčků NuGet nebo konzolu Správce balíčků. V závislosti na formátu projektu zaznamenává instalace balíčku NuGet závislost v souboru projektu nebo v souboru packages.config. Pro více informací se podívejte na Pracovní tok spotřeby balíčků.

Správce balíčků NuGet

Pokud chcete použít Správce balíčků NuGet k instalaci balíčku Newtonsoft.Json v prostředí Visual Studio, postupujte následovně:

  1. Vyberte Projekt>Spravovat balíčky NuGet.

  2. Na stránce Správce balíčků NuGet zvolte nuget.org jako zdroj balíčku .

  3. Na kartě Procházet vyhledejte Newtonsoft.Json, v seznamu vyberte Newtonsoft.Json a poté vyberte Nainstalovat.

    snímek obrazovky znázorňující okno Správce balíčků NuGet s vybraným balíčkem Newtonsoft.Json

  4. Pokud se zobrazí výzva k ověření instalace, vyberte OK.

Konzola Správce balíčků

Pokud chcete případně použít konzolu správce balíčků v sadě Visual Studio k instalaci balíčku Newtonsoft.Json, postupujte takto:

  1. V sadě Visual Studio vyberte Nástroje>Správce balíčků NuGet>Konzola správce balíčků.

  2. Po otevření podokna konzoly správce balíčků ověřte, že rozevírací seznam Výchozí projekt zobrazuje projekt, do kterého chcete balíček nainstalovat. Pokud máte v řešení jeden projekt, je předem vybraný.

    Snímek obrazovky s oknem konzoly Správce balíčků s výchozím projektem zvýrazněným

  3. Na příkazovém řádku konzoly zadejte příkaz Install-Package Newtonsoft.Json. Další informace o tomto příkazu naleznete v tématu Install-Package.

    V okně konzoly se zobrazí výstup příkazu. Chyby obvykle značí, že balíček není kompatibilní s cílovou architekturou projektu.

Použití rozhraní API Newtonsoft.Json v aplikaci

S balíčkem Newtonsoft.Json v projektu zavolejte metodu JsonConvert.SerializeObject a převeďte objekt na řetězec čitelný pro lidi:

  1. V průzkumníku řešení otevřete MainWindow.xaml a nahraďte existující prvek <Grid> následujícím kódem:

    <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. Otevřete soubor MainWindow.xaml.cs pod uzlem MainWindow.xaml a do třídy MainWindow po konstruktoru vložte následující kód:

    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, Newtonsoft.Json.Formatting.Indented);
    TextBlock.Text = json;
}

  3. Aby se zabránilo chybě týkající se objektu JsonConvert v kódu (zobrazí se červené zvlnění), přidejte na začátek souboru s kódem následující řádek:

    using Newtonsoft.Json;

  4. Pokud chcete sestavit a spustit aplikaci, stiskněte klávesu F5 nebo vyberte Ladění>Spustit ladění.

    Zobrazí se následující okno:

    snímek obrazovky s počátečním výstupem aplikace WPF.

  5. Výběrem tlačítka Click Me zobrazíte obsah objektu TextBlock nahrazený textem JSON.

    Snímek obrazovky znázorňující výstup aplikace WPF po výběru tlačítka

Viz také

Další informace o NuGetu najdete v následujících článcích:

Další kroky

Blahopřejeme k instalaci a použití prvního balíčku NuGet. V dalším článku najdete další informace o instalaci a správě balíčků NuGet.

Instalace a správa balíčků pomocí správce balíčků NuGet

Instalace a správa balíčků pomocí konzoly Správce balíčků