Browse Source

Added startup template document.

pull/318/head
Halil ibrahim Kalkan 8 years ago
parent
commit
0126b80a90
  1. 64
      docs/Getting-Started-AspNetCore-MVC-Template.md
  2. 10
      docs/Index.md
  3. 3
      docs/Tutorials/AspNetCore-Mvc/Part-I.md
  4. BIN
      docs/images/bookstore-create-template.png
  5. BIN
      docs/images/bookstore-homepage.png
  6. BIN
      docs/images/bookstore-user-management.png
  7. BIN
      docs/images/bookstore-visual-studio-solution.png
  8. BIN
      docs/images/pcm-update-database.png
  9. BIN
      docs/images/set-as-startup-project.png

64
docs/Getting-Started-AspNetCore-MVC-Template.md

@ -0,0 +1,64 @@
## ASP.NET Core MVC Template
### Creating a new project
Go to the template creation page, enter a project name and create your project as shown below:
![bookstore-create--template](images/bookstore-create-template.png)
When you click to the *create* button, a new Visual Studio solution is created and downloaded with the name you have provided.
### The Solution Structure
Open the zip file downloaded and open in **Visual Studio 2017 (15.7.0+)**:
![bookstore-visual-studio-solution](images/bookstore-visual-studio-solution.png)
The solution has a layered structure (based on Domain Driven Design) where;
* **.Domain** project is the domain layer.
* **.Application** project is the application layer.
* **.Web** project is the presentation layer.
* **.EntityFrameworkCore** project is the EF Core integration package.
The solution does also contain unit & integration test projects properly configured to work with **EF Core** & **SQLite in-memory** database.
### Creating the Database
Check the **connection string** in the **appsettings.json** file under the **.Web** project:
````json
{
"ConnectionStrings": {
"Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
}
}
````
The solution is configured to use **Entity Framework Core** with **MS SQL Server** (EF Core supports [various](https://docs.microsoft.com/en-us/ef/core/providers/) database providers, so you can use another DBMS if you want).
Right click to the **.Web** project and select **Set as StartUp Project**:
![set-as-startup-project](images/set-as-startup-project.png)
Open the **Package Manager Console**, select **.EntityFrameworkCore** project as the **Default Project** and run the `Update-Database` command:
![pcm-update-database](D:\Github\abp\docs\images\pcm-update-database.png)
This will create a new database with the name configured.
### Running the Application
You can now run the application which will open the **home** page:
![bookstore-homepage](images/bookstore-homepage.png)
Click to the **Login** button, enter `admin` as the username and `1q2w3E*` as the password to login to the application.
Startup template includes the **identity management** module. Once you login, the Identity management menu will be available where you can manage **roles**, **users** and their **permissions**.
![bookstore-user-management](D:\Github\abp\docs\images\bookstore-user-management.png)
### What's Next?
* [Step by step application development tutorial for ASP.NET Core MVC](Tutorials/AspNetCore-Mvc/Part-I.md)

10
docs/Index.md

@ -3,8 +3,14 @@
## Table of Contents
* Getting Started
* <a href="Getting-Started-Console-Application.md" target="_blank">With Console Application</a>
* <a href="Getting-Started-AspNetCore-Application.md" target="_blank">With ASP.NET Core Web Application</a>
* From Startup Templates
* [ASP.NET Core MVC Template](Getting-Started-AspNetCore-MVC-Template.md)
* From Empty Projects
* <a href="Getting-Started-Console-Application.md" target="_blank">With Console Application</a>
* <a href="Getting-Started-AspNetCore-Application.md" target="_blank">With ASP.NET Core Web Application</a>
* Tutorials
* Application Development
* [With ASP.NET Core MVC](Tutorials/AspNetCore-Mvc/Part-I.md)
* Fundamentals
* <a href="Dependency-Injection.md" target="_blank">Dependency Injection</a>
* AutoFac Integration

3
docs/Tutorials/AspNetCore-Mvc/Part-I.md

@ -0,0 +1,3 @@
## ASP.NET Core MVC Tutorial - Part I
TODO

BIN
docs/images/bookstore-create-template.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

BIN
docs/images/bookstore-homepage.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

BIN
docs/images/bookstore-user-management.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

BIN
docs/images/bookstore-visual-studio-solution.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.2 KiB

BIN
docs/images/pcm-update-database.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.3 KiB

BIN
docs/images/set-as-startup-project.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.8 KiB

Loading…
Cancel
Save