C# / .NET — платформа от Microsoft

# проверка установки
dotnet --version       # 8.0.x

# создание консольного приложения
dotnet new console -n HelloWorld
cd HelloWorld
dotnet run

using System; // современные шаблоны подключают нужное неявно

Console.WriteLine("Привет, мир!");

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>

# полезные команды
dotnet build            # только сборка
dotnet test             # запуск тестов
dotnet publish -c Release  # сборка для деплоя

string name = "Аня";
int age = 25;
double height = 1.72;
bool active = true;
decimal price = 4990.50m;   // m — префикс для decimal

// неявная типизация (тип выводится)
var city = "Москва";
var year = 2026;

// интерполяция строк
Console.WriteLine($"Привет, {name}! Тебе {age} лет.");

// var нельзя использовать без присваивания
// var x; // ошибка компиляции

// неизменяемое значение (объявляется в верхнем регистре)
const double Pi = 3.14159;

// преобразование типов: явное и через Parse
int x = 7;
double d = x;             // неявное расширение
int y = (int)d;           // явное сужение (отбросит дробь)
int n = int.Parse("42");  // строка → число (риск: исключение)

// безопасная попытка
bool ok = int.TryParse("не число", out int result); // ok = false

int score = 85;

if (score >= 90)
{
    Console.WriteLine("Отлично");
}
else if (score >= 60)
{
    Console.WriteLine("Хорошо");
}
else
{
    Console.WriteLine("Подтянись");
}

// switch
string day = "saturday";
switch (day)
{
    case "saturday":
    case "sunday":
        Console.WriteLine("Выходной");
        break;
    default:
        Console.WriteLine("Рабочий день");
        break;
}

// switch-выражение (свойство C# 8+)
string result = score switch
{
    >= 90 => "Отлично",
    >= 60 => "Хорошо",
    _     => "Подтянись"
};

// циклы
for (int i = 0; i < 5; i++)
{
    Console.WriteLine(i);
}

int n = 10;
while (n > 0)
{
    n--;
}

string[] names = { "Аня", "Боря", "Вера" };
foreach (var name in names)
{
    Console.WriteLine(name);
}

// break / continue для управления циклом
for (int i = 1; i <= 10; i++)
{
    if (i % 2 == 0) continue;
    if (i > 7) break;
    Console.WriteLine(i);  // 1 3 5 7
}

// метод возвращает int и принимает два int
static int Add(int a, int b)
{
    return a + b;
}

// без возвращаемого значения — void
static void Greet(string name, string prefix = "Привет")  // параметр по умолчанию
{
    Console.WriteLine($"{prefix}, {name}!");
}

// возврат нескольких значений (кортеж)
static (int sum, int count) Stats(int[] nums)
{
    int sum = 0;
    foreach (var n in nums) sum += n;
    return (sum, nums.Length);
}

Console.WriteLine(Add(2, 3));          // 5
Greet("Аня");                          // Привет, Аня!
Greet("Боря", "Здравствуйте");         // Здравствуйте, Боря!

var (sum, count) = Stats(new[] { 1, 2, 3 });
Console.WriteLine($"{sum} / {count}"); // 6 / 3

// перегрузка: одинаковое имя, разные параметры
static string Format(int value) => $"число {value}";
static string Format(string value) => "строка: " + value;

// математические помощники
static int Factorial(int n) => n <= 1 ? 1 : n * Factorial(n - 1);

static void Increment(ref int value) => value++;

int x = 5;
Increment(ref x);   // x становится 6

static void Split(string s, out string head, out string tail)
{
    head = s.Length > 1 ? s.Substring(0, 1) : "";
    tail = s.Length > 1 ? s.Substring(1) : s;
}

public class Product
{
    // автосвойства — удобные «обёртки» над полями
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int DiscoutPercent { get; set; }

    // вычисляемое свойство (только чтение)
    public decimal DiscountedPrice => Price * (1m - DiscoutPercent / 100m);

    // конструктор
    public Product(string name, decimal price)
    {
        Name = name;
        Price = price;
    }

    // метод
    public string Describe()
    {
        return $"{Name} ({Price:C})";
    }
}

var shoes = new Product("Кроссовки", 4990m);
Console.WriteLine(shoes.Describe());
Console.WriteLine(shoes.DiscountedPrice);

// наследование и virtual/override
public abstract class Shape          // абстрактный класс
{
    public abstract double Area();   // без реализации
}

public class Circle : Shape
{
    public double Radius { get; set; }

    public override double Area() => Math.PI * Radius * Radius;
}

var circle = new Circle { Radius = 2 };
Console.WriteLine($"{circle.Area():F2}");   // 12.57

// List — динамический массив
var products = new List<Product>
{
    new Product("Кроссовки", 4990m),
    new Product("Шапка", 990m),
    new Product("Куртка", 7990m),
};

products.Add(new Product("Носки", 300m));
products.RemoveAll(p => p.Price < 500);

// Dictionary — пары «ключ => значение»
var stock = new Dictionary<string, int>
{
    ["Кроссовки"] = 10,
    ["Шапка"] = 25,
};
stock["Куртка"] = 5;

Console.WriteLine(stock["Шапка"]);   // 25

// LINQ — работа с коллекциями (нужен using System.Linq)
var cheap = products
    .Where(p => p.Price < 5000)
    .OrderBy(p => p.Price)
    .Select(p => p.Name)
    .ToList();

foreach (var name in cheap)
{
    Console.WriteLine(name);
}

