Kurz: Začínáme s jazykem C# a ASP.NET Core v sadě Visual Studio

V tomto kurzu pro vývoj v jazyce C# pomocí ASP.NET Core vytvoříte webovou aplikaci C# ASP.NET Core v sadě Visual Studio.

V tomto kurzu získáte informace o následujících postupech:

  • Vytvoření projektu ve Visual Studiu
  • Vytvoření webové aplikace ASP.NET Core v jazyce C#
  • Provádění změn ve webové aplikaci
  • Prozkoumání funkcí integrovaného vývojového prostředí (IDE)
  • Spusťte webovou aplikaci

Požadavky

K dokončení tohoto kurzu potřebujete Visual Studio. Navštivte stránku se soubory ke stažení sady Visual Studio pro bezplatnou verzi.

Vytvoření projektu

Nejprve vytvoříte projekt ASP.NET Core. Typ projektu obsahuje všechny soubory šablon, které potřebujete k vytvoření plně funkčního webu.

  1. V úvodním okně vyberte Vytvořit nový projekt.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. V okně Vytvořit nový projekt vyberte v seznamu Jazyků jazyk C#. Potom ze seznamu platforem vyberte Windows a ze seznamu typů projektů web .

    Po použití filtrů jazyka, platformy a typu projektu vyberte šablonu ASP.NET Základní webová aplikace a pak vyberte Další.

    Screenshot that shows the ASP.NET Core Web App project template highlighted in the New Project dialog box in Visual Studio.

    Poznámka:

    Pokud šablonu webové aplikace ASP.NET Core nevidíte, můžete ji nainstalovat z okna Vytvořit nový projekt.

    Ve zprávě Nenajděte, co hledáte? V dolní části seznamu šablon vyberte odkaz Nainstalovat další nástroje a funkce.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    V Instalační program pro Visual Studio vyberte ASP.NET a vývoj pro web.

    Screenshot shows the dot NET Core cross-platform development workload in the Visual Studio Installer.

    V Instalační program pro Visual Studio vyberte Upravit. Může se zobrazit výzva k uložení práce. Výběrem možnosti Pokračovat nainstalujte úlohu.

    Vraťte se ke kroku 2 v tomto postupu Vytvoření projektu.

  3. V okně Konfigurovat nový projekt zadejte myCoreApp do pole Název projektu. Pak vyberte Další.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. V okně Další informace ověřte, že se v poli Cílová architektura zobrazí .NET Core 3.1.

    V tomto okně můžete povolit podporu Dockeru a přidat podporu ověřování. Rozevírací nabídka pro typ ověřování má následující čtyři možnosti:

    • Žádné: Žádné ověřování.
    • Jednotlivé účty: Tato ověřování se ukládají do místní databáze nebo databáze založené na Azure.
    • Microsoft Identity Platform: Tato možnost používá k ověřování ID Microsoft Entra nebo Microsoft 365.
    • Windows: Vhodné pro intranetové aplikace.

    Políčko Povolit Docker ponechte nezaškrtnuté a jako typ ověřování vyberte Žádné.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET Core 3.1.

  5. Vyberte Vytvořit.

