Rychlý Start: instalace a použití balíčku v aplikaci Visual Studio (pouze Windows)

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

Po instalaci se podívejte na balíček v kódu, using <namespace> kde <namespace> je specifický pro balíček, který používáte. Po provedení odkazu můžete balíček volat prostřednictvím jeho rozhraní API.

Tip

Začínáme s NuGet.org: prohlížení NuGet.org je způsob, jakým vývojáři rozhraní .NET obvykle hledají komponenty, které mohou znovu použít ve svých vlastních aplikacích. Můžete vyhledat NuGet.org přímo nebo vyhledat a nainstalovat balíčky v sadě Visual Studio, jak je znázorněno v tomto článku. Obecné informace najdete v tématu vyhledání a vyhodnocení balíčků NuGet.

Požadavky

  • Visual Studio 2019 s úlohou vývoj desktopových aplikací .NET.

Edici 2019 Community Edition můžete zdarma nainstalovat 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

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

Pro tento návod použijte jednoduchou aplikaci WPF. V aplikaci Visual Studio vytvořte projekt pomocí souboru > Nový projekt, zadejte do vyhledávacího pole .NET a pak vyberte aplikaci WPF (.NET Framework). Klikněte na Next (Další). Po zobrazení výzvy přijměte výchozí hodnoty pro rozhraní .

Visual Studio vytvoří projekt, který se otevře v Průzkumník řešení.

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

Chcete-li nainstalovat balíček, můžete použít buď správce balíčků NuGet, nebo konzolu Správce balíčků. Při instalaci balíčku zaznamená NuGet závislost v souboru projektu nebo v 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 vyberte Spravovat balíčky NuGet.

    Příkaz Spravovat balíčky NuGet pro odkazy na projekt

  2. Jako zdroj balíčku zvolte "NuGet.org", vyberte kartu procházet , vyhledejte Newtonsoft.Jsna, vyberte tento balíček v seznamu a vyberte instalovat:

    Hledání Newtonsoft.Jsv balíčku

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

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

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

    Výběr formátu správy balíčků

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

Konzola Správce balíčků

  1. Vyberte nástroje > Správce balíčků NuGet > Konzola správce balíčků příkaz menu.

  2. Po otevření konzoly ověřte, zda je v rozevíracím seznamu výchozí projekt uveden projekt, do kterého chcete balíček nainstalovat. Pokud máte v řešení jeden projekt, je již vybrán.

    Vyberte projekt pro balíček.

  3. Zadejte příkaz Install-Package Newtonsoft.Json (viz Install-Package). V okně konzoly se zobrazí výstup příkazu. Chyby obvykle označují, že balíček není kompatibilní s cílovým rozhraním .NET Framework 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í Newtonsoft.Jsv rozhraní API v aplikaci

Pomocí Newtonsoft.Jsv balíčku v projektu můžete zavolat jeho JsonConvert.SerializeObject metodu pro převod objektu na řetězec čitelný z lidského.

  1. MainWindow.xamlExistující prvek otevřete a nahraďte Grid následujícím:

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

    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 přidali Newtonsoft.Jsdo balíčku do projektu, zobrazí se červené vlnovky v části, 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í > Spustit ladění:

    Počáteční výstup aplikace WPF

  5. Výběrem tlačítka na tomto tlačítku zobrazíte obsah TextBlock nahrazený nějakým textem JSON:

    Výstup aplikace WPF po výběru tlačítka

Další videa k NuGetu najdete na webu Channel 9 a YouTube.

Další kroky

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

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