Шпаргалка по C#
Последнее обновление
Hello World и структура программы
Операторы верхнего уровня (с .NET 6) позволяют обойтись без шаблонного класса.
| Элемент | Код |
|---|---|
| Программа верхнего уровня | Console.WriteLine("Hello, World!"); |
| Импортировать пространство имён | using System; |
| Классическая точка входа | static void Main(string[] args) { ... } |
| Вывести строку | Console.WriteLine("text"); |
| Считать строку | string s = Console.ReadLine(); |
| Интерполяция строк | Console.WriteLine($"Hi {name}"); |
| Комментарии | // line и /* block */ |
Типы данных
| Тип | Описание |
|---|---|
int | 32-битное знаковое целое |
long | 64-битное знаковое целое |
double / float | Числа с плавающей точкой |
decimal | Десятичный тип высокой точности (деньги) |
bool | true или false |
char | Один символ Unicode |
string | Неизменяемый текст |
var | Компилятор выводит тип |
int? | Значимый тип, допускающий null |
Переменные
| Операция | Синтаксис |
|---|---|
| Объявить и инициализировать | int x = 5; |
| Вывод типа | var name = "Ada"; |
| Константа | const double Pi = 3.14159; |
| Поле только для чтения | readonly int id; |
| Ссылка, допускающая null | string? maybe = null; |
| Объединение с null | var y = maybe ?? "default"; |
| Условный доступ при null | int? len = text?.Length; |
Управление потоком
| Конструкция | Синтаксис |
|---|---|
| If / else | if (x > 0) { ... } else { ... } |
| Оператор switch | switch (n) { case 1: ...; break; default: ...; } |
| Switch-выражение | var s = n switch { 1 => "one", _ => "other" }; |
| Цикл while | while (i < n) { ... } |
| Цикл do-while | do { ... } while (i < n); |
| Цикл for | for (int i = 0; i < n; i++) { ... } |
| Цикл foreach | foreach (var item in list) { ... } |
| Break / continue | break; выходит из цикла, continue; переходит к следующей итерации |
Методы
| Операция | Синтаксис |
|---|---|
| Определить метод | int Add(int a, int b) { return a + b; } |
| С телом-выражением | int Add(int a, int b) => a + b; |
| Без возвращаемого значения | void Greet() { ... } |
| Необязательный параметр | int Pow(int b, int e = 2) { ... } |
| Именованные аргументы | Pow(b: 2, e: 3); |
| Out-параметр | bool TryParse(string s, out int n) { ... } |
| Статический метод | static int Square(int x) => x * x; |
| Лямбда-выражение | Func<int, int> f = x => x * 2; |
Классы и ООП
| Операция | Синтаксис |
|---|---|
| Определить класс | class Dog { ... } |
| Автосвойство | public string Name { get; set; } |
| Свойство только для чтения | public int Id { get; } |
| Конструктор | public Dog(string name) { Name = name; } |
| Создать объект | var d = new Dog("Rex"); |
| Наследование | class Puppy : Dog { ... } |
| Интерфейс | interface IRunnable { void Run(); } |
| Переопределить метод | public override void Speak() { ... } |
| Record (неизменяемый) | record Point(int X, int Y); |
Коллекции
Обобщённые коллекции из System.Collections.Generic.
| Тип | Применение и пример |
|---|---|
List<T> | Динамический массив: list.Add(1); list.Count; |
Dictionary<K, V> | Ключ-значение: dict["a"] = 1; dict.ContainsKey("a"); |
HashSet<T> | Уникальные значения: set.Add(5); set.Contains(5); |
Queue<T> | FIFO: q.Enqueue(x); q.Dequeue(); |
Stack<T> | LIFO: s.Push(x); s.Pop(); |
| Массив | int[] nums = { 1, 2, 3 }; |
| Инициализатор коллекции | var l = new List<int> { 1, 2, 3 }; |
| Обойти словарь | foreach (var kv in dict) { kv.Key; kv.Value; } |
LINQ
Удобные запросы к коллекциям; из System.Linq.
| Операция | Синтаксис |
|---|---|
| Фильтрация | nums.Where(n => n > 0) |
| Проекция / преобразование | nums.Select(n => n * 2) |
| Сортировка | nums.OrderBy(n => n) / OrderByDescending(...) |
| Первое совпадение | nums.First(n => n > 5) / FirstOrDefault(...) |
| Any / all | nums.Any(n => n < 0) / nums.All(n => n > 0) |
| Посчитать совпадения | nums.Count(n => n > 0) |
| Агрегация | nums.Sum(), nums.Max(), nums.Average() |
| Группировка | items.GroupBy(i => i.Category) |
| Материализация | .ToList() / .ToArray() |
Частые паттерны (свойства, async)
| Паттерн | Синтаксис |
|---|---|
| Асинхронный метод | async Task<int> GetAsync() { ... } |
| Ожидание задачи | var result = await GetAsync(); |
| Try / catch | try { ... } catch (Exception e) { ... } |
| Finally | finally { ... } выполняется всегда |
| Using (освобождение ресурса) | using var file = File.OpenRead(path); |
| Форматирование строк | $"Total: {amount:C}" |
| Обобщённый класс | class Box<T> { public T Value; } |
| Сопоставление с образцом | if (obj is Dog d) { d.Bark(); } |
Синтаксис C#, коллекции и запросы LINQ, которые нужны чаще всего, на одной странице. Эта шпаргалка по C# - быстрый справочник для написания кода на C#: типы данных, управление потоком, классы, коллекции List/Dictionary, LINQ, а также паттерны свойств и async, которые определяют идиоматичный код .NET.
Всё здесь - стандартный C# на .NET, запускаемый через CLI dotnet. Копируйте нужное или попробуйте любой фрагмент вживую в playground для C# - без установки SDK.
Часто задаваемые вопросы по шпаргалке C#
Эта шпаргалка по C# бесплатна?
В чём разница между значимыми и ссылочными типами в C#?
int, double, bool, struct, enum) хранят свои данные напрямую и копируются при присваивании или передаче в метод - изменение копии не затрагивает оригинал. Ссылочные типы (class, string, массивы, List<T>) хранят ссылку на данные в куче, поэтому две переменные могут указывать на один объект, и изменение через одну видно через другую. string - ссылочный тип, но ведёт себя как неизменяемый.Что такое LINQ и когда его использовать?
Where, Select и OrderBy, которые позволяют фильтровать, преобразовывать и агрегировать коллекции читаемыми цепочками вызовов вместо ручных циклов. Используйте его всякий раз, когда иначе вы написали бы цикл для построения отфильтрованного или преобразованного списка - это лаконично и вычисляется лениво, пока вы не вызовете ToList() или не начнёте перебор.