Visual Studio otevře nový projekt.

  1. V úvodním okně vyberte Vytvořit nový projekt.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. V okně Vytvořit nový projekt vyberte v seznamu Jazyků jazyk C#. Potom ze seznamu platforem vyberte Windows a ze seznamu typů projektů web .

    Po použití filtrů jazyka, platformy a typu projektu vyberte šablonu ASP.NET Základní webová aplikace a pak vyberte Další.

    Screenshot that shows the ASP.NET Core Web App project template selected and highlighted on the Create a new project page.

    Poznámka:

    Pokud šablonu webové aplikace ASP.NET Core nevidíte, můžete ji nainstalovat z okna Vytvořit nový projekt.

    Ve zprávě Nenajděte, co hledáte? V dolní části seznamu šablon vyberte odkaz Nainstalovat další nástroje a funkce.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    V Instalační program pro Visual Studio vyberte ASP.NET a úlohu vývoje webu.

    Screenshot shows the ASP.NET and web development workload in the Visual Studio Installer.

    V Instalační program pro Visual Studio vyberte Upravit. Může se zobrazit výzva k uložení práce. Výběrem možnosti Pokračovat nainstalujte úlohu.

    Vraťte se ke kroku 2 v tomto postupu Vytvoření projektu.

  3. V okně Konfigurovat nový projekt zadejte myCoreApp do pole Název projektu. Pak vyberte Další.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. V okně Další informace ověřte, že se rozhraní .NET 8.0 zobrazí v poli Cílová architektura.

    V tomto okně můžete povolit podporu Dockeru a přidat podporu ověřování. Rozevírací nabídka pro typ ověřování má následující čtyři možnosti:

    • Žádné: Žádné ověřování.
    • Jednotlivé účty: Tato ověřování se ukládají do místní databáze nebo databáze založené na Azure.
    • Microsoft Identity Platform: Tato možnost používá k ověřování ID Microsoft Entra nebo Microsoft 365.
    • Windows: Vhodné pro intranetové aplikace.

    Políčko Povolit Docker ponechte nezaškrtnuté a jako typ ověřování vyberte Žádné.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET 8.0.

  5. Vyberte Vytvořit.

Visual Studio otevře nový projekt.

Informace o vašem řešení

Toto řešení se řídí vzorem návrhu razor Page . Liší se od vzoru návrhu MVC (Model-View-Controller), který zjednodušuje zahrnutí kódu modelu a kontroleru do samotné stránky Razor Page.

Prohlídka řešení

  1. Šablona projektu vytvoří řešení s jedním projektem ASP.NET Core s názvem MyCoreApp. Vyberte kartu Průzkumník řešení a zobrazte její obsah.

    Screenshot shows the MyCoreApp project selected in the Solution Explorer in Visual Studio.

  2. Rozbalte složku Stránky.

    Screenshot shows the contents of the Pages folder in the the Solution Explorer in Visual Studio..

  3. Vyberte soubor Index.cshtml a zobrazte ho v editoru kódu.

    Screenshot shows the Index dot c s h t m l file open in the Visual Studio code editor.

  4. Každý soubor .cshtml má přidružený soubor kódu. Pokud chcete otevřít soubor kódu v editoru, rozbalte uzel Index.cshtml v Průzkumník řešení a vyberte soubor Index.cshtml.cs.

    Screenshot shows Index dot c s h t m l file selected in the Solution Explorer in Visual Studio.

  5. Zobrazte soubor Index.cshtml.cs v editoru kódu.

    Screenshot shows the Index dot c s h t m l dot c s file open in the Visual Studio code editor.

  6. Projekt obsahuje složku wwwroot , což je kořen pro váš web. Rozbalte složku a zobrazte její obsah.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    Statický obsah webu, jako jsou šablony stylů CSS, obrázky a javascriptové knihovny, můžete umístit přímo do požadovaných cest.

    Projekt obsahuje také konfigurační soubory, které spravují webovou aplikaci za běhu. Výchozí konfigurace aplikace je uložená v souboru appsettings.json. Tato nastavení ale můžete přepsat pomocí nastavení aplikace. Development.json.

  7. Rozbalte soubor appsettings.json a zobrazte nastavení aplikace. Soubor Development.json.

    Screenshot shows appsettings dot j son selected and expanded in the Solution Explorer in Visual Studio.

