C#

CHEATSHEET C#

1. Data Types

Primitive Size Example

String 2 bytes/char s = “reference”;
bool b = true;
char 2 bytes ch = ‘a’;
byte 1 byte b = 0x78;
short 2 bytes val = 70;
int 4 bytes val = 700;
long 8 bytes val = 70;
float 4 bytes val = 70.0F;
double 8 bytes val = 70.0D;
decimal 16 bytes val = 70.0M;

2. Arrays

2.1 Declaration

//Initiliazed using a list defined with curly braces
int[] nameArray = {100, 101, 102};

//Define an empty array
int[] nameArray = new int[3]; // 3 rows and 2 columns

//To access a specific item in the array
int[] nameArray = new int[10];
int firstNumber = nameArray[0];
nameArray[1] = 20;

//Multidimensional arrays
int [,] matrix = new int [2,2]
matrix[0,0] = 1;
matrix[0,1] = 2;
matrix[1,0] = 3;
matrix[1,1] = 4;

int[,] predefinedMatrix = new int[2,2] { { 1, 2 }, { 3, 4 } };

2.2 Array Operations

//Sort ascending
Array.Sort(nameArray);

//Sort begins at element 6 and sorts 20 elements
Array.Sort(nameArray,6,20);

//Use 1 array as a key & sort 2 arrays
string[] values = {“Juan”, “Victor”, “Elena”};
string[] keys = {“Jimenez”, “Martin”, “Ortiz”};
Array.Sort(keys, values);

//Clear elements in array (array, first element, # elements)
Array.Clear(nameArray, 0, nameArray.Length);

//Copy elements from one array to another
Array.Copy(scr, target, numOfElements);

3. String Operations

//To concatenate between strings, use the plus operator:
string firstName = “Erin”;
string lastName = “Roger”;
string fullName = firstName + ” ” + lastName;

//To add one string to another, use the += operator:
string secondLastName = “Green”;
string fullName += secondLastName;

//ToString function
//It converts an object to its string representation so that it is suitable for display
Object.ToString();

//String formatting
//Each additional argument to the function can be referred to in the string using the brackets operator with the index number.
String.Format(String format, Object arg0);
format – A composite format string that includes one or more format items
arg0 – The first or only object to format

//Substring
//Returns a part of the string, beginning from the index specified as the argument. Substring also accepts a maximum length for the substring
String.Substring(beginAt);
String.Substring(beginAt, maximum);

//Replace
string newStr = oldStr.Replace(“old”,”new”);

//IndexOf
//Finds the first ocurrence of a string in a larger string
//Returns -1 if the string is not found
String.IndexOf(val, start, num)
val – string to search for
start – where to begin in string

//LastIndexOf
//Search from end of string

//Split
//Split is used to break delimited string into substrings
String.Split(Char[]);

//ToCharArray
//Places selected characteres in a string in a char array
String str = “AaBbCcDd”;
//create array of 8 vowels
var chars = str.ToCharArray();
//create array of ‘B’ and ‘C’
var chars = str.ToCharArray(2,2);

4. System.Text.StringBuilder

4.1 Constructor

StringBuilder sb = new StringBuilder();
StringBuilder sb = new StringBuilder(myString);
StringBuilder sb = new StringBuilder(myString, capacity);

myString – Initial value of StringBuilder object
capacity – Initial size of buffer

5. DateTime

5.1 DateTime Constructor

DateTime(year, month, day)
DateTime(year, month, day, hour, minute, second)

DateTime newYear = DateTime.Parse(“1/1/2018”):
DateTime currentDate = DateTime.Now;
DateTime nextYear = DateTime.AddYears(1);

6. TimeSpan

6.1 TimeSpan Constructor

TimpeSpan(hour, minute, sec)

TimeSpan timeS = new TimeSpan(10, 14, 50);
TimeSpan timeS_Hours = TimeSpan.FromDays(3640);

7. Formatting Values

Format item syntax: {index[,alignment][:format string]}
index – Specifies element in list of values to which format is applied
aligment – Indicates minimun width (in characters) to display value
format string – Contains the code which specififes the format of the displayed value

7.1 Numeric

