mirror of
https://github.com/dotnet/intro-to-dotnet-web-dev.git
synced 2025-12-06 05:32:03 +01:00
Jeffrey T. Fritz
GitHub
commit
8c667c5514
3
1-welcome/README.md
Normal file
3
1-welcome/README.md
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
# Welcome to the Intro to Web Dev with .NET series
|
||||
|
||||
Make sure you have [Visual Studio](https://visualstudio.microsoft.com/vs/features/net-development/) or [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/net/), as well as the [.NET 6 SDK](https://dotnet.microsoft.com/download).
|
||||
27
1-welcome/how-to-install-vs.md
Normal file
27
1-welcome/how-to-install-vs.md
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
# Install Visual Studio
|
||||
|
||||
## If you're on Windows
|
||||
1. Go to the [Develop .NET applications page](https://visualstudio.microsoft.com/vs/features/net-development/) of the Visual Studio website
|
||||
1. Find the "Download Visual Studio with .NET" dropdown and select "Community 2022"
|
||||
1. Run the exe and let Visual Studio download
|
||||
1. Wait for everything to install
|
||||
1. Sign in to Visual Studio
|
||||
1. Done ✔️
|
||||
|
||||
## If you're on Mac
|
||||
1. Go to the [Build Web Apps using .NET Core page](https://visualstudio.microsoft.com/vs/mac/net/) of the Visual Studio website
|
||||
1. Select the VisualStudioforMacInstaller.dmg to mount the installer, then run it by double-clicking the arrow logo
|
||||
2. Select **Open**
|
||||
1. An alert will appear asking you to acknowledge the privacy and license terms. Follow the links to read them, then press **Continue** if you agree
|
||||
1. The list of available workloads is displayed. Select the .NET Core component.
|
||||
1. Press **Install**
|
||||
1. Sign in and choose your keyboard preferences
|
||||
1. Done ✔️
|
||||
|
||||
## Want more help?
|
||||
If you want more detailed installation instructions, check out the Microsoft Documentation.
|
||||
* If you're on Windows, go to [Install Visual Studio](https://docs.microsoft.com/visualstudio/install/install-visual-studio?view=vs-2022)
|
||||
* If you're on Mac, go to [Install Visual Studio for Mac](https://docs.microsoft.com/visualstudio/mac/installation?view=vsmac-2019)
|
||||
|
||||
Check out the [Learn to code in Visual Studio](https://visualstudio.microsoft.com/vs/getting-started/) page to learn more about the installation process, how to get started with Visual Studio, and how to make it your own with themes! 🤗
|
||||
|
||||
246
2-csharp/README.md
Normal file
246
2-csharp/README.md
Normal file
|
|
@ -0,0 +1,246 @@
|
|||
# C# Crash Course 🚀
|
||||
|
||||
In this C# Crash Course, we'll go over the basics of C# so that you'll be ready to build out exciting web apps! We'll start by going through the key attributes of C#, syntax basics, and introduce you to OOP. In each section, we'll link you to some quick in-browser C# challenges so you can apply these concepts.
|
||||
|
||||
## Topics you'll learn
|
||||
|
||||
* Language attributes
|
||||
* Syntax basics
|
||||
* Object Oriented Programming
|
||||
|
||||
---
|
||||
|
||||
# Language attributes
|
||||
|
||||
C# is a strongly typed, compiled, object oriented language. Let's break this down.
|
||||
|
||||
## Strongly typed
|
||||
|
||||
In a **strongly typed** language, every variable has a defined type. Some of these types include:
|
||||
|
||||
* String, "Hello world!"
|
||||
* Char, 'a'
|
||||
* int, 3
|
||||
* decimal, 1.5
|
||||
* bool, True
|
||||
|
||||
## Compiler
|
||||
|
||||
A **compiler** converts the code you write into a format that your computer can understand. After you write C# and build it, the C# compiler (called Roslyn) will analyze your code to check for any errors.
|
||||
|
||||
---
|
||||
|
||||
# The basics
|
||||
|
||||
## 🌍 Hello World
|
||||
|
||||
Here's a piece of code that will print "Hello world!" to the console.
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
|
||||
Console.WriteLine("Hello world!");
|
||||
```
|
||||
|
||||
## Keywords
|
||||
|
||||
With C#, you use keywords like `using` and `Console`.
|
||||
**Keywords** are predefined, reserved identifiers that have special meanings to the compiler.
|
||||
|
||||
## Accessing methods
|
||||
|
||||
The `. (DOT)` in `Console.WriteLine` allows us to access methods and properties. In this example, `Console` is a type that represents the console window. `WriteLine` is a method of the Console type that prints a line of text to that text console.
|
||||
|
||||
## Parameters
|
||||
|
||||
In this example, we use parentheses pass a string as a parameter to `Console.WriteLine`.
|
||||
|
||||
## 🚨 Challenge 1
|
||||
|
||||
Time for your first challenge!
|
||||
|
||||
| # | Challenge | Solution | Duration | What you will learn | More information |
|
||||
|-| ------------------------------- | ------------------------------- | ----------- | -------------------------------------- | - |
|
||||
1 | [Hello World Challenge](https://docs.microsoft.com/learn/modules/csharp-write-first/2-exercise-hello-world/?ns-enrollment-type=learningpath&ns-enrollment-id=learn.languages.csharp-first-steps)| N/A | 3 min | case sensitive, strings, comments | [Intro to C# Tutorial](https://docs.microsoft.com/dotnet/csharp/tour-of-csharp/tutorials/hello-world?WT.mc_id=csharpnotebook-35129-website), [C# documentation](https://docs.microsoft.com/dotnet/csharp/) |
|
||||
|
||||
## Variables
|
||||
|
||||
In C#, **variables** allow you to temporarily store a value in memory. In C#, you must declare a variable before using it.
|
||||
|
||||
```csharp
|
||||
var cSharp = "really cool";
|
||||
```
|
||||
|
||||
In this example, we created a string called `cSharp`. You can use the var keyword to declare local variables without explicitly giving them a type.
|
||||
|
||||
Variable names can contain alphanumeric characters and underscores, but no special characters. They also cannot be keywords.
|
||||
|
||||
## 🚨 Challenge 2
|
||||
|
||||
| # | Challenge | Solution | Duration | What you will learn | More information |
|
||||
|-| ------------------------------- | ------------------------------- | ----------- | -------------------------------------- | - |
|
||||
2 | [Variables Challenge](https://docs.microsoft.com/learn/modules/csharp-literals-variables/6-challenge )|[Solution](https://docs.microsoft.com/learn/modules/csharp-literals-variables/7-solution)| 5 min | variables, data types, strings, ints, decimals | [String formatting tutorial](https://docs.microsoft.com/learn/modules/csharp-basic-formatting/), [C# documentation](https://docs.microsoft.com/dotnet/csharp/) |
|
||||
|
||||
# Syntax cheat sheet
|
||||
|
||||
## Semicolons
|
||||
|
||||
Every statement is ended by a semicolon
|
||||
|
||||
```csharp
|
||||
Console.WriteLine("there is a ';' at the end of this statement");
|
||||
```
|
||||
|
||||
## Comments
|
||||
|
||||
You can make comments by using 2 slashes
|
||||
|
||||
```csharp
|
||||
// this is a comment is C#
|
||||
```
|
||||
|
||||
## Case sensitive
|
||||
|
||||
C# is case sensitive! For example, a variable "cat" is completely different from a variable "CAT".
|
||||
|
||||
```csharp
|
||||
var cat = "meow";
|
||||
```
|
||||
|
||||
```csharp
|
||||
var CAT = "rawr";
|
||||
```
|
||||
|
||||
## Arithmetic Operators
|
||||
|
||||
These are probably familiar to you!
|
||||
| symbol | what it does |
|
||||
| --- | ------ |
|
||||
| + | addition |
|
||||
| - | subtraction |
|
||||
| * | multiplication |
|
||||
| / | division |
|
||||
| % | remainder |
|
||||
| ++ | increment |
|
||||
| -- | decrement |
|
||||
|
||||
## 🚨 Challenge 3
|
||||
|
||||
| # | Challenge | Solution | Duration | What you will learn | More information |
|
||||
|-| ------------------------------- | ------------------------------- | ----------- | -------------------------------------- | - |
|
||||
3 | [Operating on numbers challenge](https://docs.microsoft.com/learn/modules/csharp-basic-operations/5-challenge)|[Solution](https://docs.microsoft.com/learn/modules/csharp-basic-operations/6-solution)| 2 min | ints, decimals | [Number operations tutorial](https://docs.microsoft.com/learn/modules/csharp-basic-operations/), [C# documentation](https://docs.microsoft.com/dotnet/csharp/) |
|
||||
|
||||
## Decision logic
|
||||
|
||||
In C#, you can build applications that employ decision-making logic so that your application performs different instructions based on a set of conditions. One way we do this is with an `if` statement. `if` statements are made up of three parts:
|
||||
|
||||
* The if keyword
|
||||
* A Boolean expression between parenthesis ()
|
||||
* A code block defined by curly braces { }
|
||||
|
||||
If there are multiple condition, you can utilize the `else if` and `else` statements. Basically, if the `if` statement fails, these other statements allow you to test against other conditions.
|
||||
You can imagine this in the context of a rock⛰️-paper📃-scissors✂️ game. Imagine you chose rock⛰️.
|
||||
|
||||
* `if` your opponent chooses scissors✂️, then you will win
|
||||
* `else if` your opponent also chooses rock⛰️, then you will tie
|
||||
* `else` your opponent chooses paper📃, then you will lose
|
||||
|
||||
Each possible decision your opponent could make leads to a different outcome.
|
||||
|
||||
## Boolean expressions
|
||||
|
||||
Booleans are expressions that return either `true` or `false`. They are often used to compare two or more things.
|
||||
| symbol | what it does |
|
||||
| --- | ---------- |
|
||||
| < | less than |
|
||||
| > | greater than |
|
||||
| <= | less than or equal |
|
||||
| >= | greater than or equal |
|
||||
| == | equal |
|
||||
| != | not equal |
|
||||
|
||||
## 🚨 Challenge 4
|
||||
|
||||
| # | Challenge | Solution | Duration | What you will learn | More information |
|
||||
|-| ------------------------------- | ------------------------------- | ----------- | -------------------------------------- | - |
|
||||
4 | [Decision logic challenge](https://docs.microsoft.com/learn/modules/csharp-if-elseif-else/4-challenge)|[Solution](https://docs.microsoft.com/learn/modules/csharp-if-elseif-else/5-solution)| 2 min | if, else if, else, booleans | [Boolean expressions tutorial](https://docs.microsoft.com/learn/modules/csharp-evaluate-boolean-expressions/1-introduction), [C# documentation](https://docs.microsoft.com/dotnet/csharp/) |
|
||||
|
||||
---
|
||||
|
||||
# Object Oriented Programming
|
||||
|
||||
C# is an object-oriented language.
|
||||
Objects are defined by **Classes**. In other words, an **Object** is an instance of a class.
|
||||
One way to think about this is that a class is like the blue prints for a house. The actual house that is built is an objects because it is an instance of this blue print.
|
||||
|
||||
## Properties and methods
|
||||
|
||||
Objects inherently have attributes. In C# we call these **properties**. The attributes of a house may be the number of doors, what color the house is painted, etc.
|
||||
|
||||
We can also define **methods** which describe what an object can do. For example, you can sell your house.
|
||||
|
||||
To summarize these concepts using our house example,
|
||||
A Class is like a blueprint 📜
|
||||
An Object is an instance of this blueprint, or a house 🏠
|
||||
The Properties of a house could be the number of doors it has or the color it's painted 🚪 🎨
|
||||
A Method of our class is that we can sell our house 💸
|
||||
|
||||
Let's look at an example House class:
|
||||
|
||||
```csharp
|
||||
// The namespace declaration provides a way to logically organize your classes
|
||||
namespace Classes;
|
||||
|
||||
public class House
|
||||
{
|
||||
// House properties
|
||||
public string Address { get; }
|
||||
public int Size { get;}
|
||||
|
||||
// House methods
|
||||
public void SellHouse(decimal amount, DateTime date)
|
||||
{
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Constructor
|
||||
|
||||
We can define a **constructor** to allow us to create new House objects.
|
||||
|
||||
```csharp
|
||||
public House(string address, int squareFeet)
|
||||
{
|
||||
this.Address = address;
|
||||
this.Size = squareFeet;
|
||||
}
|
||||
```
|
||||
|
||||
When we create an object with `new` this constructor will be called.
|
||||
|
||||
```csharp
|
||||
using Classes;
|
||||
|
||||
// Let's create a 1500 square foot house on Candy Cane Lane
|
||||
var house = new House("123 Candy Cane Lane", 1500);
|
||||
```
|
||||
|
||||
## The .NET Class Library
|
||||
|
||||
C# also has built in classes and functionality within the .NET Class Library. The .NET Class Library is a collection of thousands of classes containing tens of thousands of methods. These methods are created by Microsoft and are available for use in your applications. For example, when we called `Console.WriteLine` earlier, we were calling a method from the `System.Console` class. For a more in-depth overview, you can read up on the .NET Class Library in the [.NET documentation](https://docs.microsoft.com/dotnet/standard/class-library-overview).
|
||||
|
||||
## 🚨 Challenge 5
|
||||
|
||||
| # | Challenge | Solution | Duration | What you will learn | More information |
|
||||
|-| ------------------------------- | ------------------------------- | ----------- | -------------------------------------- | - |
|
||||
5 | [.NET Class Library challenge](https://docs.microsoft.com/learn/modules/csharp-call-methods/5-challenge)|[Solution](https://docs.microsoft.com/learn/modules/csharp-call-methods/6-solution)| 2 min | ints, decimals | [.NET documentation](https://docs.microsoft.com/dotnet/standard/class-library-overview), [C# documentation](https://docs.microsoft.com/dotnet/csharp/) |
|
||||
|
||||
# Bonus and more ways to connect
|
||||
|
||||
Want more practice with C#? The .NET team has you covered. Here's a few learning resources:
|
||||
|
||||
* C# Video Series on [Microsoft Docs](https://docs.microsoft.com/shows/CSharp-101/?WT.mc_id=dotnet-35129-website) or [YouTube](https://www.youtube.com/watch?v=Z5JS36NlJiU)
|
||||
* Self Guided Tutorials on [Microsoft Learn](https://docs.microsoft.com/users/dotnet/collections/yz26f8y64n7k07)
|
||||
* [Learn to Code Page](https://dotnet.microsoft.com/learntocode)
|
||||
|
||||
Connect with us! Check out the [.NET Community Page](https://dotnet.microsoft.com/platform/community) to find links to our blogs, YouTube, Twitter, and more.
|
||||
|
|
@ -1,9 +1,5 @@
|
|||
# Microsoft Open Source Code of Conduct
|
||||
# Code of Conduct
|
||||
|
||||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
||||
|
||||
Resources:
|
||||
|
||||
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
|
||||
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
||||
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
|
||||
This project has adopted the code of conduct defined by the Contributor Covenant
|
||||
to clarify expected behavior in our community.
|
||||
For more information, see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct).
|
||||
|
|
|
|||
20
README.md
20
README.md
|
|
@ -1,3 +1,19 @@
|
|||
# Contributing
|
||||
## Intro to Web Development with .NET
|
||||
|
||||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
||||
Welcome to the Intro to Web Development with .NET GitHub repository!
|
||||
|
||||
Here, you'll find all of the projects and challenges associated with each email in the email series. Each email will have a dedicated folder containing all the relevant information for that week.
|
||||
|
||||
We are currently in the planning stages of this series!
|
||||
|
||||
|
||||
## .NET Foundation
|
||||
|
||||
.NET Interative Notebooks for C# is a [.NET Foundation](https://www.dotnetfoundation.org/projects) project.
|
||||
|
||||
There are many .NET related projects on GitHub.
|
||||
|
||||
- [.NET home repo](https://github.com/Microsoft/dotnet) - links to 100s of .NET projects, from Microsoft and the community.
|
||||
- [ASP.NET Core home](https://docs.microsoft.com/aspnet/core/) - the best place to start learning about ASP.NET Core.
|
||||
|
||||
This project has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/) to clarify expected behavior in our community. For more information, see the [.NET Foundation Code of Conduct](http://www.dotnetfoundation.org/code-of-conduct).
|
||||
|
|
|
|||
Loading…
Reference in a new issue