You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
abp/docs/cs/Getting-Started-AspNetCore-...

4.6 KiB

Začínáme s ASP.NET Core MVC šablonou

Tento tutoriál vysvětluje, jak vytvořit novou ASP.NET Core MVC webovou aplikaci pomocí úvodní šablony, jak ji nakonfigurovat a spustit.

Tvorba nového projektu

Tento tutoriál používá k tvorbě nového projektu ABP CLI. Podívejte se na stránku Začínáme pro více možností.

Pokud ještě nemáte ABP CLI nainstalováno, učiňte tak pomocí okna příkazového řádku:

dotnet tool install -g Volo.Abp.Cli

K tvorbě vašeho projektu použijte příkaz abp new v prázdné složce:

abp new Acme.BookStore

Můžete použít různé úrovně jmenných prostorů; např. BookStore, Acme.BookStore nebo Acme.Retail.BookStore.

Příkaz new vytvoří vrstvenou MVC aplikaci s Entity Framework Core jako databázovým poskytovatelem. Jsou zde však i jiné možnosti. Podívejte se na CLI dokumnentaci pro všechny další možností.

Požadavky

Vytvořené řešení vyžaduje;

Struktura řešení

Otevřete řešení ve Visual Studio:

bookstore-visual-studio-solution

Řešení má vrstvenou strukturu (založenou na Domain Driven Design) a obsahuje projekty jednotkovových a integračních testů předkonfigurované pro práci s EF Core & SQLite in-memory databází.

Podívejte se na dokument šablony aplikace k detailnímu pochopení struktury řešení.

Connection string databáze

Zkontrolujte connection string v souboru appsettings.json v projektu .Web:

{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
  }
}

Řešení je nakonfigurováno k používání Entity Framework Core s MS SQL Server. EF Core podporuje různé databázové poskytovatele, takže můžete použít i jiné DBMS. V případě potřeby změňte connection string.

Tvorba databáze & aplikace databázových migrací

K vytvoření databáze máte dvě možnosti.

Použití DbMigrator aplikace

Řešení obsahuje konzolovou aplikaci (v tomto příkladu nazvanou Acme.BookStore.DbMigrator), která může vytvářet databáze, aplikovat migrace a vkládat seed data. Je užitečná jak pro vývojové, tak pro produkční prostředí.

Projekt .DbMigrator má vlastní appsettings.json. Takže pokud jste změnili connection string uvedený výše, musíte změnit také tento.

Klikněte pravým na projekt .DbMigrator a vyberte Set as StartUp Project:

set-as-startup-project

Zmáčkněte F5 (nebo Ctrl+F5) ke spuštění aplikace. Výstup bude vypadat následovně:

set-as-startup-project

Použití EF Core Update-Database příkazu

Ef Core má Update-Database příkaz, který v případě potřeby vytvoří databázi a aplikuje čekající migrace. Klikněte pravým na projekt .Web a vyberte Set as StartUp Project:

set-as-startup-project

Otevřete Package Manager Console, vyberte projekt .EntityFrameworkCore.DbMigrations jako Default Project and spusťte příkaz Update-Database:

pcm-update-database

Dojde k vytvoření nové databáze na základě nakonfigurovaného connection stringu.

Použití nástroje .Migrator je doporučený způsob, jelikož zároveň vloží seed data nutné k správnému běhu webové aplikace.

Spuštění aplikace

Ujistěte se že je projekt .Web nastaven jako startovací projekt. Spusťte aplikaci což následně otevře úvodní stránku ve vašem prohlížeči:

bookstore-homepage

Klikněte na tlačítko Přihlásit, vložte admin jako uživatelské jméno a 1q2w3E* jako heslo k přihlášení do aplikace.

Startovací šabloná obsahuje identity management a tenant management moduly. Jakmile se přihlásite, budete mít přístup do nabídky Administrace, kde můžete spravovat tenanty, role, uživatele a jejich oprávnění. Správa uživatelů vypadá takto:

bookstore-user-management

Co dále?