Как закодировать и декодировать строку в Base64 на C#?

Правильное кодирование и декодирование Base64 в C#

Вы почти всё сделали правильно, но допустили типичную ошибку начинающих — попытались вызвать .ToString() на массиве байтов. Давайте разберём корректный подход шаг за шагом.

Базовая реализация

using System;
using System.Text;

class Program
{
    static void Main()
    {
        string original = "Привет, мир!";
        
        // Кодирование
        byte[] bytes = Encoding.UTF8.GetBytes(original);
        string encoded = Convert.ToBase64String(bytes);
        Console.WriteLine($"Закодировано: {encoded}");
        
        // Декодирование
        byte[] decodedBytes = Convert.FromBase64String(encoded);
        string decoded = Encoding.UTF8.GetString(decodedBytes);
        Console.WriteLine($"Декодировано: {decoded}");
    }
}

Объяснение ключевых моментов

• Encoding.UTF8 — используется для преобразования строки в массив байтов и обратно. UTF-8 поддерживает все символы Unicode, включая кириллицу.
• Convert.ToBase64String — принимает массив байтов и возвращает строку в формате Base64.
• Convert.FromBase64String — делает обратное преобразование: из строки Base64 в массив байтов.
• Encoding.UTF8.GetString — преобразует массив байтов обратно в читаемую строку.

Расширенный пример с обработкой ошибок

public static class Base64Helper
{
    public static string Encode(string plainText)
    {
        if (string.IsNullOrEmpty(plainText))
            return string.Empty;
        
        byte[] plainBytes = Encoding.UTF8.GetBytes(plainText);
        return Convert.ToBase64String(plainBytes);
    }
    
    public static string Decode(string base64EncodedData)
    {
        if (string.IsNullOrEmpty(base64EncodedData))
            return string.Empty;
        
        try
        {
            byte[] base64Bytes = Convert.FromBase64String(base64EncodedData);
            return Encoding.UTF8.GetString(base64Bytes);
        }
        catch (FormatException ex)
        {
            throw new ArgumentException("Некорректная строка Base64", ex);
        }
    }
}

// Использование:
string data = "Тестовая строка с кириллицей и спецсимволами: @#$%";
string encoded = Base64Helper.Encode(data);
string decoded = Base64Helper.Decode(encoded);
Console.WriteLine($"Исходная: {data}");
Console.WriteLine($"Закодированная: {encoded}");
Console.WriteLine($"Декодированная: {decoded}");

Подводные камни и рекомендации

1. Выбор кодировки: Всегда используйте Encoding.UTF8 для совместимости. Если вы закодировали с UTF-8, декодировать нужно тоже с UTF-8.
2. Символы в Base64: Строка Base64 содержит только символы A-Z, a-z, 0-9, +, / и = (для выравнивания). Это безопасно для URL, но для передачи в URL лучше использовать Base64UrlEncode.
3. Производительность: Для больших объёмов данных (мегабайты) рассмотрите использование FileStream и потокового чтения/записи.
4. Безопасность: Base64 — это не шифрование! Не используйте его для защиты конфиденциальных данных.
5. Проверка длины: Строка Base64 должна иметь длину, кратную 4. Если нет — добавьте символы '=' в конец.

URL-безопасный вариант

Для передачи в URL/JSON:

public static string Base64UrlEncode(string input)
{
    byte[] bytes = Encoding.UTF8.GetBytes(input);
    return Convert.ToBase64String(bytes)
        .Replace('+', '-')
        .Replace('/', '_')
        .TrimEnd('=');
}

public static string Base64UrlDecode(string input)
{
    string padded = input.Replace('-', '+').Replace('_', '/');
    switch (padded.Length % 4)
    {
        case 2: padded += "=="; break;
        case 3: padded += "="; break;
    }
    byte[] bytes = Convert.FromBase64String(padded);
    return Encoding.UTF8.GetString(bytes);
}

Теперь вы знаете всё необходимое для работы с Base64 в C#. Главное — помните про пару Encoding.UTF8 + Convert и не вызывайте .ToString() на массиве байтов!

using System;
using System.Buffers.Text;
using System.Text;

class Program
{
    static void Main()
    {
        string original = "Hello, World!";
        byte[] bytes = Encoding.UTF8.GetBytes(original);
        byte[] encodedBytes = new byte[Base64.GetMaxEncodedToUtf8Length(bytes.Length)];
        
        // Кодирование
        Base64.EncodeToUtf8(bytes, encodedBytes, out int bytesConsumed, out int bytesWritten);
        string encoded = Encoding.UTF8.GetString(encodedBytes, 0, bytesWritten);
        Console.WriteLine($"Encoded: {encoded}");
        
        // Декодирование
        byte[] decodedBytes = new byte[Base64.GetMaxDecodedFromUtf8Length(encodedBytes.Length)];
        Base64.DecodeFromUtf8(encodedBytes.AsSpan(0, bytesWritten), decodedBytes, out _, out int decodedWritten);
        string decoded = Encoding.UTF8.GetString(decodedBytes, 0, decodedWritten);
        Console.WriteLine($"Decoded: {decoded}");
    }
}