Spuštění, ladění a provádění změn

  1. Na panelu nástrojů vyberte tlačítko IIS Express a sestavte a spusťte aplikaci v režimu ladění. Případně stiskněte klávesu F5 nebo přejděte na Panel nabídek na> ladění.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    Poznámka:

    Pokud se zobrazí chybová zpráva s informací , že se nelze připojit k webovému serveru IIS Express, zavřete Visual Studio a znovu spusťte program jako správce. Tuto úlohu můžete provést tak, že kliknete pravým tlačítkem myši na ikonu sady Visual Studio z nabídky Start a pak v místní nabídce vyberete možnost Spustit jako správce .

    Může se zobrazit také zpráva s dotazem, jestli chcete přijmout certifikát SSL Express služby IIS. Pokud chcete zobrazit kód ve webovém prohlížeči, vyberte Ano a pak vyberte Ano , pokud se zobrazí zpráva s upozorněním na zabezpečení pro následnou akci.

  2. Visual Studio spustí okno prohlížeče. V řádku nabídek by se měly zobrazit stránky Domů a Ochrana osobních údajů .

  3. V řádku nabídek vyberte Soukromí . Stránka Ochrana osobních údajů v prohlížeči vykreslí text nastavený v souboru Privacy.cshtml .

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Vraťte se do sady Visual Studio a stisknutím kombinace kláves Shift+F5 zastavte ladění. Tato akce zavře projekt v okně prohlížeče.

  5. V sadě Visual Studio otevřete soubor Privacy.cshtml pro úpravy. Dále odstraňte větu, použijte tuto stránku k podrobnostem o zásadách ochrany osobních údajů vašeho webu a nahraďte ji touto stránkou @ViewDatajako ["TimeStamp"].

    Screenshot shows the Privacy dot c s h t m l file open in the Visual Studio code editor with the updated text.

  6. Teď provedeme změnu kódu. Vyberte Privacy.cshtml.cs. Dále pomocí následujícího zástupce vyčistíte using direktivy v horní části souboru:

    Najetí myší nebo výběr direktivy se šedě.using Žárovka Rychlých akcí se zobrazí pod kurzorem nebo na levém okraji. Vyberte žárovku a pak vyberte Odebrat nepotřebné použití.

    Screenshot shows the Privacy dot c s h t m l file in the Visual Studio code editor with the Quick Actions tooltip exposed for a greyed out using directive.

    Teď vyberte Náhled změn a podívejte se, jaké změny se změní.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    Vyberte Použít. Visual Studio odstraní nepotřebné using direktivy ze souboru.

  7. Dále v OnGet() metodě změňte text na následující kód:

    public void OnGet()
    {
       string dateTime = DateTime.Now.ToShortDateString();
       ViewData["TimeStamp"] = dateTime;
    }
    
  8. Všimněte si, že pod položkou DateTime se zobrazí podtržení vlnovkou. Podtržení vlnovek se zobrazí, protože tento typ není v oboru.

    Screenshot shows an error mark, in the form of a wavy underline, for DateTime in the Visual Studio code editor.

    Otevřete panel nástrojů Seznam chyb a zobrazte tam stejné chyby. Pokud panel nástrojů Seznam chyb nevidíte, přejděte na Seznam>chyb v horním řádku nabídek.

    Screenshot shows the Error List toolbar in Visual Studio with DateTime listed.

  9. Pojďme tuto chybu opravit. V editoru kódu umístěte kurzor na řádek, který obsahuje chybu, a pak vyberte žárovku Rychlých akcí na levém okraji. Potom v rozevírací nabídce vyberte příkaz Using System. Pokud chcete tuto direktivu přidat do horní části souboru a vyřešit chyby.

    Screenshot shows the Quick Actions options from its drop-down menu with a mouseover on using System.

  10. Stisknutím klávesy F5 otevřete projekt ve webovém prohlížeči.

  11. V horní části webu vyberte Ochrana osobních údajů a zobrazte provedené změny.

    Screenshot showing the updated Privacy page that includes the changes you made.

  12. Zavřete webový prohlížeč, stisknutím kláves Shift+F5 zastavte ladění.

