\documentclass[10pt,a4paper]{article} % Packages \usepackage{fancyhdr} % For header and footer \usepackage{multicol} % Allows multicols in tables \usepackage{tabularx} % Intelligent column widths \usepackage{tabulary} % Used in header and footer \usepackage{hhline} % Border under tables \usepackage{graphicx} % For images \usepackage{xcolor} % For hex colours %\usepackage[utf8x]{inputenc} % For unicode character support \usepackage[T1]{fontenc} % Without this we get weird character replacements \usepackage{colortbl} % For coloured tables \usepackage{setspace} % For line height \usepackage{lastpage} % Needed for total page number \usepackage{seqsplit} % Splits long words. %\usepackage{opensans} % Can't make this work so far. Shame. Would be lovely. \usepackage[normalem]{ulem} % For underlining links % Most of the following are not required for the majority % of cheat sheets but are needed for some symbol support. \usepackage{amsmath} % Symbols \usepackage{MnSymbol} % Symbols \usepackage{wasysym} % Symbols %\usepackage[english,german,french,spanish,italian]{babel} % Languages % Document Info \author{B C Williams | Dev (Jackfruit)} \pdfinfo{ /Title (net-core-3-1-mvc-w-mysql.pdf) /Creator (Cheatography) /Author (B C Williams | Dev (Jackfruit)) /Subject (.Net Core 3.1 MVC w/MySQL Cheat Sheet) } % Lengths and widths \addtolength{\textwidth}{6cm} \addtolength{\textheight}{-1cm} \addtolength{\hoffset}{-3cm} \addtolength{\voffset}{-2cm} \setlength{\tabcolsep}{0.2cm} % Space between columns \setlength{\headsep}{-12pt} % Reduce space between header and content \setlength{\headheight}{85pt} % If less, LaTeX automatically increases it \renewcommand{\footrulewidth}{0pt} % Remove footer line \renewcommand{\headrulewidth}{0pt} % Remove header line \renewcommand{\seqinsert}{\ifmmode\allowbreak\else\-\fi} % Hyphens in seqsplit % This two commands together give roughly % the right line height in the tables \renewcommand{\arraystretch}{1.3} \onehalfspacing % Commands \newcommand{\SetRowColor}[1]{\noalign{\gdef\RowColorName{#1}}\rowcolor{\RowColorName}} % Shortcut for row colour \newcommand{\mymulticolumn}[3]{\multicolumn{#1}{>{\columncolor{\RowColorName}}#2}{#3}} % For coloured multi-cols \newcolumntype{x}[1]{>{\raggedright}p{#1}} % New column types for ragged-right paragraph columns \newcommand{\tn}{\tabularnewline} % Required as custom column type in use % Font and Colours \definecolor{HeadBackground}{HTML}{333333} \definecolor{FootBackground}{HTML}{666666} \definecolor{TextColor}{HTML}{333333} \definecolor{DarkBackground}{HTML}{6A1577} \definecolor{LightBackground}{HTML}{F5F0F6} \renewcommand{\familydefault}{\sfdefault} \color{TextColor} % Header and Footer \pagestyle{fancy} \fancyhead{} % Set header to blank \fancyfoot{} % Set footer to blank \fancyhead[L]{ \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{C} \SetRowColor{DarkBackground} \vspace{-7pt} {\parbox{\dimexpr\textwidth-2\fboxsep\relax}{\noindent \hspace*{-6pt}\includegraphics[width=5.8cm]{/web/www.cheatography.com/public/images/cheatography_logo.pdf}} } \end{tabulary} \columnbreak \begin{tabulary}{11cm}{L} \vspace{-2pt}\large{\bf{\textcolor{DarkBackground}{\textrm{.Net Core 3.1 MVC w/MySQL Cheat Sheet}}}} \\ \normalsize{by \textcolor{DarkBackground}{B C Williams | Dev (Jackfruit)} via \textcolor{DarkBackground}{\uline{cheatography.com/146421/cs/31670/}}} \end{tabulary} \end{multicols}} \fancyfoot[L]{ \footnotesize \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{LL} \SetRowColor{FootBackground} \mymulticolumn{2}{p{5.377cm}}{\bf\textcolor{white}{Cheatographer}} \\ \vspace{-2pt}B C Williams | Dev (Jackfruit) \\ \uline{cheatography.com/jackfruit} \\ \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Cheat Sheet}} \\ \vspace{-2pt}Published 14th April, 2022.\\ Updated 17th April, 2022.\\ Page {\thepage} of \pageref{LastPage}. \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Sponsor}} \\ \SetRowColor{white} \vspace{-5pt} %\includegraphics[width=48px,height=48px]{dave.jpeg} Measure your website readability!\\ www.readability-score.com \end{tabulary} \end{multicols}} \begin{document} \raggedright \raggedcolumns % Set font size to small. Switch to any value % from this page to resize cheat sheet text: % www.emerson.emory.edu/services/latex/latex_169.html \footnotesize % Small font. \begin{tabularx}{17.67cm}{x{8.635 cm} x{8.635 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{17.67cm}}{\bf\textcolor{white}{Step 1 - Terminal}} \tn % Row 0 \SetRowColor{LightBackground} `dotnet tool install -{}-global dotnet-ef` & You will only ever need to run this once as it is a global install not project specific \tn % Row Count 5 (+ 5) % Row 1 \SetRowColor{white} `dotnet new mvc -{}-no-https -o {\emph{ProjectDirectoryName}}` & Creates new dotnet MVC Project for development \tn % Row Count 8 (+ 3) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{x{8.635 cm} x{8.635 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{17.67cm}}{\bf\textcolor{white}{Step 2 - Terminal (Inside Project Directory)}} \tn % Row 0 \SetRowColor{LightBackground} `dotnet add package \seqsplit{Pomelo.EntityFrameworkCore.MySql} -{}-version 3.1.1` & Entity Framework Core provider for MySQL DB's \tn % Row Count 4 (+ 4) % Row 1 \SetRowColor{white} `dotnet add package \seqsplit{Microsoft.EntityFrameworkCore.Design} -{}-version 3.1.5` & EF Core tools for DB creation/migration \tn % Row Count 8 (+ 4) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{17.67cm}}{{\emph{These two commands must be run in your project folder every time you set up a new MVC project!}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{x{8.635 cm} x{8.635 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{17.67cm}}{\bf\textcolor{white}{Step 3 - appsettings.json \&\& Startup.cs}} \tn % Row 0 \SetRowColor{LightBackground} `"DBInfo": \{\{nl\}\} \{ \{\{nl\}\} "Name": "MySQLconnect", \{\{nl\}\} "ConnectionString": "server=localhost;userid=root;password=root;port=3306;database={\bf{{\emph{SchemaName}}}};SslMode=None"\{\{nl\}\}\}` & Add this at the end of your appsettings.json file. \{\{nl\}\}{\emph{Don't forget a comma before this new section!}} \tn % Row Count 10 (+ 10) % Row 1 \SetRowColor{white} `using \seqsplit{Microsoft.EntityFrameworkCore;`} & Add this to your using statements at the top of Startup.cs \tn % Row Count 13 (+ 3) % Row 2 \SetRowColor{LightBackground} `services.AddDbContext\textless{}MyContext\textgreater{}(options =\textgreater{} options.UseMySql (Configuration{[}"DBInfo:ConnectionString"{]}));` & Add this to the `ConfigureServices` method in Startup.cs \tn % Row Count 19 (+ 6) % Row 3 \SetRowColor{white} \seqsplit{`services.AddSession();`} & Add this to the `ConfigureServices` method in Startup.cs {\emph{Adds Session}} \tn % Row Count 23 (+ 4) % Row 4 \SetRowColor{LightBackground} `app.UseSession();` & Add this to the `Configure` method in Startup.cs. {\emph{Adds Session}} \tn % Row Count 27 (+ 4) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{17.67cm}}{\bf\textcolor{white}{Step 4 - Context File}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{using \seqsplit{Microsoft.EntityFrameworkCore;} \newline namespace {\bf{{\emph{ProjDirName}}}}.Models \newline \{ \newline public class {\bf{{\emph{DBContextClassName}}}} : DbContext \newline \{ \newline public {\bf{{\emph{DBContextClassName}}}}(DbContextOptions options) : base(options) \{ \} \newline public DbSet\textless{}{\bf{{\emph{ModelName}}}}\textgreater{} {\bf{{\emph{TableName}}}} \{ get; set; \} \newline {\emph{Add more tables here}} \newline \} \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{{\emph{Sample code for context model file}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{17.67cm}}{\bf\textcolor{white}{Step 5 - Model Example}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{using System; \newline using \seqsplit{System.ComponentModel.DataAnnotations;} \newline namespace {\bf{{\emph{ProjDirName}}}}.Models \newline \{ \newline public class {\bf{{\emph{ModelName}}}} \newline \{ \newline {[}Key{]} \newline public int {\bf{{\emph{ModelName}}}}Id \{ get; set; \} \newline {\emph{Set all properties here}} \newline public DateTime CreatedAt \{ get; set; \} = DateTime.Now; \newline public DateTime UpdatedAt \{ get; set; \} = DateTime.Now; \newline {\emph{Set Navigation Properties}} \newline \} \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{{\emph{Class model for database table}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{17.67cm}}{\bf\textcolor{white}{Step 6 - Context Dependency Injection}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{using System; \newline using \seqsplit{System.Collections.Generic;} \newline using System.Linq; \newline using \seqsplit{Microsoft.EntityFrameworkCore;} \newline using {\bf{{\emph{ProjDirName}}}}.Models; \newline \newline public HomeController({\bf{{\emph{ContextClassName}}}} context) \newline \{ \newline \_context = context; \newline \} \newline \newline {[}HttpGet(""){]} \newline public IActionResult Index() \newline \{ \newline List\textless{}{\bf{{\emph{ModelName}}}}\textgreater{} {\emph{VariableName}} = \_context.{\bf{{\emph{TableName}}}}.ToList(); \newline \newline return View(); \newline \}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{17.67cm}}{{\emph{Sample of the code required to make DB Context available in controllers}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{17.67cm}{x{8.635 cm} x{8.635 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{17.67cm}}{\bf\textcolor{white}{Step 7 - Terminal - Migration}} \tn % Row 0 \SetRowColor{LightBackground} `dotnet ef migrations add {\bf{{\emph{MigrationName}}}}` & Creates a migration in preparation for Creating/Updating your DB Schema \tn % Row Count 4 (+ 4) % Row 1 \SetRowColor{white} `dotnet ef database update` & Updates Database schema with most recent migration \tn % Row Count 7 (+ 3) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{17.67cm}}{{\emph{This step to be done after all previous steps are complete and, preferably, after all models and relationships are in place.}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \end{document}