Format Name Pattern Value Result
C or c Currency {0:C2}, 1000.1 $ 1000.1 A currency value
D or d Decimal {0:D5}, 30 00030 Integer digits with optional negative sign
E or e Exponential {0,9:E2}, 120.2 1.20+E002 Exponential notation
F or f Fixed-point {0,9:F2}, 120.2 120.2 Integral and decimal digits with optional negative sign
G or g General {0,9:G2}, 120.2 120.2 The more compact of either fixed-point or scientific notation
N or n Number {0,9:N1}, 1300.5 1,300,5 Integral and decimal digits, group separators, and a decimal separator with optional negative sign
P or p Percent {0,9:P3}, .0903 9.03% Number multiplied by 100 and displayed with a percent symbol
R or r Round-trip {0,9:R}, 3.1416 3.1316 A string that can round-trip to an identical number
X or x Hexadecimal {0,9:X4}, 31 001f A hexadecimal string

8. C# compiler at the Command Line

csc File.cs -> Compiles Files.cs producing File.exe
csc -target:library File.cs -> Compiles File.cs producing File.dll
csc -out:My.exe File.cs -> Compiles File.cs and creates My.exe
csc -define:DEBUG -optimize -out:File2.exe *.cs -> Compiles all the C# files in the current directory with optimizations enabled and defines the DEBUG symbol. The output is File2.exe
csc -target:library -out:File2.dll -warn:0 -nologo -debug *.cs -> Compiles all the C# files in the current directory producing a debug version of File2.dll. No logo and no warnings are displayed
csc -target:library -out:Something.xyz *.cs -> Compiles all the C# files in the current directory to Something.xyz (a DLL)

8.1 Compiler Options Listed

Option Purpose
@ Reads a response file for more options.
-? Displays a usage message to stdout.
-additionalfile Names additional files that don’t directly affect code generation but may be used by analyzers for producing errors or warnings.
-addmodule Links the specified modules into this assembly
-analyzer Run the analyzers from this assembly (Short form: -a)
-appconfig Specifies the location of app.config at assembly binding time.
-baseaddress Specifies the base address for the library to be built.
-bugreport Creates a ‘Bug Report’ file. This file will be sent together with any crash information if it is used with -errorreport:prompt or -errorreport:send.
-checked Causes the compiler to generate overflow checks.
-checksumalgorithm:<alg> Specifies the algorithm for calculating the source file checksum stored in PDB. Supported values are: SHA1 (default) or SHA256.
-codepage Specifies the codepage to use when opening source files.
-debug Emits debugging information.
-define Defines conditional compilation symbols.
-delaysign Delay-signs the assembly by using only the public part of the strong name key.
-deterministic Causes the compiler to output an assembly whose binary content is identical across compilations if inputs are identical.
-doc Specifies an XML Documentation file to generate.
-errorreport Specifies how to handle internal compiler errors: prompt, send, or none. The default is none.
-filealign Specifies the alignment used for output file sections.
-fullpaths Causes the compiler to generate fully qualified paths.
-help Displays a usage message to stdout.
-highentropyva Specifies that high entropy ASLR is supported.
-incremental Enables incremental compilation [obsolete].
-keycontainer Specifies a strong name key container.
-keyfile Specifies a strong name key file.
-langversion:<string> Specify language version: Default, ISO-1, ISO-2, 3, 4, 5, 6, 7, 7.1, 7.2, 7.3, or Latest
-lib Specifies additional directories in which to search for references.
-link Makes COM type information in specified assemblies available to the project.
-linkresource Links the specified resource to this assembly.
-main Specifies the type that contains the entry point (ignore all other possible entry points).
-moduleassemblyname Specifies an assembly whose non-public types a .netmodule can access.
-modulename:<string> Specify the name of the source module.
-noconfig Instructs the compiler not to auto include CSC.RSP file.
-nologo Suppresses compiler copyright message.
-nostdlib Instructs the compiler not to reference standard library (mscorlib.dll).
-nowarn Disables specific warning messages
-nowin32manifest Instructs the compiler not to embed an application manifest in the executable file.
-optimize Enables/disables optimizations.
-out Specifies the output file name (default: base name of file with main class or first file).
-parallel[+|-] Specifies whether to use concurrent build (+).
-pathmap Specifies a mapping for source path names output by the compiler.
-pdb Specifies the file name and location of the .pdb file.
-platform Limits which platforms this code can run on: x86, Itanium, x64, anycpu, or anycpu32bitpreferred. The default is anycpu.
-preferreduilang Specifies the language to be used for compiler output.
-publicsign Apply a public key without signing the assembly, but set the bit in the assembly indicating the assembly is signed.
-recurse Includes all files in the current directory and subdirectories according to the wildcard specifications.
-reference References metadata from the specified assembly files.
-refout Generate a reference assembly in addition to the primary assembly.
-refonly Generate a reference assembly instead of a primary assembly.
-resource Embeds the specified resource.
-ruleset:<file> Specify a ruleset file that disables specific diagnostics.
-subsystemversion Specifies the minimum version of the subsystem that the executable file can use.
-target Specifies the format of the output file by using one of four options: -target:appcontainerexe, -target:exe, -target:library, -target:module, -target:winexe, -target:winmdobj.
-unsafe Allows unsafe code.
-utf8output Outputs compiler messages in UTF-8 encoding.
-warn Sets the warning level (0-4).
-warnaserror Reports specific warnings as errors.
-win32icon Uses this icon for the output.
-win32manifest Specifies a custom win32 manifest file.
-win32res Specifies the win32 resource file (.res).