Změna domovské stránky

  1. V Průzkumník řešení rozbalte složku Pages a pak vyberte Index.cshtml.

    Screenshot shows Index dot c s h t m l selected under the Pages node in the Solution Explorer.

    Soubor Index.cshtml odpovídá vaší domovské stránce ve webové aplikaci, která běží ve webovém prohlížeči.

     Screenshot shows the Home page for the web app in the browser window.

    V editoru kódu uvidíte kód HTML pro text, který se zobrazí na domovské stránce.

    Screenshot shows the Index dot c s h t m l file for the Home page in the Visual Studio code editor.

  2. Nahraďte uvítací text textem Hello World!

    Screenshot shows the Index dot c s h t m l file in the Visual Studio code editor with the Welcome text changed to Hello World!.

  3. Vyberte IIS Express nebo stisknutím ctrl+ F5 spusťte aplikaci a otevřete ji ve webovém prohlížeči.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. Ve webovém prohlížeči uvidíte nové změny na domovské stránce.

    Screenshot shows the Home page for the web app in the browser window. The updated text says Hello World!

  5. Zavřete webový prohlížeč, stisknutím kláves Shift+F5 zastavte ladění a uložte projekt. Teď můžete Visual Studio zavřít.

Prohlídka řešení

  1. Šablona projektu vytvoří řešení s jedním projektem ASP.NET Core s názvem MyCoreApp. Vyberte kartu Průzkumník řešení a zobrazte její obsah.

    Screenshot shows the MyCoreApp project selected and its content in the Solution Explorer in Visual Studio.

  2. Rozbalte složku Stránky.

    Screenshot shows the contents of the Pages folder in the Solution Explorer.

  3. Vyberte soubor Index.cshtml a zobrazte ho v editoru kódu.

    Screenshot shows the Index.cshtml file open in the Visual Studio Code editor.

  4. Každý soubor .cshtml má přidružený soubor kódu. Pokud chcete otevřít soubor kódu v editoru, rozbalte uzel Index.cshtml v Průzkumník řešení a vyberte soubor Index.cshtml.cs.

    Screenshot shows Index.cshtml file selected in the Solution Explorer in Visual Studio.

  5. Zobrazte soubor Index.cshtml.cs v editoru kódu.

    Screenshot shows the Index.cshtml.cs file open in the Visual Studio Code editor.

  6. Projekt obsahuje složku wwwroot , což je kořen pro váš web. Rozbalte složku a zobrazte její obsah.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    Statický obsah webu, jako jsou šablony stylů CSS, obrázky a javascriptové knihovny, můžete umístit přímo do požadovaných cest.

  7. Projekt obsahuje také konfigurační soubory, které spravují webovou aplikaci za běhu. Výchozí konfigurace aplikace je uložená v souboru appsettings.json. Tato nastavení ale můžete přepsat pomocí nastavení aplikace. Development.json. Rozbalte soubor appsettings.json a zobrazte nastavení aplikace. Soubor Development.json.

    Screenshot shows appsettings.json selected and expanded, which exposes appsettings.Development.json, in the Solution Explorer in Visual Studio.

