Hazelsoft Learning Site

A non-profit site where you can learn useful technology stuff. By Hazael Mojica.

Session 1 - Web API with ASP.Net Core

26 May 2019

Session 1 - Introduction to C# and .Net Core

  1. What’s .Net Core
  2. Run a Hello World
  3. Variables
  4. Strings
  5. Common built-in data types in C#
  6. Arithmetic
  7. Decisions with if…else
  8. Loops
  9. Arrays and Lists
  10. Object Oriented Programming: Class and fields
  11. Methods
  12. Constructors
  13. Access Modifiers and Access Levels
  14. Instantiating Classes
  15. Inheritance
  16. Interfaces
  17. Abstract Classes
  18. Reference Types vs Value Types

What’s .Net Core

.NET Core is an open-source, general-purpose development platform maintained by Microsoft and the .NET community on GitHub. It’s cross-platform (supporting Windows, macOS, and Linux) and can be used to build device, cloud, and IoT applications.

.NET Core is an open-source, general-purpose development platform maintained by Microsoft and the .NET community on GitHub. It’s cross-platform (supporting Windows, macOS, and Linux) and can be used to build device, cloud, and IoT applications.

See About .NET Core to learn more about .NET Core, including its characteristics, supported languages and frameworks, and key APIs. Reference

.Net Core vs .Net Framework Image coming from here

Run a Hello World

You must already have installed .Net Core, see here for how to do it.

We will create a new Console project called HelloWorldApp and run it:

  mkdir HelloWorldApp
  cd HelloWorldApp
  dotnet new console
  dotnet run

Variables

A variable is the main object were to store values in the high level programming languages. A variable is a space in memory, the smaller size is 1 byte and it could be as large as needed. Variables allow us to store, manipulate and display data.

A variable is a symbol you can use to run the same code with different values.

string aFriend = "Bill";
Console.WriteLine(aFriend);

The first line declares a variable, aFriend and assigns it a value, “Bill”. The second line prints out the name. You can assign different values to any variable you declare. You can change the name to one of your friends.

aFriend = "Maira";
Console.WriteLine(aFriend);

Notice that the same line of code prints two different messages, based on the value stored in the aFriend variable. You may have also noticed that the word “Hello” was missing in the last two messages. Let’s fix that now. Modify the lines that print the message to the following:

Console.WriteLine("Hello " + aFriend);
Console.WriteLine($"Hello {aFriend}");

Reference

Strings

You’ve been using a method, Console.WriteLine, to print messages. A method is a block of code that implements some action. It has a name, so you can access it.

Suppose your strings have leading or trailing spaces that you don’t want to display. You want to trim the spaces from the strings. The Trim method and related methods TrimStart and TrimEnd do that work. You can just use those methods to remove leading and trailing spaces. Try the following code:

string greeting = "      Hello World!       ";
Console.WriteLine($"[{greeting}]");

string trimmedGreeting = greeting.TrimStart();
Console.WriteLine($"[{trimmedGreeting}]");

trimmedGreeting = greeting.TrimEnd();
Console.WriteLine($"[{trimmedGreeting}]");

trimmedGreeting = greeting.Trim();
Console.WriteLine($"[{trimmedGreeting}]");

Reference

The other part of a search and replace operation is to find text in a string. You can use the Contains method for searching. It tells you if a string contains a substring inside it. Try the following code to explore Contains:

string songLyrics = "You say goodbye, and I say hello";
Console.WriteLine(songLyrics.Contains("goodbye"));
Console.WriteLine(songLyrics.Contains("greetings"));

There are two similar methods, StartsWith and EndsWith that also search for sub-strings in a string. These find a substring at the beginning or the end of the string. Try to modify the previous sample to use StartsWith and EndsWith instead of Contains. Search for “You” or “goodbye” at the beginning of a string. Search for “hello” or “goodbye” at the end of a string.

Common built-in data types in C#

The following table shows the keywords for built-in C# types, which are aliases of predefined types in the namespace.