9. Control flow statements

9.1 Switch

switch (expression) {
//expression may be integer, string or enum
case expression:
//statements
break/ goto / return()

case ..
default
//statements
break/ goto / return()
}

9.2 If

if (condition) {
//statements
} else {
//statements
}

10. Loop

10.1 While

while (condition) {body}

10.2 Do while

do {body} while condition;

10.3 For

for (initializer; termination condition; iteration;) {
//statements
}

10.4 For each

foreach (type identifier in collection) {
//statements
}

11. Class Definition

11.1 Class

public | protected | internal | private
abstract | sealed | static

class className [:class/interfaces inherited from]

11.2 Constructor

[access modifier] className (parameters) [:initializer]

initializer -base calls constructor in base class.
this calls constuctor within class.

public class nameClass : Initializer {
public className(dataType param1 , dataType param2, …) : base(param1, param2)
{ constructor body }
}

11.3 Method

[access modifier]
static | virtual | override | new | sealed | abstract
methodName (parameter list) { body }

virtual – method can be overridden in subclass
override – overrides virtual method in base class
new – hides non-virtual method in base class
sealed – prevents derived class from inheriting
abstract – must be implemented by subclass

Passing parameters:
1. By default, parametres are passed by value
2. Passing by reference: ref, in and out modifers

To pass a parameter by reference with the intent of changing the value, use the ref, or out keyword. To pass by reference with the intent of avoiding copying but not changing the value, use the in modifier

11.4 Property

[modifier] <dataType> property name{
public string BrandName
{
get { return brandName; }
set { brandName = value; }
}
}

12. Struct

12.1 Defining a structure

[attribute][modifier] struct name [:interfaces] { struct-body }

12.2 Class vs Structure

-> Classes are reference types and structs are value types
-> Structures do not support inheritance
-> Structures cannot have default constructor

13. Enum

13.1 Declaring enum variable

enum <enumName> {
enumeration list
};

enumName – Specifies the enumeration type name
enumeration list is a comma-separated list of identifiers

//Each of the symbols in the enumeration list stands for an integer value, one greater than the symbol that precedes it.

14. Delegates

//A delegate is a reference type variable that holds the reference to a method. The reference can be changed at runtime.

14.1 Declaring delegates

//Delegate declaration determines the methods that can be referenced by the delegate.

delegate <return type> <delegate-name> <parameter list>

14.2 Instantiating delegates

//When creating a delegate, the argument passed to the new expression is written similar to a method call, but without the arguments to the method

public delegate void printString(string s);
printString ps1 = new printString(WriteToScreen);
printString ps2 = new printString(WriteToFile);

15. Events

15.1 Declaring events

//To declare an event inside a class, first a delegate type for the event must be declared.

public delegate string MyDelegate(string str);

//The event itself is declared by using the event keyword

event MyDelegate MyEvent;

15.2 Commonly used Control Events

Event Delegate

Click, MouseEnter, DoubleClick, MouseLeave EventHandler( object sender, EventArgs e)
MouseDown, Mouseup, MouseMove MouseEventHandler(object sender, MouseEventArgs e)
e.X, e.Y – x and y coordinates
e.Button – MouseButton.Left, Middle, Right
KeyUp, KeyDown KeyEventHandler(object sndr, KeyEventArgs e)
e.Handled – Indicates whether event is handled.
e.KeyCode – Keys enumeration, e.g., Keys.V
e.Modifiers – Indicates if Alt, Ctrl, or Shift key.
KeyPress KeyPressEventHandler(object sender, KeyPressEventArgs e)