// множество полезных операций
bool anyCheap = products.Any(p => p.Price < 1000);
int count = products.Count();
decimal total = products.Sum(p => p.Price);
decimal avg = products.Average(p => p.Price);
var first = products.FirstOrDefault();   // null, если список пуст
var max = products.Max(p => p.Price);

using System.IO;

// запись и чтение текста
File.WriteAllText("log.txt", "Начало работы\n");
File.AppendAllText("log.txt", $"Событие в {DateTime.Now}\n");

string content = File.ReadAllText("log.txt");
Console.WriteLine(content);

// проверки
bool exists = File.Exists("log.txt");
File.Copy("log.txt", "log_backup.txt", overwrite: true);
File.Delete("log_backup.txt");

// работа с папками
Directory.CreateDirectory("data/2026");
string[] files = Directory.GetFiles("data");
foreach (string file in files)
{
    Console.WriteLine(file);
}

// работа с JSON (System.Text.Json)
using System.Text.Json;

var order = new Order { Id = 1, Total = 4990m };
string json = JsonSerializer.Serialize(order);
File.WriteAllText("order.json", json);

Order loaded = JsonSerializer.Deserialize<Order>(File.ReadAllText("order.json"));

public class Order
{
    public int Id { get; set; }
    public decimal Total { get; set; }
}

try
{
    var text = File.ReadAllText("config.json");
    Console.WriteLine(text);
}
catch (FileNotFoundException ex)
{
    Console.WriteLine("Конфиг не найден: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("Ошибка: " + ex.Message);
}

dotnet new webapi -n ShopApi
cd ShopApi
dotnet run

// Program.cs — минимальный API
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var products = new List<Product>
{
    new(1, "Кроссовки", 4990m),
    new(2, "Шапка", 990m),
};

app.MapGet("/products", () => products);

app.MapGet("/products/{id}", (int id) =>
    products.FirstOrDefault(p => p.Id == id) is { } product
        ? Results.Ok(product)
        : Results.NotFound());

app.MapPost("/products", (Product input) =>
{
    var id = products.Max(p => p.Id) + 1;
    products.Add(input with { Id = id });
    return Results.Created($"/products/{id}", input);
});

app.Run();

record Product(int Id, string Name, decimal Price);

# проверка
curl http://localhost:5XXX/products

# установка пакета
dotnet add package Dapper
dotnet add package Microsoft.EntityFrameworkCore.Sqlite
dotnet restore     # восстановление зависимостей проекта

// какой файл добавился в .csproj:
<PackageReference Include="Dapper" Version="2.1.35" />

# Dockerfile
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app
COPY . .
RUN dotnet publish -c Release -o out

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY --from=build /app/out .
EXPOSE 8080
ENTRYPOINT ["dotnet", "ShopApi.dll"]

docker build -t shop-api .
docker run -p 8080:8080 shop-api

public async Task<string> LoadAsync() {
    using var client = new HttpClient();
    return await client.GetStringAsync("https://api.example.com/data");
}

builder.Services.AddScoped<IOrderRepository, OrderRepository>();
builder.Services.AddTransient<IEmailer, SmtpEmailer>();
builder.Services.AddSingleton<ICache, RedisCache>();

public class OrderService {
    public OrderService(IOrderRepository repo, ILogger<OrderService> log) {
        _repo = repo; _log = log;   // зависимости приходят «извне»
    }
}

dotnet new xunit -o MyApp.Tests

public class CalculatorTests {
    [Fact]
    public void Add_ReturnsSum() {
        var calc = new Calculator();
        Assert.Equal(5, calc.Add(2, 3));
    }

    [Theory]
    [InlineData(0, 5)]
    [InlineData(-1, 5)]
    public void Add_Negatives_Work(int a, int b) {
        Assert.Equal(a + b, new Calculator().Add(a, b));
    }
}

dotnet publish -c Release -o /var/www/myapp

location / {
    proxy_pass http://127.0.0.1:5000;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

public record Order(int Id, decimal Total);

var o1 = new Order(1, 100m);
var o2 = o1 with { Total = 120m };   // копия с изменением

decimal Discount(Order o) => o switch

decimal Price(Order o) => o.Total > 1000 ? o.Total * 0.9m : o.Total;

Log.Information("Заказ {OrderId} на сумму {Amount}",
    order.Id, order.Total);

// appsettings.json
"Serilog": {
  "WriteTo": [{ "Name": "File", "Args": { "path": "logs/app-.log" } }]
}

dotnet-counters monitor -p 1234 --counters System.Runtime
dotnet-trace collect -p 1234 --profile gc-verbose

// из .csproj или команды
dotnet tool install --global dotnet-counters

dotnet list package --outdated
dotnet nuget update source

ReadOnlySpan<char> src = "2026:09:19".AsSpan();
var year  = src.Slice(0, 4);
var month = src.Slice(5, 2);   // без подстрок и мусора

// Dapper — SQL вручную: скорость и контроль
var users = connection.Query<User>(
   "SELECT * FROM users WHERE city = @city", new { city });

// EF: запросы без трекинга — меньше памяти
var items = ctx.Orders.AsNoTracking()
    .Where(o => o.Date > cutoff).ToList();

app.UseExceptionHandler(errApp => errApp.Run(async ctx =>
{
    var ex = ctx.Features.Get<IExceptionHandlerFeature>()?.Error;
    ctx.Response.StatusCode = 500;
    await ctx.Response.WriteAsJsonAsync(ProblemDetails(ex));
}));

// shadow-переключатель: оба пути работают, старый пишет в лог
if (featureFlags.NewEngine) return newImpl(r);
return legacyImpl(r);