C# type .NET type
bool <xref:System.Boolean?displayProperty=nameWithType>
byte <xref:System.Byte?displayProperty=nameWithType>
sbyte <xref:System.SByte?displayProperty=nameWithType>
char <xref:System.Char?displayProperty=nameWithType>
decimal <xref:System.Decimal?displayProperty=nameWithType>
double <xref:System.Double?displayProperty=nameWithType>
float <xref:System.Single?displayProperty=nameWithType>
int <xref:System.Int32?displayProperty=nameWithType>
uint <xref:System.UInt32?displayProperty=nameWithType>
long <xref:System.Int64?displayProperty=nameWithType>
ulong <xref:System.UInt64?displayProperty=nameWithType>
object <xref:System.Object?displayProperty=nameWithType>
short <xref:System.Int16?displayProperty=nameWithType>
ushort <xref:System.UInt16?displayProperty=nameWithType>
string <xref:System.String?displayProperty=nameWithType>

Reference

Arithmetic

The C# language defines the precedence of different mathematics operations with rules consistent with the rules you learned in mathematics. Multiplication and division take precedence over addition and subtraction.

int a = 5;
int b = 4;
int c = 2;
int d = a + b * c;
Console.WriteLine(d);

The output demonstrates that the multiplication is performed before the addition. You can force a different order of operation by adding parentheses around the operation or operations you want performed first:

int a = 5;
int b = 4;
int c = 2;
int d = (a + b) * c;
Console.WriteLine(d);

Reference

Explore integer precision and limits

The C# integer type differs from mathematical integers in one other way: the int type has minimum and maximum limits. Run this code in the interactive window to see those limits:

int max = int.MaxValue;
int min = int.MinValue;
Console.WriteLine($"The range of integers is {min} to {max}");

If a calculation produces a value that exceeds those limits, you have an underflow or overflow condition. The answer appears to wrap from one limit to the other.

int what = max + 3;
Console.WriteLine($"An example of overflow: {what}");

Reference

Work with the double type

The double numeric type represents a double-precision floating point number. Those terms may be new to you. A floating point number is useful to represent non-integral numbers that may be very large or small in magnitude.

double a = 5;
double b = 4;
double c = 2;
double d = (a  + b) / c;
Console.WriteLine(d);

Reference

Decisions with if…else

As in any other programming language C# has if … else statements to branch the execution flow of the program and take decisions.

Because indentation is not significant, you need to use { and } to indicate when you want more than one statement to be part of the block that executes conditionally. C# programmers typically use those braces on all if and else clauses.

int a = 5;
int b = 3;
if (a + b > 10)
{
    Console.WriteLine("The answer is greater than 10");
}
else
{
    Console.WriteLine("The answer is not greater than 10");
}

You can test more complicated conditions:

int a = 5;
int b = 3;
int c = 4;
if ((a + b + c > 10) && (a == b))
{
    Console.WriteLine("The answer is greater than 10");
    Console.WriteLine("And the first number is equal to the second");
}
else
{
    Console.WriteLine("The answer is not greater than 10");
    Console.WriteLine("Or the first number is not equal to the second");
}

The == symbol tests for equality. Using == distinguishes the test for equality from assignment, which you saw in a = 5.

The && represents “and”. It means both conditions must be true to execute the statement in the true branch. These examples also show that you can have multiple statements in each conditional branch, provided you enclose them in { and }.

You can also use **   ** to represent “or”.

Reference

Loops

Another important concept to create larger programs is loops. You’ll use loops to repeat statements that you want executed more than once.

int counter = 0;
while (counter < 10)
{
  Console.WriteLine($"Hello World! The counter is {counter}");
  counter++;
}

The while statement checks a condition and executes the statement following the while. It will repeat checking the condition and executing those statements until the condition is false.

Another common loop statement that you’ll see in C# code is the for loop.

for(int counter = 0; counter < 10; counter++)
{
  Console.WriteLine($"Hello World! The counter is {counter}");
}

Reference

Arrays and Lists

Arrays You can store multiple variables of the same type in an array data structure.

type[] arrayName;

The following example creates single-dimensional, multidimensional, and jagged arrays:

class TestArraysClass
{
    static void Main()
    {
        // Declare a single-dimensional array
        int[] array1 = new int[5];

        // Declare and set array element values
        int[] array2 = new int[] { 1, 3, 5, 7, 9 };

        // Alternative syntax
        int[] array3 = { 1, 2, 3, 4, 5, 6 };

        // Declare a two dimensional array
        int[,] multiDimensionalArray1 = new int[2, 3];

        // Declare and set array element values
        int[,] multiDimensionalArray2 = { { 1, 2, 3 }, { 4, 5, 6 } };

        // Declare a jagged array
        int[][] jaggedArray = new int[6][];

        // Set the values of the first array in the jagged array structure
        jaggedArray[0] = new int[4] { 1, 2, 3, 4 };
    }
}

In C#, arrays are actually objects, and not just addressable regions of contiguous memory as in C and C++. Array is the abstract base type of all array types. You can use the properties, and other class members, that Array has. An example of this would be using the Length property to get the length of an array

int[] numbers = { 1, 2, 3, 4, 5 };
int lengthOfNumbers = numbers.Length;

Reference

Lists

Represents a strongly typed list of objects that can be accessed by index. Provides methods to search, sort, and manipulate lists.

The following example demonstrates how to add, remove, and insert a simple business object in a [List](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1?view=netcore-2.2).

List<string> fruits = new List<string>();
fruits.Add("apple");
fruits.Add("orange");
fruits.Add("pear");
Console.WriteLine(fruits[0]);
foreach(string fruit in fruits) {
  Console.WriteLine(fruit);
}

Reference

Object Oriented Programming: Classes and fields

C# provides full support for object-oriented programming including encapsulation, inheritance, and polymorphism.

Encapsulation means that a group of related properties, methods, and other members are treated as a single unit or object.

Inheritance describes the ability to create new classes based on an existing class.

Polymorphism means that you can have multiple classes that can be used interchangeably, even though each class implements the same properties or methods in different ways.

The terms class and object are sometimes used interchangeably, but in fact, classes describe the type of objects, while objects are usable instances of classes. So, the act of creating an object is called instantiation. Using the blueprint analogy, a class is a blueprint, and an object is a building made from that blueprint.

Class Object Instantiation.

To define a class:

class SampleClass
{
}

Properties and Fields Fields and properties represent information that an object contains. Fields are like variables because they can be read or set directly.

To define a field:

class SampleClass
{
    public string sampleField;
}

Properties have get and set procedures, which provide more control on how values are set or returned.

C# allows you either to create a private field for storing the property value or use so-called auto-implemented properties that create this field automatically behind the scenes and provide the basic logic for the property procedures.

To define an auto-implemented property:

class SampleClass
{
    public int SampleProperty { get; set; }
}

If you need to perform some additional operations for reading and writing the property value, define a field for storing the property value and provide the basic logic for storing and retrieving it:

class SampleClass
{
    private int _sample;
    public int Sample
    {
        // Return the value stored in a field.
        get { return _sample; }
        // Store the value in the field.
        set { _sample = value; }
    }
}

Methods

A method is an action that an object can perform.

To define a method of a class:

class SampleClass
{
    public int sampleMethod(string sampleParam)
    {
        // Insert code here
    }
}

A class can have several implementations, or overloads, of the same method that differ in the number of parameters or parameter types.

To overload a method:

public int sampleMethod(string sampleParam) {};
public int sampleMethod(int sampleParam) {}

Constructors

Constructors are class methods that are executed automatically when an object of a given type is created. Constructors usually initialize the data members of the new object. A constructor can run only once when a class is created. Furthermore, the code in the constructor always runs before any other code in a class. However, you can create multiple constructor overloads in the same way as for any other method.

To define a constructor for a class:

public class SampleClass
{
    public SampleClass()
    {
        // Add code here
    }
}

Access Modifiers and Access Levels

All classes and class members can specify what access level they provide to other classes by using access modifiers.

