diff --git a/1-welcome/README.md b/1-welcome/README.md new file mode 100644 index 0000000..03fad50 --- /dev/null +++ b/1-welcome/README.md @@ -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). \ No newline at end of file diff --git a/1-welcome/how-to-install-vs.md b/1-welcome/how-to-install-vs.md new file mode 100644 index 0000000..c6e402e --- /dev/null +++ b/1-welcome/how-to-install-vs.md @@ -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! 🤗 + diff --git a/2-csharp/README.md b/2-csharp/README.md new file mode 100644 index 0000000..2b8f08d --- /dev/null +++ b/2-csharp/README.md @@ -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. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index f9ba8cf..0fd65e9 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -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). diff --git a/README.md b/README.md index 07cd509..f3b8e2c 100644 --- a/README.md +++ b/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).