Как правильно склеивать URL в C#? Аналог Path.Combine для веб-адресов

Использование класса Uri для безопасного комбинирования URL

В C# нет прямого аналога Path.Combine для URL, но есть мощный встроенный класс System.Uri, который решает эту задачу элегантно и безопасно. Он правильно обрабатывает слеши, схемы (http/https), порты и query-параметры.

Основной способ: конструктор Uri(Uri, string)

Самый простой метод — создать базовый URL как объект Uri и передать относительный путь вторым параметром:

using System;

string baseUrl = "https://api.example.com/v1/";
string endpoint = "users/123";

Uri baseUri = new Uri(baseUrl);
Uri fullUri = new Uri(baseUri, endpoint);

Console.WriteLine(fullUri.ToString());
// Вывод: https://api.example.com/v1/users/123

Этот метод автоматически:

• Убирает лишние слеши (если baseUrl заканчивается на "/", а endpoint начинается с "/", он не дублирует их).
• Использует правильные прямые слеши.
• Сохраняет query-параметры, если они есть в относительном пути.
• Работает с любыми протоколами (http, https, ftp и т.д.).

Работа с query-параметрами и фрагментами

Если вам нужно добавить query-параметры, используйте свойство Query или просто включите их в относительный путь:

string baseUrl = "https://api.example.com/v1/";
string endpoint = "users/123?page=2&limit=10";

Uri baseUri = new Uri(baseUrl);
Uri fullUri = new Uri(baseUri, endpoint);

Console.WriteLine(fullUri.ToString());
// Вывод: https://api.example.com/v1/users/123?page=2&limit=10

Использование UriBuilder для сложной сборки

Если вам нужно динамически менять схему, хост, порт или путь, используйте UriBuilder:

using System;

var builder = new UriBuilder("https", "api.example.com")
{
    Port = 443,
    Path = "/v1/users/123",
    Query = "page=2"
};

Uri result = builder.Uri;
Console.WriteLine(result.ToString());
// Вывод: https://api.example.com/v1/users/123?page=2

Метод расширения для удобства

Вы можете создать свой метод-расширение, чтобы писать код ещё короче:

public static class UriExtensions
{
    public static Uri Combine(this Uri baseUri, string relativePath)
    {
        return new Uri(baseUri, relativePath);
    }
}

// Использование:
Uri baseUri = new Uri("https://api.example.com/v1/");
Uri fullUri = baseUri.Combine("users/123");
Console.WriteLine(fullUri); // https://api.example.com/v1/users/123

Важные замечания

• Всегда используйте Uri вместо строковой конкатенации — это предотвращает ошибки с кодированием специальных символов (пробелы, кириллица и т.д.).
• Для абсолютных URL (схема + хост) обязательно передавайте их как Uri с конструктором, а не как строку.
• Если вам нужно просто объединить две строки без создания объекта Uri, можно использовать string.Join с правильным слешем: string result = string.Join("/", baseUrl.TrimEnd('/'), endpoint.TrimStart('/'));, но это менее надёжный способ.

string baseUrl = "https://api.example.com/v1/";
string endpoint = "/users/123";

string result = $"{baseUrl.TrimEnd('/')}/{endpoint.TrimStart('/')}";
Console.WriteLine(result);
// Вывод: https://api.example.com/v1/users/123

using Flurl;

string url = "https://api.example.com/v1/"
    .AppendPathSegment("users")
    .AppendPathSegment("123")
    .SetQueryParams(new { page = 2, limit = 10 });

Console.WriteLine(url);
// Вывод: https://api.example.com/v1/users/123?page=2&limit=10