The following access modifiers are available: The following six accessibility levels can be specified using the access modifiers:

  • public: Access is not restricted.
  • protected: Access is limited to the containing class or types derived from the containing class.
  • internal: Access is limited to the current assembly.
  • protected internal: Access is limited to the current assembly or types derived from the containing class.
  • private: Access is limited to the containing type.
  • private protected: Access is limited to the containing class or types derived from the containing class within the current assembly.

Instantiating Classes

To create an object, you need to instantiate a class, or create a class instance.

SampleClass sampleObject = new SampleClass();

After instantiating a class, you can assign values to the instance’s properties and fields and invoke class methods.

// Set a property value.
sampleObject.sampleProperty = "Sample String";
// Call a method.
sampleObject.sampleMethod();

To assign values to properties during the class instantiation process, use object initializers:

// Set a property value.
SampleClass sampleObject = new SampleClass
    { FirstProperty = "A", SecondProperty = "B" };

Inheritance

Inheritance enables you to create a new class that reuses, extends, and modifies the behavior that is defined in another class. The class whose members are inherited is called the base class, and the class that inherits those members is called the derived class. However, all classes in C# implicitly inherit from the class that supports .NET class hierarchy and provides low-level services to all classes.

[!NOTE] C# doesn’t support multiple inheritance. That is, you can specify only one base class for a derived class.

To inherit from a base class:

class DerivedClass:BaseClass {}

Overriding Members

By default, a derived class inherits all members from its base class. If you want to change the behavior of the inherited member, you need to override it. That is, you can define a new implementation of the method, property or event in the derived class.

The following modifiers are used to control how properties and methods are overridden:

C# Modifier Definition
virtual Allows a class member to be overridden in a derived class.
override Overrides a virtual (overridable) member defined in the base class.
abstract Requires that a class member to be overridden in the derived class.
new Modifier Hides a member inherited from a base class

Interfaces

Interfaces, like classes, define a set of properties, methods, and events. But unlike classes, interfaces do not provide implementation. They are implemented by classes, and defined as separate entities from classes. An interface represents a contract, in that a class that implements an interface must implement every aspect of that interface exactly as it is defined.

To define an interface:

interface ISampleInterface
{
    void doSomething();
}

To implement an interface in a class:

class SampleClass : ISampleInterface
{
    void ISampleInterface.doSomething()
    {
        // Method implementation.
    }
}

For more information, see:

Interfaces

interface

Reference

Reference Types vs Value Types

There are two kinds of types in C#: value types and reference types. Variables of value types directly contain their data whereas variables of reference types store references to their data, the latter being known as objects. With reference types, it is possible for two variables to reference the same object and thus possible for operations on one variable to affect the object referenced by the other variable. With value types, the variables each have their own copy of the data, and it is not possible for operations on one to affect the other (except in the case of ref and out parameter variables).

Stack vs Heap

Stack is used for static memory allocation and Heap for dynamic memory allocation, both stored in the computer’s RAM .

Value types

//"Value Types" hold the actual value in the Stack
//They are statically created on compilation with a
//fixed size
1 int val1 = 10;
2 int val2 = val1;
3 val1 = 0;
4 int val3 = val2;
5 Console.WriteLine(
$"val1: {val1}, val2: {val2}, val3: {val3},");

Value Types

Reference types

//"Reference Types" are hold on the Heap
1 DummyClass dummy1 = new DummyClass();
2 DummyClass dummy2 = dummy1;
3 DummyClass dummy3 = new DummyClass();
4 dummy1.DummyProperty = "Hello";
5 dummy3.DummyProperty = "Hello";
if (dummy1 == dummy2) {
 Console.WriteLine("dummy1 & dummy2 point to the same object");
}
if (dummy1 == dummy3) {
 Console.WriteLine("dummy1 & dummy3 DO NOT point to the same object");
}


private class DummyClass {
 public string DummyProperty
  {get; set;}
}

Value Types

The Exception to the rule: The “string”

A String object is a reference typed object. But a string is special in C#, when comparing two string objects they are always compared as values.

1 string myString1 = "Hello";
2 string myString2 = "Hello";
3 if (myString1 == myString2) {
 Console.WriteLine("Both string are equals");
}

String are exceptions to the rule

Reference

Go to Session 2 —>