(public).sospep.subjects ~ view article ~ introduction-to-ASPdotNET-core

<h1 style="text-align: center;">introduction to asp.net core 1</h1>
<h1 style="text-align: center;">Lesson# 2/5 - ASP.NET Core and Middleware</h1>
<h2>[WHAT]</h2>
<ol>
<li>] by <a href="/view/person?id=257" target="_blank">Scott Hanselman</a>, Maria Naggaga @ microsoft Virtual Academy &nbsp;- &nbsp;Go from Console App to Web App, and get an introduction to how to create a new web app in Visual Studio, along with the command line, running applications in IIS and Kestrel, plus middleware.&nbsp;</li>
</ol>
<h2>[WHY]</h2>
<ol>
<li>] lesson-2-video-1 - ] default port, ] use static files, ] use directory browsing, ]&nbsp;</li>
<li>] lesson-2-video-2 - ] configuration, ] hosting environment,</li>
<li>] lesson-2-video-3 - ] what is a 'library' VS an 'application', ] how to create a library, ] how to use a library, &nbsp;] how to publish a library as nuget package,&nbsp;</li>
</ol>
<h2>[WHERE]</h2>
<ol>
<li><strong>] WATCH THE VIDEO</strong></li>
<ol>
<li>]&nbsp;<a href="https://mva.microsoft.com/en-US/training-courses/introduction-to-asp-net-core-1-0-16841" target="_blank">https://mva.microsoft.com/en-US/training-courses/introduction-to-asp-net-core-1-0-16841</a>&nbsp;?l=yCG2vdE6C_6406218965</li>
</ol></ol>
<h2>[WHEN]</h2>
<ol>
<li>] published: 2016-10-14</li>
<li>] summarized: 2017-01-26</li>
</ol>
<h2>[EXAMPLE]</h2>
<h1 style="text-align: center;">lesson# 2 [43:30] video - part 1</h1>
<div><ol>
<li><strong>[00:00] switching from: VSC to: VS community ( Free )</strong></li>
<ol>
<li>x] vs code only goes so far so we are moving to VS 2015-community&nbsp;</li>
<li>x] VS is the 1 IDE that you spend all your time in&nbsp;</li>
<li>x] has profiling, advance debugging, connectivity db, cloud,&nbsp;</li>
</ol>
<li><strong>[01:15] VS - &nbsp;file | new | project</strong></li>
<ol>
<li>] then select a "template" from the collection of templates</li>
<li>] selecting asp.net core, THEN selecting ] empty web, also have ] full web app and ] api</li>
<li>] when starting it automatically does dotnet restore to build project</li>
</ol>
<li><strong>[003:00] OR&nbsp;<strong>to generate a web app&nbsp;</strong>from the command line&nbsp;</strong></li>
<ol>
<li>] &gt; use dotnet new -t web&nbsp;</li>
<li>*] can also build other app types, using the the same method(), and more options coming with&nbsp;</li>
<li>x] this generates the same code as using file| new | project &nbsp;IN VS</li>
</ol>
<li><strong>[04:15] to run your application</strong></li>
<ol>
<li>] hit the "VCR button" in VS ide&nbsp;</li>
</ol>
<li><strong>[04:30] there are different options, here, when do i use them?</strong></li>
<ol>
<li>] different (web server) options (to choose from) including (iis, kestrel, iis express)&nbsp;</li>
</ol>
<li><strong>[05:00] iis VS &nbsp;kestrel&nbsp;</strong></li>
<ol>
<li>] kestrel is the xplatform option, works anywhere&nbsp;</li>
<li>] production V testing, iis can hand off/pass to kestrel, then kestrel to dotnet, can switch between iis/kestrel for your app, iis monitors kestrel, if it fails, can restart,&nbsp;</li>
</ol>
<li>&gt; [] IIS express -&nbsp;</li>
<li><strong>&gt; [13:00] switch default port of kestrel from 5000</strong></li>
<li>- launchsettings.json -&nbsp;</li>
<li><strong>[17:45] launch settings EDIT by right click app and click properties / debug&nbsp;</strong></li>
<li><strong>[18:00] serve basic html page</strong></li>
<li>- added file "index.html, to directory, try access via browser = FAIL&nbsp;</li>
<li>- its a buffet, start with an empty plate,&nbsp;</li>
<li><strong>[22:00]- used PM nuget to install msft pkg for handling static files</strong></li>
<li>&nbsp;- nuget?vs automatically adds line entry for {package} to your project json file</li>
<li>&nbsp;- pkg "static files" is a piece of "middleware", middleware sits between&nbsp;</li>
<li><strong>[25:00] - have to put UseStaticFiles() call above the original call // pipeline</strong></li>
<li>- have to put .html content files in /wwwroot directory&nbsp;</li>
<li>- ALT can UseFileServer - which auto serves up default files like index.</li>
<li><strong>[30:00] DEMO useDirectoryBrowser</strong></li>
<li>- ERROR dependancy on another service</li>
<li>- ADD service to configure services</li>
<li>- can check source on github</li>
<li>- asp.net now an "open book"&nbsp;</li>
<li><strong>[34:00] - you have complete and total power</strong></li>
<li>hosting evironment - development - (middleware )</li>
<li>why development&nbsp;</li>
<li>small company - dev - production</li>
<li>big company many states - dev - staging - testing - production</li>
<li>basics of environment, middleware, asp.net core&nbsp;</li>
<li>&nbsp;</li>
<li>ALT - install VS, use native templates from VS template options</li>
</ol>
<h1 style="text-align: center;">lesson# 2 [13:37] video - part 2 - configuration, DI, hosting environment</h1>
<ol>
<li><strong>[00:00] <span style="background-color: #ffff00;">configuration</span></strong></li>
<ol>
<li>] in the old days - we used "web.config", to hold data settings for our application, xml format</li>
<li>] + contained data about ... ] connection strings, ] assembly references, ] &nbsp;</li>
</ol>
<li><strong>[00:00] use nuget to add new nuget package&nbsp;</strong></li>
<ol>
<li>] adding package&nbsp;</li>
<li>] example used is .json, but could use .ini, .xmal or even create your own</li>
</ol>
<li><strong>[04:00] <span style="background-color: #ffff00;">build up your configuration</span>, just like you build up your application</strong></li>
<ol>
<li>] // inside class Startup</li>
<li><span style="background-color: #c0c0c0;">public IConfigurationRoot Configuration {get; set;}</span></li>
<li><span style="background-color: #c0c0c0;">{ configuration = new ConfigurationBuilder()</span></li>
<ol>
<li><span style="background-color: #c0c0c0;">&nbsp;.AddJsonFile("appSettings")</span></li>
<li><span style="background-color: #c0c0c0;">&nbsp;.Build();&nbsp;</span></li>
</ol>
<li><span style="background-color: #c0c0c0;">}</span></li>
</ol>
<li><strong>[07:00] PRB - the app doesn't find the "appSettings file", app&nbsp;</strong></li>
<ol>
<li>] cause - it doesnt know where to look&nbsp;</li>
<li>] solution - adding a line above 10.1,&nbsp;</li>
<li>] SetBasePath("pathTo/settingsFile.js") // NOPE, not a physical/logical path,&nbsp;</li>
<li><span style="background-color: #c0c0c0;">public IConfigurationRoot Configuration {get; set;}</span></li>
<li><span style="background-color: #c0c0c0;">{ configuration = new ConfigurationBuilder()</span></li>
<ol>
<li><span style="background-color: #c0c0c0;">.SetBasePath("env.ContentRootPath")&nbsp;</span></li>
<li><span style="background-color: #c0c0c0;">.AddJsonFile("appSettings")</span></li>
<li><span style="background-color: #c0c0c0;">&nbsp;.Build();&nbsp;</span></li>
</ol>
<li><span style="background-color: #c0c0c0;">}</span></li>
<li><span style="background-color: #ffffff;">] "env.something" is dependancy that we need, we are going to inject it (<strong>dependancy injection</strong> )</span></li>
<li><span style="background-color: #ffffff;">] adds arg to Startup class constructor, arg is IHostingEnvironment env</span></li>
<li><span style="background-color: #c0c0c0;">] Public Startup(IHostingEnvironment env);</span></li>
<li>] demo - passes message from appsettings config file into app hello world</li>
<li>] debug bonus - illustrate how you can drill into app settings at runtime</li>
</ol>
<li><strong>[12:00] summary</strong></li>
<ol>
<li>]&nbsp;</li>
<li>] resides in the Configuration variable that we created</li>
<li>] env, Configuration</li>
<li>] could make configs elsewhere</li>
<li>]&nbsp;</li>
</ol></ol>
<div>
<h1 style="text-align: center;">lesson# 2 [14:38] video - part 3 - libraries</h1>
<ol>
<li><strong>[00:00] asp.net core and middleware - lesson 2 video 3</strong></li>
<ol>
<li>] our projects /reference folder contains the packages/libraries that we have brought in using nuget package manager&nbsp;</li>
<li>*] getting deeper into using nuget in the intermediate course&nbsp;</li>
<li>] we are going to write our own new library and see if its any different then those we have imported from nuget</li>
<li>] using VS, choose&nbsp;</li>
<li>] is this the same as dotnet new -t lib&nbsp;</li>
<li>] mention of upcoming changes re: csproj VS project.json, (aka it will be the same after upcoming changes )</li>
</ol>
<li><strong>[02:00] looking at a library, library VS application</strong></li>
<ol>
<li>] note that in VS project folders browser - library and application appear differently - use different icons, different label .netCore app VS .netstandard library</li>
<li>] VS application - application has entry point, program.cs main, library has none</li>
<li><strong>] DEFINE library</strong> IS A collection of functions,methods, objects intended for reuse across multiple applications, there is no way to run it, no main, can have many libraries associated with 1 application, &nbsp;</li>
</ol>
<li><strong>[05:00] how it knows about src</strong></li>
<ol>
<li>] global json settings file</li>
</ol>
<li><strong>[05:30] write library code and implement it &nbsp;</strong></li>
<ol>
<li>] Class1 - added method to return string</li>
<li>] ADD a reference to: your application , to: your library</li>
<li>] HOW = right click, add reference, select "your Library" from list&nbsp;</li>
<li>*] this is a solution reference, NOT a package reference, a little bit confusing, effectively the same thing, different icons,&nbsp;</li>
<li>] order of preference - local folder, local machine, internet&nbsp;</li>
</ol>
<li><strong>[08:00] what if - no internet - IF pkg you want is&nbsp;</strong></li>
<ol>
<li>] machine has global nuget cache - \users\{user}\appData\Local\Nuget\Cache</li>
</ol>
<li><strong>[09:00] use library&nbsp;</strong></li>
<ol>
<li>] yourlibrary.yourClass.yourClassMethod()</li>
</ol>
<li><strong>[09:45] publish a library</strong></li>
<ol>
<li>] &gt; dotnet pack&nbsp;</li>
<li>] makes a nuget package file from your library code, it is a .zip file, contains the compiled exe code for your library, extension is .nupkg</li>
<li>] this file can then be published at nuget.org</li>
<li>] sign in with your msft account</li>
<li>] upload your package&nbsp;</li>
<li>] your package is then 1 of the thousands of publicly available packages that&nbsp;</li>
<li>] your nuget package can then be downloaded from the website or via the CLI tools&nbsp;</li>
</ol>
<li><strong>[00:00] what happens if you reference a library /package that doesn't exist</strong></li>
<ol>
<li>]&nbsp;</li>
</ol>
<li><strong>[13:30] how come my library has a default version of 1.0?</strong></li>
<ol>
<li>] versioning matters, look up semantic versioning, what is major minor build revisions,&nbsp;</li>
</ol>
<li>[]</li>
</ol>
<p>&nbsp;</p>
</div>
</div>
<h2>[HOW-TO]</h2>
<ol>
<li>]&nbsp;</li>
</ol>
<h2>[REFERENCE]</h2>
<ol>
<li>x] # 6839 -&nbsp;<a href="/view/task?id=6839" target="_blank">CREATE-article# 5555</a>&nbsp;-&nbsp;hm video @mva - intro .net core 1.0 # 1/5&nbsp;</li>
</ol>
<h2>[RELATED]</h2>
<div style="font-size: 10px; font-weight: normal;"><ol>
<li>] BOOK -&nbsp;<a href="/view/chapters?id=194" target="_blank">asp.net</a>&nbsp;- ] by Don Sagrott, founder @ sospep.com - notes on some of the fundamental components that make up MSFT's NET programming framework and how you can get started taking advantage of them to create your own .net applications</li>
</ol></div>
<h1 style="text-align: center;">&nbsp;</h1>

~ view article ~ Chapter] ch-301-introduction-to-asp-dotnet-core FROM [ Book] asp.net IN [ libraries] technology-developer-www