Spuštění, ladění a provádění změn

  1. Na panelu nástrojů vyberte tlačítko IIS Express a sestavte a spusťte aplikaci v režimu ladění. Případně stiskněte klávesu F5 nebo přejděte na Panel nabídek na> ladění.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    Poznámka:

    Pokud se zobrazí chybová zpráva s informací , že se nelze připojit k webovému serveru IIS Express, zavřete Visual Studio a znovu spusťte program jako správce. Tuto úlohu můžete provést tak, že kliknete pravým tlačítkem myši na ikonu sady Visual Studio z nabídky Start a pak v místní nabídce vyberete možnost Spustit jako správce .

    Může se zobrazit také zpráva s dotazem, jestli chcete přijmout certifikát SSL Express služby IIS. Pokud chcete zobrazit kód ve webovém prohlížeči, vyberte Ano a pak vyberte Ano , pokud se zobrazí zpráva s upozorněním na zabezpečení pro následnou akci.

  2. Visual Studio spustí okno prohlížeče. V řádku nabídek by se měly zobrazit stránky Domů a Ochrana osobních údajů .

  3. V řádku nabídek vyberte Soukromí . Stránka Ochrana osobních údajů v prohlížeči vykreslí text nastavený v souboru Privacy.cshtml .

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Vraťte se do sady Visual Studio a stisknutím kombinace kláves Shift+F5 zastavte ladění. Tato akce zavře projekt v okně prohlížeče.

  5. V sadě Visual Studio otevřete soubor Privacy.cshtml pro úpravy. Dále odstraňte větu, použijte tuto stránku k podrobnostem o zásadách ochrany osobních údajů vašeho webu a nahraďte ji touto stránkou @ViewDatajako ["TimeStamp"].

    Screenshot shows the Privacy.cshtml file open in the Visual Studio Code editor with the updated text.

  6. Teď provedeme změnu kódu. Vyberte Privacy.cshtml.cs. Potom vyčistíte direktivy using v horní části souboru tak, že vyberete následující zástupce:

    Najetí myší nebo výběr direktivy se šedě.using Žárovka Rychlých akcí se zobrazí pod kurzorem nebo na levém okraji. Vyberte žárovku a pak vyberte šipku rozbalení vedle možnosti Odebrat nepotřebné použití.

    Screenshot shows the Privacy.cshtml file in the Visual Studio Code editor with the Quick Actions tooltip open and Preview changes highlighted.

    Teď vyberte Náhled změn a podívejte se, jaké změny se změní.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    Vyberte Použít. Visual Studio odstraní nepotřebné using direktivy ze souboru.

  7. Dále vytvořte řetězec pro aktuální datum formátované pro jazykovou verzi nebo oblast pomocí metody DateTime.ToString .

    • První argument metody určuje, jak se má datum zobrazit. Tento příklad používá specifikátor formátu (d), který označuje krátký formát data.
    • Druhý argument je CultureInfo objekt, který určuje jazykovou verzi nebo oblast pro datum. Druhý argument mimo jiné určuje jazyk všech slov v datu a typ použitých oddělovačů.

    Změňte tělo OnGet() metody na následující kód:

    public void OnGet()
    {
       string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
       ViewData["TimeStamp"] = dateTime;
    }
    
  8. Všimněte si, že na začátek souboru se automaticky přidá následující using direktiva:

    using System.Globalization;
    

    System.Globalizationobsahuje CultureInfo třída.

  9. Stisknutím klávesy F5 otevřete projekt ve webovém prohlížeči.

  10. V horní části webu vyberte Ochrana osobních údajů a zobrazte provedené změny.

    Screenshot showing the Privacy page of the MyCoreApp that includes the changes made to add the date.

  11. Zavřete webový prohlížeč, stisknutím kláves Shift+F5 zastavte ladění.

Změna domovské stránky

  1. V Průzkumník řešení rozbalte složku Pages a pak vyberte Index.cshtml.

    Screenshot shows Index.cshtml selected under the Pages node in the Solution Explorer.

    Soubor Index.cshtml odpovídá vaší domovské stránce ve webové aplikaci, která běží ve webovém prohlížeči.

    Screenshot shows the Home page for the web app in the browser window.

    V editoru kódu uvidíte kód HTML pro text, který se zobrazí na domovské stránce.

    Screenshot shows the Index.cshtml file for the Home page in the Visual Studio Code editor.

  2. Nahraďte uvítací text textem Hello World!

    Screenshot shows the Index.cshtml file in the Visual Studio Code editor with the 'Welcome' text changed to 'Hello World!'.

  3. Vyberte IIS Express nebo stisknutím ctrl+ F5 spusťte aplikaci a otevřete ji ve webovém prohlížeči.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. Ve webovém prohlížeči uvidíte nové změny na domovské stránce.

    Screenshot shows the Home page for the web app in the browser window. The updated text says 'Hello World!'

  5. Zavřete webový prohlížeč, stisknutím kláves Shift+F5 zastavte ladění a uložte projekt. Teď můžete Visual Studio zavřít.

Další kroky

Blahopřejeme k dokončení tohoto kurzu! Doufáme, že jste se seznámili s jazykem C#, ASP.NET Core a integrovaným vývojovém prostředím sady Visual Studio. Další informace o vytvoření webové aplikace nebo webu pomocí jazyka C# a ASP.NET najdete v následujícím kurzu:

Nebo se naučíte kontejnerizovat webovou aplikaci pomocí Dockeru:

Viz také

Publikování webové aplikace do služby Aplikace Azure Service pomocí sady Visual Studio