Rychlý start: Instalace a použití balíčku v Visual Studio (pouze Windows)

NuGet balíčky obsahují opakovaně použitelný kód, který vám ostatní vývojáři zpřístupní pro použití v projektech. Podívejte se, co je NuGet? pro pozadí. Balíčky se instalují do projektu Visual Studio pomocí NuGet Správce balíčků, konzoly Správce balíčků nebo rozhraní příkazového řádku dotnet. Tento článek ukazuje proces pomocí oblíbeného balíčku Newtonsoft.Json a projektu Windows Presentation Foundation (WPF). Stejný proces platí pro jakýkoli jiný projekt .NET nebo .NET Core.

Po instalaci si projděte balíček v kódu s místem using <namespace> , kde <je obor názvů> specifický pro balíček, který používáte. Po vytvoření odkazu můžete balíček volat prostřednictvím jeho rozhraní API.

Tip

Začněte s nuget.org: Procházením 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. Nuget.org můžete vyhledávat přímo nebo vyhledávat a instalovat balíčky v rámci Visual Studio, jak je znázorněno v tomto článku. Obecné informace najdete v tématu Hledání a vyhodnocení balíčků NuGet.

Požadavky

  • Visual Studio 2019 s úlohou vývoj pro desktopové aplikace .NET.

Edici Community 2019 můžete nainstalovat zdarma z visualstudio.com nebo použít edice Professional nebo Enterprise.

Pokud používáte Visual Studio pro Mac, přečtěte si téma Instalace a použití balíčku v Visual Studio pro Mac.

Vytvoření projektu

NuGet balíčky je možné nainstalovat do libovolného projektu .NET za předpokladu, že balíček podporuje stejnou cílovou architekturu jako projekt.

Pro účely tohoto návodu použijte jednoduchou aplikaci WPF. Vytvořte projekt v Visual Studio pomocí fileNew>Project, do vyhledávacího pole zadejte .NET a pak vyberte aplikaci WPF (.NET Framework). Klikněte na Next (Další). Po zobrazení výzvy přijměte výchozí hodnoty pro architekturu .

Visual Studio vytvoří projekt, který najdete v Průzkumník řešení. Další informace najdete v tématu Informace o Průzkumník řešení.

Přidání balíčku NuGet Newtonsoft.Json

K instalaci balíčku můžete použít NuGet Správce balíčků nebo konzolu Správce balíčků. Při instalaci balíčku NuGet zaznamenává závislost v souboru projektu nebo packages.config souboru (v závislosti na formátu projektu). Další informace najdete v tématu Přehled spotřeby balíčků a pracovní postup.

Správce balíčků NuGet

  1. V Průzkumník řešení klikněte pravým tlačítkem na Odkazy a zvolte Spravovat balíčky NuGet.

    Manage NuGet Packages command for project References

  2. Jako zdroj balíčku zvolte "nuget.org", vyberte kartu Procházet , vyhledejte Newtonsoft.Json, vyberte tento balíček v seznamu a vyberte Nainstalovat:

    Locating Newtonsoft.Json package

    Pokud chcete získat další informace o NuGet Správce balíčků, přečtěte si téma Instalace a správa balíčků pomocí Visual Studio.

  3. Přijměte všechny výzvy k licenci.

  4. (Visual Studio 2017) Pokud se zobrazí výzva k výběru formátu správy balíčků, vyberte PackageReference v souboru projektu:

    Selecting a package management format

  5. Pokud se zobrazí výzva ke kontrole změn, vyberte OK.

Konzola Správce balíčků

  1. Vyberte příkaz nabídky Nástroje>NuGet Správce balíčků>Správce balíčků Konzola.

  2. Po otevření konzoly zkontrolujte, jestli rozevírací seznam Výchozí projekt zobrazuje projekt, do kterého chcete balíček nainstalovat. Pokud máte v řešení jeden projekt, je už vybraný.

    Select a project for the package

  3. Zadejte příkaz Install-Package Newtonsoft.Json (viz Install-Package). V okně konzoly se zobrazí výstup příkazu. Chyby obvykle značí, že balíček není kompatibilní s cílovou architekturou projektu.

    Pokud chcete získat další informace o konzole Správce balíčků, přečtěte si téma Instalace a správa balíčků pomocí konzoly Správce balíčků.

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

Pomocí balíčku Newtonsoft.Json v projektu můžete volat jeho JsonConvert.SerializeObject metodu pro převod objektu na řetězec čitelný člověkem.

  1. Otevřete MainWindow.xaml a nahraďte existující Grid prvek 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. MainWindow.xaml.cs Otevřete soubor (umístěný v Průzkumník řešení pod MainWindow.xaml uzlem) a vložte do třídy následující kódMainWindow:

    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;
    }
    
  3. I když jste do projektu přidali balíček Newtonsoft.Json, červené vlnovky se zobrazí pod JsonConvert , protože potřebujete using příkaz v horní části souboru kódu:

    using Newtonsoft.Json;
    
  4. Sestavte a spusťte aplikaci stisknutím klávesy F5 nebo výběrem ladění DebugStart>:

    Initial output of the WPF app

  5. Výběrem tlačítka zobrazíte obsah objektu TextBlock nahrazený některým textem JSON:

    Output of the WPF app after selecting the button

Další NuGet videa najdete na Kanálu 9 a YouTube.

Další kroky

Blahopřejeme k instalaci a používání prvního balíčku NuGet!

Pokud chcete prozkoumat další možnosti, které NuGet musí nabídnout, vyberte níže uvedené odkazy.