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

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

Ваш код в целом верен для ASCII-строк, но есть нюансы, которые нужно учесть, особенно для Unicode и бинарных данных. Давайте разберём всё по порядку.

1. Основы: что такое Base64?

Base64 — это способ представления бинарных данных (байтов) в виде ASCII-строки. Каждые 3 байта (24 бита) кодируются в 4 символа из набора A-Z, a-z, 0-9, +, /. Это гарантирует, что данные не будут повреждены при передаче через каналы, которые поддерживают только текст (например, JSON, XML, HTTP-заголовки).

2. Кодирование строки в Base64

Для кодирования строки нужно сначала преобразовать её в массив байт с помощью кодировки (Encoding), а затем вызвать Convert.ToBase64String().

Важно: Если вы используете Encoding.ASCII для строк с Unicode символами (например, русскими буквами), вы потеряете данные, так как ASCII поддерживает только 127 символов. Правильный выбор — Encoding.UTF8, который поддерживает весь Unicode.

using System;
using System.Text;

string original = "Привет, мир!";
byte[] bytes = Encoding.UTF8.GetBytes(original);
string base64 = Convert.ToBase64String(bytes);
Console.WriteLine($"Закодированная строка: {base64}");
// Вывод: 0J/RgNC40LLQtdGCLCDQvNC40YAh

3. Декодирование Base64 обратно в строку

Декодирование — обратный процесс: сначала получаем массив байт из Base64 строки, затем преобразуем его в строку с помощью той же кодировки.

byte[] decodedBytes = Convert.FromBase64String(base64);
string decoded = Encoding.UTF8.GetString(decodedBytes);
Console.WriteLine($"Декодированная строка: {decoded}");
// Вывод: Привет, мир!

4. Работа с бинарными данными (изображения, файлы)

Для изображений и других файлов принцип тот же, только вместо строки вы работаете с массивом байт из файла или потока.

// Кодирование изображения в Base64
byte[] imageBytes = File.ReadAllBytes(@"C:\photo.jpg");
string imageBase64 = Convert.ToBase64String(imageBytes);

// Декодирование обратно в файл
byte[] restoredBytes = Convert.FromBase64String(imageBase64);
File.WriteAllBytes(@"C:\photo_copy.jpg", restoredBytes);

5. Важные подводные камни и рекомендации

• Кодировка: Всегда используйте Encoding.UTF8 для строк. Никогда не используйте Encoding.ASCII или Encoding.Default — это приведёт к потере данных.
• Производительность: Для больших данных (например, видео > 100 МБ) кодирование в Base64 может быть медленным и увеличивать размер данных на ~33%. Рассмотрите альтернативы (потоковая передача, сжатие).
• Безопасность: Base64 — это не шифрование! Любой может декодировать строку. Не используйте Base64 для защиты данных.
• URL-безопасный Base64: Для URL используйте Base64UrlEncoder из NuGet-пакета Microsoft.AspNetCore.WebUtilities или заменяйте символы + на -, / на _ и убирайте символы =.
• Обработка ошибок: При декодировании невалидной Base64 строки Convert.FromBase64String выбросит FormatException. Всегда оборачивайте вызов в try-catch.

6. Полный пример с обработкой ошибок

public static class Base64Helper
{
    public static string Encode(string plainText)
    {
        byte[] bytes = Encoding.UTF8.GetBytes(plainText);
        return Convert.ToBase64String(bytes);
    }

    public static string Decode(string base64Text)
    {
        try
        {
            byte[] bytes = Convert.FromBase64String(base64Text);
            return Encoding.UTF8.GetString(bytes);
        }
        catch (FormatException)
        {
            throw new ArgumentException("Строка не является корректной Base64.");
        }
    }

    public static string EncodeBytes(byte[] data)
    {
        return Convert.ToBase64String(data);
    }

    public static byte[] DecodeToBytes(string base64Text)
    {
        return Convert.FromBase64String(base64Text);
    }
}

Используйте эти методы для безопасного и корректного кодирования/декодирования.

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

string original = "Hello, World!";
byte[] sourceBytes = Encoding.UTF8.GetBytes(original);
int base64Length = ((sourceBytes.Length + 2) / 3) * 4; // расчёт длины
char[] buffer = new char[base64Length];

bool success = Convert.TryToBase64Chars(sourceBytes, buffer, out int charsWritten);
if (success)
{
    string base64 = new string(buffer, 0, charsWritten);
    Console.WriteLine(base64);
}

string base64 = "SGVsbG8sIFdvcmxkIQ==";
byte[] decodedBytes = new byte[base64.Length * 3 / 4]; // максимальный размер
bool success = Convert.TryFromBase64String(base64, decodedBytes, out int bytesWritten);
if (success)
{
    string decoded = Encoding.UTF8.GetString(decodedBytes, 0, bytesWritten);
    Console.WriteLine(decoded);
}