StockSharp/Ecng.Netv1.0.500

docs d<> code .compare c

.NET 10.0.NET 6.0

Ecng system framework

stocksharp.com ↗

License

View license

Deps

Install Size

—

Vulns

✓ 0

Published

Mar 3, 2026

Get Started

$ dotnet add package Ecng.Net

Readme

Ecng.Net

A comprehensive networking library providing essential utilities for working with HTTP, URLs, sockets, multicast, email, and retry policies in .NET applications.

Overview

Ecng.Net is a core networking helper library that simplifies common networking tasks including URL manipulation, HTTP client operations, socket management, multicast operations, email handling, and network path validation. The library is built on .NET Standard 2.0 and supports modern .NET versions including .NET 6.0 and .NET 10.0.

Installation

Add a reference to the Ecng.Net project or NuGet package in your application.

Key Features

URL Manipulation: Advanced URL parsing and query string management
HTTP Utilities: Headers, authentication schemas, and client extensions
Socket Operations: Enhanced socket methods including multicast support
Network Helpers: IP address validation, endpoint utilities, and path detection
Email Utilities: Email validation and mail message helpers
Retry Policies: Configurable retry logic with exponential backoff
OAuth Support: OAuth token management interfaces

Core Components

1. URL and Query String Management

The Url and QueryString classes provide powerful URL manipulation capabilities with fluent APIs.

Basic URL Usage

using Ecng.Net;

// Create a URL
var url = new Url("https://api.example.com/data");

// Create URL with base and relative parts
var apiUrl = new Url("https://api.example.com", "/v1/users");

// Clone URL with modifications
var modifiedUrl = url.Clone();
modifiedUrl.Encode = UrlEncodes.Upper; // Use uppercase encoding

Query String Operations

// Working with query strings
var url = new Url("https://api.example.com/search?q=test");

// Access query string
var queryString = url.QueryString;

// Add parameters
queryString.Append("page", 1)
           .Append("limit", 50)
           .Append("sort", "date");

// Get values
int page = queryString.GetValue<int>("page");
string sort = queryString.TryGetValue<string>("sort", "default");

// Check if parameter exists
if (queryString.Contains("q"))
{
    string query = queryString.GetValue<string>("q");
}

// Remove parameters
queryString.Remove("sort");

// Clear all parameters
queryString.Clear();

// Iterate over parameters
foreach (var kvp in queryString)
{
    Console.WriteLine($"{kvp.Key} = {kvp.Value}");
}

// Get raw query string
string rawQuery = queryString.Raw; // Returns "page=1&limit=50"

URL Encoding Options

var url = new Url("https://example.com/api");

// Control encoding behavior
url.Encode = UrlEncodes.None;   // No encoding
url.Encode = UrlEncodes.Lower;  // Lowercase encoding (default)
url.Encode = UrlEncodes.Upper;  // Uppercase encoding

// Keep default page in URL
url.KeepDefaultPage = true;

2. Network Helper Extensions

The NetworkHelper class provides numerous extension methods for common networking tasks.

Endpoint Operations

using System.Net;
using Ecng.Net;

// Check if endpoint is local
var endpoint = new IPEndPoint(IPAddress.Loopback, 8080);
bool isLocal = endpoint.IsLocal(); // true

var dnsEndpoint = new DnsEndPoint("localhost", 8080);
bool isDnsLocal = dnsEndpoint.IsLocal(); // true

// Check if endpoint IP is local
bool isLocalIp = endpoint.IsLocalIpAddress();

// Check if IP is loopback
IPAddress address = IPAddress.Parse("127.0.0.1");
bool isLoopback = address.IsLoopback(); // true

TCP Client Extensions

using System.Net.Sockets;
using Ecng.Net;

var client = new TcpClient();
var endpoint = new DnsEndPoint("api.example.com", 443);

// Async connection with cancellation token
await client.ConnectAsync(endpoint, cancellationToken);

SSL/TLS Stream Creation

using System.IO;
using System.Net.Security;
using System.Security.Authentication;
using Ecng.Net;

Stream networkStream = client.GetStream();

// Convert to SSL stream
var sslStream = networkStream.ToSsl(
    sslProtocol: SslProtocols.Tls12 | SslProtocols.Tls13,
    checkCertificateRevocation: true,
    validateRemoteCertificates: true,
    targetHost: "api.example.com",
    sslCertificate: null, // Optional client certificate path
    sslCertificatePassword: null
);

URL Encoding and Decoding

using Ecng.Net;

// URL encoding
string encoded = "Hello World!".EncodeUrl(); // "Hello+World%21"
string encodedUpper = "test@example".EncodeUrlUpper(); // Uses uppercase hex

// URL decoding
string decoded = "Hello+World%21".DecodeUrl(); // "Hello World!"

// HTML encoding
string htmlEncoded = "<div>Test</div>".EncodeToHtml(); // "&lt;div&gt;Test&lt;/div&gt;"
string htmlDecoded = htmlEncoded.DecodeFromHtml(); // "<div>Test</div>"

// Parse query strings
var parsed = "key1=value1&key2=value2".ParseUrl();

// XML escaping
string xmlSafe = "<tag>value</tag>".XmlEscape(); // "&lt;tag&gt;value&lt;/tag&gt;"

// URL-safe character checking
bool isSafe = '!'.IsUrlSafeChar(); // true
bool isNotSafe = '%'.IsUrlSafeChar(); // false

Encoding Extraction

using System.Text;
using Ecng.Net;

// Extract encoding from Content-Type header
string contentType = "text/html; charset=utf-8";
Encoding encoding = contentType.TryExtractEncoding(); // Returns UTF8 encoding

string noCharset = "application/json";
Encoding fallback = noCharset.TryExtractEncoding(); // Returns null

Query String Helpers

using Ecng.Net;

// Convert dictionary to query string
var parameters = new Dictionary<string, string>
{
    ["api_key"] = "12345",
    ["format"] = "json"
};
string queryString = parameters.ToQueryString(); // "api_key=12345&format=json"

// With URL encoding
var sensitiveParams = new Dictionary<string, string>
{
    ["email"] = "user@example.com",
    ["redirect"] = "https://example.com/callback"
};
string encoded = sensitiveParams.ToQueryString(encodeValue: true);

// Using tuples
var tupleParams = new[]
{
    ("name", "John Doe"),
    ("age", "30")
};
string fromTuples = tupleParams.ToQueryString(); // "name=John Doe&age=30"

3. Multicast Operations

The library provides enhanced multicast support for UDP sockets.

Basic Multicast

using System.Net;
using System.Net.Sockets;
using Ecng.Net;

var socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
var multicastAddress = IPAddress.Parse("239.255.0.1");

// Join multicast group
socket.JoinMulticast(multicastAddress);

// Leave multicast group
socket.LeaveMulticast(multicastAddress);

Source-Specific Multicast

using Ecng.Net;

// Configure source-specific multicast
var multicastConfig = new MulticastSourceAddress
{
    GroupAddress = IPAddress.Parse("239.255.0.1"),
    SourceAddress = IPAddress.Parse("192.168.1.100"),
    Port = 5000,
    IsEnabled = true
};

// Join with source filter
socket.JoinMulticast(multicastConfig);

// Leave source-specific multicast
socket.LeaveMulticast(multicastConfig);

4. HTTP Client Extensions

Convenient extensions for working with HttpClient.

User Agent Configuration

using System.Net.Http;
using Ecng.Net;

var httpClient = new HttpClient();

// Apply Chrome user agent
httpClient.ApplyChromeAgent();
// Sets: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36...

Bearer Token Authentication

using System.Security;
using Ecng.Net;

var httpClient = new HttpClient();
var token = new SecureString();
// ... populate token

// Set bearer authentication
httpClient.SetBearer(token);
// Adds header: Authorization: Bearer {token}

HTTP Headers Constants

using Ecng.Net;

// Use predefined header constants
httpClient.DefaultRequestHeaders.Add(HttpHeaders.UserAgent, "MyApp/1.0");
httpClient.DefaultRequestHeaders.Add(HttpHeaders.AcceptEncoding, "gzip, deflate");
httpClient.DefaultRequestHeaders.Add(HttpHeaders.CacheControl, "no-cache");

// Available constants:
// - Authorization
// - AcceptEncoding
// - AcceptLanguage
// - CacheControl
// - Connection
// - KeepAlive
// - LastModified
// - ProxyAuthenticate
// - ProxyAuthorization
// - ProxyConnection
// - UserAgent
// - Referer
// - WWWAuthenticate

5. Authentication Schemas

Helper methods for formatting authentication headers.

using System.Security;
using Ecng.Net;

// Bearer authentication
var bearerToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
string authHeader = AuthSchemas.Bearer.FormatAuth(bearerToken);
// Returns: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

// Basic authentication
var credentials = "username:password".UTF8().Base64();
string basicAuth = AuthSchemas.Basic.FormatAuth(credentials);
// Returns: "Basic dXNlcm5hbWU6cGFzc3dvcmQ="

// With SecureString
var secureToken = new SecureString();
// ... populate secure token
string secureAuth = AuthSchemas.Bearer.FormatAuth(secureToken);

6. OAuth Support

Interfaces for implementing OAuth authentication flows.

using Ecng.Net;

// Implement OAuth provider
public class MyOAuthProvider : IOAuthProvider
{
    public async Task<IOAuthToken> RequestToken(
        long socialId,
        bool isDemo,
        CancellationToken cancellationToken)
    {
        // Request token from OAuth server
        var token = await GetOAuthTokenAsync(socialId, isDemo);

        return new OAuthToken
        {
            Value = token.AccessToken,
            Expires = DateTime.UtcNow.AddSeconds(token.ExpiresIn)
        };
    }
}

// OAuth token implementation
public class OAuthToken : IOAuthToken
{
    public string Value { get; set; }
    public DateTime? Expires { get; set; }
}

7. Retry Policy with Exponential Backoff

Configure and execute retry logic for network operations.

using System.Net.Sockets;
using Ecng.Net;

// Configure retry policy
var retryPolicy = new RetryPolicyInfo
{
    ReadMaxCount = 5,        // Max retry attempts for reads
    WriteMaxCount = 3,       // Max retry attempts for writes
    InitialDelay = TimeSpan.FromSeconds(1),    // Initial delay
    MaxDelay = TimeSpan.FromSeconds(30)        // Maximum delay cap
};

// Configure which socket errors to retry
retryPolicy.Track.Clear();
retryPolicy.Track.Add(SocketError.TimedOut);
retryPolicy.Track.Add(SocketError.HostNotFound);
retryPolicy.Track.Add(SocketError.ConnectionRefused);

// Execute with retry logic
var result = await retryPolicy.TryRepeat(
    async (ct) =>
    {
        // Your async operation
        return await httpClient.GetStringAsync("https://api.example.com/data", ct);
    },
    maxCount: retryPolicy.ReadMaxCount,
    cancellationToken
);

// Retry delays use exponential backoff with jitter:
// Attempt 1: ~1s + jitter
// Attempt 2: ~2s + jitter
// Attempt 3: ~4s + jitter
// Attempt 4: ~8s + jitter
// Attempt 5: ~16s + jitter (capped at MaxDelay)

Manual Delay Calculation

var policy = new RetryPolicyInfo();

// Calculate delay for specific attempt
TimeSpan delay1 = policy.GetDelay(1); // ~1 second + jitter
TimeSpan delay2 = policy.GetDelay(2); // ~2 seconds + jitter
TimeSpan delay3 = policy.GetDelay(3); // ~4 seconds + jitter

8. Email Utilities

Helpers for working with email messages and SMTP.

Email Validation

using Ecng.Net;

// Validate email format
bool isValid = "user@example.com".IsEmailValid(); // true
bool isInvalid = "invalid.email".IsEmailValid();   // false

Email Message Extensions

using System.Net.Mail;
using Ecng.Net;

var message = new MailMessage
{
    From = new MailAddress("sender@example.com"),
    Subject = "Test Email",
    Body = "Plain text body"
};

message.To.Add("recipient@example.com");

// Add HTML body
message.AddHtml("<html><body><h1>Hello!</h1></body></html>");

// Add plain text alternative
message.AddPlain("Hello in plain text!");

// Attach files
using var fileStream = File.OpenRead("document.pdf");
message.Attach("document.pdf", fileStream);

// Send asynchronously (Note: Method is marked obsolete, use SmtpClient.SendMailAsync directly)
await message.SendAsync(cancellationToken);

Creating Attachments

using System.IO;
using System.Net.Mail;
using System.Net.Mime;
using Ecng.Net;

// Create attachment from stream
using var stream = new MemoryStream(fileBytes);
var attachment = MailHelper.ToAttachment("report.pdf", stream);

// Create attachment with custom encoding
var customAttachment = MailHelper.CreateAttachment(
    stream,
    "report.pdf",
    TransferEncoding.Base64
);

// Attach to message
message.Attachments.Add(attachment);

9. HTTP Status Code Utilities

Extract and work with HTTP status codes from exceptions.

using System.Net;
using System.Net.Http;
using Ecng.Net;

try
{
    await httpClient.GetAsync("https://api.example.com/resource");
}
catch (HttpRequestException ex)
{
    // Try to extract status code
    HttpStatusCode? statusCode = ex.TryGetStatusCode();

    if (statusCode == HttpStatusCode.NotFound)
    {
        Console.WriteLine("Resource not found");
    }
    else if (statusCode == HttpStatusCode.Unauthorized)
    {
        Console.WriteLine("Authentication required");
    }
}

// Create custom HTTP exceptions
var notFoundException = HttpStatusCode.NotFound.CreateHttpRequestException(
    "The requested resource was not found"
);

var unauthorizedException = HttpStatusCode.Unauthorized.CreateHttpRequestException(
    "Invalid API key"
);

// Customize status code phrases for better detection
NetworkHelper.SetStatusCodePhrase(HttpStatusCode.TooManyRequests, "rate limit");

10. Socket Error Handling

Extract socket errors from exceptions.

using System.Net.Sockets;
using Ecng.Net;

try
{
    // Network operation
    await socket.ConnectAsync(endpoint);
}
catch (Exception ex)
{
    // Extract socket error from exception chain
    SocketError? socketError = ex.TryGetSocketError();

    if (socketError == SocketError.TimedOut)
    {
        Console.WriteLine("Connection timed out");
    }
    else if (socketError == SocketError.ConnectionRefused)
    {
        Console.WriteLine("Connection refused by server");
    }
}

11. IP Address and Subnet Operations

Work with IP addresses and subnet calculations.

using System.Net;
using Ecng.Net;

var ipAddress = IPAddress.Parse("192.168.1.100");

// Check if IP is in subnet
bool isInSubnet = ipAddress.IsInSubnet("192.168.1.0/24"); // true
bool notInSubnet = ipAddress.IsInSubnet("10.0.0.0/8");    // false

// Works with IPv6
var ipv6 = IPAddress.Parse("2001:db8::1");
bool isInV6Subnet = ipv6.IsInSubnet("2001:db8::/32"); // true

12. Network Path Detection

Detect various types of network paths and addresses.

using Ecng.Net;

// UNC path detection
bool isUnc1 = @"\\server\share\file.txt".IsUncPath(); // true
bool isUnc2 = "//server/share/file.txt".IsUncPath();  // true

// URL path detection
bool isUrl1 = "https://example.com/path".IsUrlPath(); // true
bool isUrl2 = "http://example.com".IsUrlPath();       // true
bool isUrl3 = "ftp://ftp.example.com".IsUrlPath();    // true

// File URI detection
bool isFileUri = "file:///C:/path/to/file.txt".IsFileUriPath(); // true

// WebDAV path detection
bool isWebDav1 = "dav://server/path".IsWebDavPath();   // true
bool isWebDav2 = "davs://server/path".IsWebDavPath();  // true (secure)

// Host:port address detection
bool isHostPort1 = "127.0.0.1:8080".IsHostPortAddress();     // true
bool isHostPort2 = "localhost:5000".IsHostPortAddress();     // true
bool notHostPort = "C:\\folder".IsHostPortAddress();         // false (Windows path)

// General network path detection (checks all above)
bool isNetwork1 = @"\\server\share".IsNetworkPath();     // true
bool isNetwork2 = "https://example.com".IsNetworkPath(); // true
bool isNetwork3 = "localhost:8080".IsNetworkPath();      // true
bool isLocal = "C:\\local\\file.txt".IsNetworkPath();    // false

13. Image File Detection

Detect image files by extension.

using Ecng.Net;

// Check if file is an image
bool isPng = "photo.png".IsImage();     // true
bool isJpg = "picture.jpg".IsImage();   // true
bool isSvg = "icon.svg".IsImage();      // true
bool isWebP = "image.webp".IsImage();   // true
bool notImage = "document.pdf".IsImage(); // false

// Supported formats: .png, .jpg, .jpeg, .bmp, .gif, .svg,
//                   .webp, .ico, .tiff, .avif, .apng

// Check if file is a vector image
bool isVector = "icon.svg".IsImageVector();  // true
bool notVector = "photo.jpg".IsImageVector(); // false

14. URL Content Detection

Detect URLs in text content.

using Ecng.Net;

// Check if string contains URL patterns
bool hasUrl1 = "Check out https://example.com".CheckContainsUrl(); // true
bool hasUrl2 = "Visit http://site.com".CheckContainsUrl();         // true
bool hasUrl3 = "Link: ftp://files.com".CheckContainsUrl();        // true
bool hasUrl4 = "Click href=page.html".CheckContainsUrl();         // true
bool noUrl = "No URLs here".CheckContainsUrl();                    // false

// Check if Uri is localhost
var localhostUri = new Uri("http://localhost:8080");
bool isLocalhost = localhostUri.IsLocalhost(); // true

var remoteUri = new Uri("https://example.com");
bool notLocalhost = remoteUri.IsLocalhost(); // false

15. Gravatar Support

Generate Gravatar URLs from email addresses.

using Ecng.Net;

string email = "user@example.com";

// Get Gravatar token (MD5 hash of email)
string token = email.GetGravatarToken();
// Returns: "b58996c504c5638798eb6b511e6f49af"

// Get full Gravatar URL
string gravatarUrl = token.GetGravatarUrl(size: 200);
// Returns: "https://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af?size=200"

// Complete flow
string avatarUrl = email.GetGravatarToken().GetGravatarUrl(80);

16. URL Safety and Cleaning

Clean and validate URLs for safety.

using Ecng.Net;

// Check URL safety and clean
string unsafeUrl = "Тест URL with спец!@#chars%";
string safeUrl = unsafeUrl.CheckUrl(
    latin: true,   // Convert to Latin characters
    screen: true,  // Apply light screening
    clear: true    // Remove unsafe characters
);

// Individual operations
string cleared = "url%with*unsafe+chars".ClearUrl();
// Removes unsafe URL characters

// Convert to uppercase URL encoding
string upperEncoded = "test@example".UrlEncodeToUpperCase();

Advanced Examples

Complete HTTP Client with Retry Policy

using System.Net.Http;
using System.Net.Sockets;
using Ecng.Net;

public class ResilientHttpClient
{
    private readonly HttpClient _httpClient;
    private readonly RetryPolicyInfo _retryPolicy;

    public ResilientHttpClient()
    {
        _httpClient = new HttpClient();
        _httpClient.ApplyChromeAgent();

        _retryPolicy = new RetryPolicyInfo
        {
            ReadMaxCount = 5,
            InitialDelay = TimeSpan.FromSeconds(1),
            MaxDelay = TimeSpan.FromSeconds(30)
        };

        _retryPolicy.Track.Add(SocketError.TimedOut);
        _retryPolicy.Track.Add(SocketError.ConnectionReset);
    }

    public async Task<string> GetWithRetryAsync(
        string url,
        CancellationToken ct = default)
    {
        return await _retryPolicy.TryRepeat(
            async (token) =>
            {
                var response = await _httpClient.GetAsync(url, token);
                response.EnsureSuccessStatusCode();
                return await response.Content.ReadAsStringAsync();
            },
            maxCount: _retryPolicy.ReadMaxCount,
            cancellationToken: ct
        );
    }
}

// Usage
var client = new ResilientHttpClient();
var data = await client.GetWithRetryAsync("https://api.example.com/data");

Building API URLs with Query Parameters

using Ecng.Net;

public class ApiClient
{
    private readonly Url _baseUrl;

    public ApiClient(string apiBaseUrl)
    {
        _baseUrl = new Url(apiBaseUrl);
    }

    public string BuildSearchUrl(string query, int page, int pageSize, string sortBy)
    {
        var url = _baseUrl.Clone();
        url.QueryString
            .Append("q", query)
            .Append("page", page)
            .Append("pageSize", pageSize)
            .Append("sort", sortBy);

        return url.ToString();
    }

    public string BuildFilteredUrl(Dictionary<string, object> filters)
    {
        var url = _baseUrl.Clone();

        foreach (var filter in filters)
        {
            url.QueryString.Append(filter.Key, filter.Value);
        }

        return url.ToString();
    }
}

// Usage
var client = new ApiClient("https://api.example.com/search");
var searchUrl = client.BuildSearchUrl("stocks", 1, 20, "date");
// Returns: https://api.example.com/search?page=1&pageSize=20&q=stocks&sort=date

Multicast UDP Receiver

using System.Net;
using System.Net.Sockets;
using System.Text;
using Ecng.Net;

public class MulticastReceiver : IDisposable
{
    private readonly Socket _socket;
    private readonly MulticastSourceAddress _config;

    public MulticastReceiver(string groupAddress, string sourceAddress, int port)
    {
        _config = new MulticastSourceAddress
        {
            GroupAddress = IPAddress.Parse(groupAddress),
            SourceAddress = IPAddress.Parse(sourceAddress),
            Port = port,
            IsEnabled = true
        };

        _socket = new Socket(
            AddressFamily.InterNetwork,
            SocketType.Dgram,
            ProtocolType.Udp
        );

        _socket.SetSocketOption(
            SocketOptionLevel.Socket,
            SocketOptionName.ReuseAddress,
            true
        );

        _socket.Bind(new IPEndPoint(IPAddress.Any, _config.Port));
        _socket.JoinMulticast(_config);
    }

    public async Task<string> ReceiveAsync(CancellationToken ct = default)
    {
        var buffer = new byte[NetworkHelper.MtuSize];
        var received = await _socket.ReceiveAsync(buffer, SocketFlags.None, ct);
        return Encoding.UTF8.GetString(buffer, 0, received);
    }

    public void Dispose()
    {
        if (_config.IsEnabled)
        {
            _socket.LeaveMulticast(_config);
        }
        _socket.Dispose();
    }
}

// Usage
using var receiver = new MulticastReceiver("239.255.0.1", "192.168.1.100", 5000);
var message = await receiver.ReceiveAsync(cancellationToken);

Constants

Maximum Transmission Unit (MTU)

using Ecng.Net;

// Standard MTU size for network operations
int mtuSize = NetworkHelper.MtuSize; // 1600 bytes

Best Practices

URL Encoding: Always encode user input when building URLs to prevent injection attacks.
Retry Policies: Configure retry policies based on your network reliability requirements. Use exponential backoff to avoid overwhelming servers.
Cancellation Tokens: Always pass cancellation tokens to async operations for proper cleanup.
Resource Disposal: Dispose of sockets, HTTP clients, and mail messages properly using using statements.
Security: Use SecureString for sensitive tokens and credentials when possible.
Error Handling: Always catch and handle network exceptions appropriately. Use TryGetSocketError and TryGetStatusCode for detailed error information.
SSL/TLS: Always validate certificates in production environments. Only disable validation for testing purposes.
Multicast: Remember to leave multicast groups when done to free up system resources.

Dependencies

.NET Standard 2.0+
Ecng.ComponentModel
Newtonsoft.Json

Thread Safety

Most classes in this library are not thread-safe by default. When using from multiple threads:

Use proper synchronization for shared instances
Consider using thread-safe collections like SynchronizedSet where available
Create separate instances per thread when possible

Performance Considerations

Query String: Query strings are compiled and cached. Modifications trigger recompilation.
Retry Policy: Uses jitter to prevent thundering herd problems.
URL Encoding: Encoding operations allocate new strings. Cache results when possible.
Socket Operations: Reuse sockets when possible to avoid connection overhead.

Platform Support

.NET Standard 2.0
.NET 6.0
.NET 10.0
Cross-platform (Windows, Linux, macOS)

License

Part of the StockSharp/Ecng project. Please refer to the main project license for details.

Related Libraries

Ecng.Common: Core utilities and extensions
Ecng.Collections: Thread-safe collections
Ecng.ComponentModel: Component model utilities

Contributing

This library is part of the Ecng ecosystem. For contributions, please refer to the main project guidelines.

Support

For issues, questions, or contributions related to Ecng.Net, please visit the main project repository.

Total Downloads

4.3M

Compatibility

.NET 10.0

.NET 6.0

Versions

1.0.500Latest

Mar 3, 2026

Other versions (500)

1.0.499Feb 28, 2026

1.0.498Feb 25, 2026

1.0.497Feb 21, 2026

1.0.496Feb 10, 2026

1.0.495Feb 10, 2026

1.0.494Feb 10, 2026

1.0.493Feb 4, 2026

1.0.492Feb 4, 2026

1.0.491Feb 1, 2026

1.0.490Jan 26, 2026

1.0.489Jan 26, 2026

1.0.488Jan 22, 2026

1.0.487Jan 22, 2026

1.0.486Jan 21, 2026

1.0.485Jan 19, 2026

1.0.484Jan 19, 2026

1.0.483Jan 18, 2026

1.0.482Jan 18, 2026

1.0.481Jan 16, 2026

1.0.480Jan 14, 2026

1.0.479Jan 13, 2026

1.0.478Jan 13, 2026

1.0.477Jan 12, 2026

1.0.476Jan 9, 2026

1.0.475Jan 9, 2026

1.0.474Jan 8, 2026

1.0.473Jan 8, 2026

1.0.472Jan 7, 2026

1.0.471Jan 6, 2026

1.0.470Jan 6, 2026

1.0.469Jan 5, 2026

1.0.468Jan 4, 2026

1.0.467Jan 1, 2026

1.0.466Dec 31, 2025

1.0.465Dec 30, 2025

1.0.464Dec 30, 2025

1.0.463Dec 29, 2025

1.0.462Dec 29, 2025

1.0.461Dec 26, 2025

1.0.460Dec 26, 2025

1.0.459Dec 26, 2025

1.0.458Dec 26, 2025

1.0.457Dec 25, 2025

1.0.456Dec 25, 2025

1.0.455Dec 24, 2025

1.0.454Dec 23, 2025

1.0.453Dec 22, 2025

1.0.452Dec 21, 2025

1.0.451Dec 19, 2025

1.0.450Dec 19, 2025

1.0.449Dec 18, 2025

1.0.448Dec 17, 2025

1.0.447Dec 15, 2025

1.0.446Dec 15, 2025

1.0.445Dec 14, 2025

1.0.444Dec 14, 2025

1.0.443Dec 13, 2025

1.0.442Dec 13, 2025

1.0.441Dec 12, 2025

1.0.440Dec 12, 2025

1.0.439Dec 12, 2025

1.0.438Dec 12, 2025

1.0.437Dec 12, 2025

1.0.436Dec 12, 2025

1.0.435Dec 12, 2025

1.0.434Dec 2, 2025

1.0.433Dec 2, 2025

1.0.432Dec 2, 2025

1.0.431Nov 30, 2025

1.0.430Nov 29, 2025

1.0.429Nov 28, 2025

1.0.428Nov 28, 2025

1.0.427Nov 27, 2025

1.0.426Nov 24, 2025

1.0.425Nov 24, 2025

1.0.424Nov 23, 2025

1.0.423Nov 23, 2025

1.0.422Nov 22, 2025

1.0.421Nov 20, 2025

1.0.420Nov 18, 2025

1.0.419Nov 18, 2025

1.0.418Nov 13, 2025

1.0.417Nov 10, 2025

1.0.416Nov 1, 2025

1.0.415Oct 31, 2025

1.0.414Oct 28, 2025

1.0.413Oct 27, 2025

1.0.412Oct 27, 2025

1.0.411Oct 25, 2025

1.0.410Oct 24, 2025

1.0.409Oct 20, 2025

1.0.408Oct 12, 2025

1.0.407Oct 11, 2025

1.0.406Oct 7, 2025

1.0.405Oct 6, 2025

1.0.404Oct 3, 2025

1.0.403Oct 1, 2025

1.0.402Oct 1, 2025

1.0.401Sep 30, 2025

1.0.400Sep 28, 2025

1.0.399Sep 25, 2025

1.0.398Sep 5, 2025

1.0.397Sep 2, 2025

1.0.396Aug 30, 2025

1.0.395Aug 30, 2025

1.0.394Aug 20, 2025

1.0.393Aug 20, 2025

1.0.392Aug 19, 2025

1.0.391Aug 15, 2025

1.0.390Aug 10, 2025

1.0.389Jul 16, 2025

1.0.388Jul 14, 2025

1.0.387Jul 13, 2025

1.0.386Jul 13, 2025

1.0.385Jul 12, 2025

1.0.384Jul 8, 2025

1.0.383Jul 4, 2025

1.0.382Jul 2, 2025

1.0.381Jun 24, 2025

1.0.380Jun 16, 2025

1.0.379Jun 9, 2025

1.0.378Jun 8, 2025

1.0.377May 21, 2025

1.0.376May 21, 2025

1.0.375May 17, 2025

1.0.374May 12, 2025

1.0.373May 12, 2025

1.0.372May 12, 2025

1.0.371May 11, 2025

1.0.370May 11, 2025

1.0.369May 10, 2025

1.0.368May 10, 2025

1.0.367May 6, 2025

1.0.366May 3, 2025

1.0.365Apr 17, 2025

1.0.364Apr 15, 2025

1.0.363Apr 12, 2025

1.0.362Apr 9, 2025

1.0.361Apr 6, 2025

1.0.360Apr 5, 2025

1.0.359Mar 22, 2025

1.0.358Mar 20, 2025

1.0.357Mar 20, 2025

1.0.356Mar 19, 2025

1.0.355Feb 26, 2025

1.0.354Feb 26, 2025

1.0.353Feb 8, 2025

1.0.352Feb 8, 2025

1.0.351Feb 8, 2025

1.0.350Feb 6, 2025

1.0.349Feb 6, 2025

1.0.348Feb 6, 2025

1.0.347Feb 6, 2025

1.0.346Feb 6, 2025

1.0.345Feb 5, 2025

1.0.344Feb 5, 2025

1.0.343Feb 5, 2025

1.0.342Feb 3, 2025

1.0.341Feb 2, 2025

1.0.340Feb 1, 2025

1.0.339Jan 31, 2025

1.0.338Jan 30, 2025

1.0.337Jan 26, 2025

1.0.336Jan 21, 2025

1.0.335Jan 20, 2025

1.0.334Jan 20, 2025

1.0.333Jan 19, 2025

1.0.332Jan 19, 2025

1.0.331Jan 15, 2025

1.0.330Jan 15, 2025

1.0.329Jan 14, 2025

1.0.328Jan 12, 2025

1.0.327Jan 12, 2025

1.0.326Jan 12, 2025

1.0.325Jan 12, 2025

1.0.324Jan 10, 2025

1.0.323Dec 30, 2024

1.0.322Dec 27, 2024

1.0.321Dec 19, 2024

1.0.320Nov 20, 2024

1.0.319Nov 19, 2024

1.0.318Nov 19, 2024

1.0.317Nov 18, 2024

1.0.316Nov 7, 2024

1.0.315Oct 31, 2024

1.0.314Oct 19, 2024

1.0.313Oct 19, 2024

1.0.312Oct 13, 2024

1.0.311Oct 12, 2024

1.0.310Oct 9, 2024

1.0.309Oct 9, 2024

1.0.308Oct 5, 2024

1.0.307Sep 18, 2024

1.0.306Sep 18, 2024

1.0.305Sep 18, 2024

1.0.304Sep 17, 2024

1.0.303Sep 3, 2024

1.0.302Sep 1, 2024

1.0.301Aug 8, 2024

1.0.300Jul 23, 2024

1.0.299Jul 4, 2024

1.0.298Jun 12, 2024

1.0.297Jun 12, 2024

1.0.296Jun 12, 2024

1.0.295May 28, 2024

1.0.294May 4, 2024

1.0.293Apr 23, 2024

1.0.292Apr 21, 2024

1.0.291Apr 14, 2024

1.0.290Mar 28, 2024

1.0.289Mar 17, 2024

1.0.288Mar 9, 2024

1.0.287Feb 23, 2024

1.0.286Feb 23, 2024

1.0.285Feb 18, 2024

1.0.284Feb 18, 2024

1.0.283Feb 16, 2024

1.0.282Feb 13, 2024

1.0.281Feb 8, 2024

1.0.280Feb 5, 2024

1.0.279Feb 4, 2024

1.0.278Jan 23, 2024

1.0.277Jan 23, 2024

1.0.276Jan 12, 2024

1.0.275Jan 2, 2024

1.0.274Dec 29, 2023

1.0.273Dec 17, 2023

1.0.272Dec 15, 2023

1.0.271Dec 15, 2023

1.0.270Dec 15, 2023

1.0.269Dec 13, 2023

1.0.268Dec 13, 2023

1.0.267Dec 10, 2023

1.0.266Nov 18, 2023

1.0.265Nov 18, 2023

1.0.264Nov 18, 2023

1.0.263Nov 17, 2023

1.0.262Nov 12, 2023

1.0.261Nov 12, 2023

1.0.260Nov 10, 2023

1.0.259Nov 10, 2023

1.0.258Nov 9, 2023

1.0.257Nov 9, 2023

1.0.256Nov 9, 2023

1.0.255Nov 3, 2023

1.0.254Nov 1, 2023

1.0.253Nov 1, 2023

1.0.252Sep 8, 2023

1.0.251Sep 8, 2023

1.0.250Sep 3, 2023

1.0.249Aug 27, 2023

1.0.248Aug 24, 2023

1.0.247Aug 21, 2023

1.0.246Aug 15, 2023

1.0.245Aug 14, 2023

1.0.244Aug 14, 2023

1.0.243Aug 10, 2023

1.0.242Jul 29, 2023

1.0.241Jul 1, 2023

1.0.240Jun 29, 2023

1.0.239May 27, 2023

1.0.238May 21, 2023

1.0.237May 19, 2023

1.0.236May 8, 2023

1.0.235May 7, 2023

1.0.234May 1, 2023

1.0.233Apr 22, 2023

1.0.232Apr 21, 2023

1.0.231Apr 21, 2023

1.0.230Apr 13, 2023

1.0.229Apr 3, 2023

1.0.228Mar 27, 2023

1.0.227Mar 21, 2023

1.0.226Mar 17, 2023

1.0.225Mar 13, 2023

1.0.224Mar 6, 2023

1.0.223Feb 26, 2023

1.0.222Feb 21, 2023

1.0.221Feb 20, 2023

1.0.220Feb 16, 2023

1.0.219Feb 15, 2023

1.0.218Feb 14, 2023

1.0.217Feb 14, 2023

1.0.216Feb 9, 2023

1.0.215Feb 7, 2023

1.0.214Feb 4, 2023

1.0.213Feb 4, 2023

1.0.212Feb 3, 2023

1.0.211Feb 3, 2023

1.0.210Feb 2, 2023

1.0.209Jan 30, 2023

1.0.208Jan 30, 2023

1.0.207Jan 25, 2023

1.0.206Jan 23, 2023

1.0.205Jan 23, 2023

1.0.204Jan 18, 2023

1.0.203Jan 15, 2023

1.0.202Jan 6, 2023

1.0.201Jan 1, 2023

1.0.200Dec 31, 2022

1.0.199Dec 30, 2022

1.0.198Dec 29, 2022

1.0.197Dec 23, 2022

1.0.196Dec 12, 2022

1.0.195Dec 8, 2022

1.0.194Dec 4, 2022

1.0.193Dec 4, 2022

1.0.192Dec 2, 2022

1.0.191Nov 30, 2022

1.0.190Nov 29, 2022

1.0.189Nov 28, 2022

1.0.188Nov 26, 2022

1.0.187Nov 26, 2022

1.0.186Nov 25, 2022

1.0.185Nov 25, 2022

1.0.184Nov 18, 2022

1.0.183Nov 11, 2022

1.0.182Nov 11, 2022

1.0.181Nov 10, 2022

1.0.180Nov 5, 2022

1.0.179Nov 4, 2022

1.0.178Nov 2, 2022

1.0.177Nov 2, 2022

1.0.176Nov 1, 2022

1.0.175Oct 16, 2022

1.0.174Sep 25, 2022

1.0.173Sep 10, 2022

1.0.172Sep 8, 2022

1.0.171Sep 8, 2022

1.0.170Sep 8, 2022

1.0.169Sep 4, 2022

1.0.168Sep 4, 2022

1.0.167Aug 24, 2022

1.0.166Aug 8, 2022

1.0.165Aug 8, 2022

1.0.164Jul 26, 2022

1.0.163Jul 26, 2022

1.0.162Jul 21, 2022

1.0.161Jul 19, 2022

1.0.160Jul 18, 2022

1.0.159Jul 13, 2022

1.0.158Jul 8, 2022

1.0.157Jun 30, 2022

1.0.156Jun 20, 2022

1.0.155Jun 18, 2022

1.0.154Jun 6, 2022

1.0.153Apr 30, 2022

1.0.152Apr 20, 2022

1.0.151Apr 10, 2022

1.0.150Apr 7, 2022

1.0.149Apr 7, 2022

1.0.148Apr 2, 2022

1.0.147Mar 29, 2022

1.0.146Mar 27, 2022

1.0.145Mar 27, 2022

1.0.144Mar 24, 2022

1.0.143Feb 20, 2022

1.0.142Feb 20, 2022

1.0.141Feb 20, 2022

1.0.140Feb 20, 2022

1.0.139Feb 20, 2022

1.0.138Feb 20, 2022

1.0.137Feb 20, 2022

1.0.136Feb 20, 2022

1.0.135Feb 20, 2022

1.0.134Feb 19, 2022

1.0.133Feb 10, 2022

1.0.132Jan 27, 2022

1.0.131Jan 27, 2022

1.0.130Jan 24, 2022

1.0.129Jan 24, 2022

1.0.128Jan 23, 2022

1.0.127Dec 29, 2021

1.0.126Dec 27, 2021

1.0.125Dec 27, 2021

1.0.124Dec 27, 2021

1.0.123Dec 20, 2021

1.0.122Dec 17, 2021

1.0.121Dec 16, 2021

1.0.120Dec 15, 2021

1.0.119Dec 14, 2021

1.0.118Dec 14, 2021

1.0.117Dec 13, 2021

1.0.116Dec 12, 2021

1.0.115Dec 10, 2021

1.0.114Dec 7, 2021

1.0.113Dec 7, 2021

1.0.112Dec 6, 2021

1.0.111Dec 6, 2021

1.0.110Dec 5, 2021

1.0.109Dec 3, 2021

1.0.108Dec 3, 2021

1.0.107Dec 2, 2021

1.0.106Nov 29, 2021

1.0.105Nov 23, 2021

1.0.104Nov 23, 2021

1.0.103Nov 22, 2021

1.0.102Nov 17, 2021

1.0.101Nov 14, 2021

1.0.100Nov 13, 2021

1.0.99Nov 11, 2021

1.0.98Nov 11, 2021

1.0.97Nov 10, 2021

1.0.96Nov 9, 2021

1.0.95Nov 6, 2021

1.0.94Nov 6, 2021

1.0.93Nov 5, 2021

1.0.92Nov 5, 2021

1.0.91Nov 4, 2021

1.0.90Nov 4, 2021

1.0.89Nov 3, 2021

1.0.88Oct 30, 2021

1.0.87Oct 21, 2021

1.0.86Oct 17, 2021

1.0.85Oct 17, 2021

1.0.84Oct 14, 2021

1.0.83Oct 13, 2021

1.0.82Oct 13, 2021

1.0.81Oct 12, 2021

1.0.80Oct 11, 2021

1.0.79Oct 9, 2021

1.0.78Oct 7, 2021

1.0.77Oct 7, 2021

1.0.76Oct 7, 2021

1.0.75Oct 6, 2021

1.0.74Sep 28, 2021

1.0.73Sep 23, 2021

1.0.72Sep 11, 2021

1.0.71Sep 10, 2021

1.0.70Sep 9, 2021

1.0.69Sep 8, 2021

1.0.68Sep 8, 2021

1.0.67Sep 6, 2021

1.0.66Aug 31, 2021

1.0.65Aug 30, 2021

1.0.64Jul 31, 2021

1.0.63Jul 30, 2021

1.0.62Jul 26, 2021

1.0.61Jul 5, 2021

1.0.60Jul 1, 2021

1.0.59Jun 4, 2021

1.0.58Apr 26, 2021

1.0.57Apr 19, 2021

1.0.56Apr 8, 2021

1.0.55Apr 7, 2021

1.0.54Apr 7, 2021

1.0.53Apr 3, 2021

1.0.52Mar 22, 2021

1.0.51Mar 4, 2021

1.0.50Feb 26, 2021

1.0.49Feb 2, 2021

1.0.48Jan 26, 2021

1.0.47Jan 24, 2021

1.0.46Jan 24, 2021

1.0.45Jan 23, 2021

1.0.44Jan 20, 2021

1.0.43Jan 20, 2021

1.0.42Jan 18, 2021

1.0.41Jan 18, 2021

1.0.40Jan 16, 2021

1.0.39Dec 17, 2020

1.0.38Dec 16, 2020

1.0.37Dec 14, 2020

1.0.36Dec 9, 2020

1.0.35Dec 9, 2020

1.0.34Dec 7, 2020

1.0.33Dec 6, 2020

1.0.32Dec 2, 2020

1.0.31Dec 2, 2020

1.0.30Dec 1, 2020

1.0.29Nov 12, 2020

1.0.28Oct 11, 2020

1.0.27Sep 9, 2020

1.0.26Sep 3, 2020

1.0.25Aug 20, 2020

1.0.24Aug 9, 2020

1.0.23Jul 28, 2020

1.0.22Jul 19, 2020

1.0.21Jul 6, 2020

1.0.20Jun 6, 2020

1.0.19Jun 4, 2020

1.0.18May 29, 2020

1.0.17May 21, 2020

1.0.16May 17, 2020

1.0.15May 12, 2020

1.0.14May 4, 2020

1.0.13Apr 24, 2020

1.0.12Apr 22, 2020

1.0.11Apr 22, 2020

1.0.10Apr 21, 2020

1.0.9Apr 18, 2020

1.0.8Apr 16, 2020

1.0.7Apr 16, 2020

1.0.6Apr 15, 2020

1.0.5Apr 11, 2020

1.0.4Apr 3, 2020

1.0.3Apr 1, 2020

1.0.2Mar 27, 2020

1.0.1Mar 22, 2020

1.0.0Mar 22, 2020

Ecng.Net

A comprehensive networking library providing essential utilities for working with HTTP, URLs, sockets, multicast, email, and retry policies in .NET applications.

Overview

Installation

Add a reference to the Ecng.Net project or NuGet package in your application.

Key Features

URL Manipulation: Advanced URL parsing and query string management
HTTP Utilities: Headers, authentication schemas, and client extensions
Socket Operations: Enhanced socket methods including multicast support
Network Helpers: IP address validation, endpoint utilities, and path detection
Email Utilities: Email validation and mail message helpers
Retry Policies: Configurable retry logic with exponential backoff
OAuth Support: OAuth token management interfaces

Core Components

1. URL and Query String Management

The Url and QueryString classes provide powerful URL manipulation capabilities with fluent APIs.

Basic URL Usage

using Ecng.Net;

// Create a URL
var url = new Url("https://api.example.com/data");

// Create URL with base and relative parts
var apiUrl = new Url("https://api.example.com", "/v1/users");

// Clone URL with modifications
var modifiedUrl = url.Clone();
modifiedUrl.Encode = UrlEncodes.Upper; // Use uppercase encoding

Query String Operations

// Working with query strings
var url = new Url("https://api.example.com/search?q=test");

// Access query string
var queryString = url.QueryString;

// Add parameters
queryString.Append("page", 1)
           .Append("limit", 50)
           .Append("sort", "date");

// Get values
int page = queryString.GetValue<int>("page");
string sort = queryString.TryGetValue<string>("sort", "default");

// Check if parameter exists
if (queryString.Contains("q"))
{
    string query = queryString.GetValue<string>("q");
}

// Remove parameters
queryString.Remove("sort");

// Clear all parameters
queryString.Clear();

// Iterate over parameters
foreach (var kvp in queryString)
{
    Console.WriteLine($"{kvp.Key} = {kvp.Value}");
}

// Get raw query string
string rawQuery = queryString.Raw; // Returns "page=1&limit=50"

URL Encoding Options

var url = new Url("https://example.com/api");

// Control encoding behavior
url.Encode = UrlEncodes.None;   // No encoding
url.Encode = UrlEncodes.Lower;  // Lowercase encoding (default)
url.Encode = UrlEncodes.Upper;  // Uppercase encoding

// Keep default page in URL
url.KeepDefaultPage = true;

2. Network Helper Extensions

The NetworkHelper class provides numerous extension methods for common networking tasks.

Endpoint Operations

using System.Net;
using Ecng.Net;

// Check if endpoint is local
var endpoint = new IPEndPoint(IPAddress.Loopback, 8080);
bool isLocal = endpoint.IsLocal(); // true

var dnsEndpoint = new DnsEndPoint("localhost", 8080);
bool isDnsLocal = dnsEndpoint.IsLocal(); // true

// Check if endpoint IP is local
bool isLocalIp = endpoint.IsLocalIpAddress();

// Check if IP is loopback
IPAddress address = IPAddress.Parse("127.0.0.1");
bool isLoopback = address.IsLoopback(); // true

TCP Client Extensions

using System.Net.Sockets;
using Ecng.Net;

var client = new TcpClient();
var endpoint = new DnsEndPoint("api.example.com", 443);

// Async connection with cancellation token
await client.ConnectAsync(endpoint, cancellationToken);

SSL/TLS Stream Creation

using System.IO;
using System.Net.Security;
using System.Security.Authentication;
using Ecng.Net;

Stream networkStream = client.GetStream();

// Convert to SSL stream
var sslStream = networkStream.ToSsl(
    sslProtocol: SslProtocols.Tls12 | SslProtocols.Tls13,
    checkCertificateRevocation: true,
    validateRemoteCertificates: true,
    targetHost: "api.example.com",
    sslCertificate: null, // Optional client certificate path
    sslCertificatePassword: null
);

URL Encoding and Decoding

using Ecng.Net;

// URL encoding
string encoded = "Hello World!".EncodeUrl(); // "Hello+World%21"
string encodedUpper = "test@example".EncodeUrlUpper(); // Uses uppercase hex

// URL decoding
string decoded = "Hello+World%21".DecodeUrl(); // "Hello World!"

// HTML encoding
string htmlEncoded = "<div>Test</div>".EncodeToHtml(); // "&lt;div&gt;Test&lt;/div&gt;"
string htmlDecoded = htmlEncoded.DecodeFromHtml(); // "<div>Test</div>"

// Parse query strings
var parsed = "key1=value1&key2=value2".ParseUrl();

// XML escaping
string xmlSafe = "<tag>value</tag>".XmlEscape(); // "&lt;tag&gt;value&lt;/tag&gt;"

// URL-safe character checking
bool isSafe = '!'.IsUrlSafeChar(); // true
bool isNotSafe = '%'.IsUrlSafeChar(); // false

Encoding Extraction

using System.Text;
using Ecng.Net;

// Extract encoding from Content-Type header
string contentType = "text/html; charset=utf-8";
Encoding encoding = contentType.TryExtractEncoding(); // Returns UTF8 encoding

string noCharset = "application/json";
Encoding fallback = noCharset.TryExtractEncoding(); // Returns null

Query String Helpers

using Ecng.Net;

// Convert dictionary to query string
var parameters = new Dictionary<string, string>
{
    ["api_key"] = "12345",
    ["format"] = "json"
};
string queryString = parameters.ToQueryString(); // "api_key=12345&format=json"

// With URL encoding
var sensitiveParams = new Dictionary<string, string>
{
    ["email"] = "user@example.com",
    ["redirect"] = "https://example.com/callback"
};
string encoded = sensitiveParams.ToQueryString(encodeValue: true);

// Using tuples
var tupleParams = new[]
{
    ("name", "John Doe"),
    ("age", "30")
};
string fromTuples = tupleParams.ToQueryString(); // "name=John Doe&age=30"

3. Multicast Operations

The library provides enhanced multicast support for UDP sockets.

Basic Multicast

using System.Net;
using System.Net.Sockets;
using Ecng.Net;

var socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
var multicastAddress = IPAddress.Parse("239.255.0.1");

// Join multicast group
socket.JoinMulticast(multicastAddress);

// Leave multicast group
socket.LeaveMulticast(multicastAddress);

Source-Specific Multicast

using Ecng.Net;

// Configure source-specific multicast
var multicastConfig = new MulticastSourceAddress
{
    GroupAddress = IPAddress.Parse("239.255.0.1"),
    SourceAddress = IPAddress.Parse("192.168.1.100"),
    Port = 5000,
    IsEnabled = true
};

// Join with source filter
socket.JoinMulticast(multicastConfig);

// Leave source-specific multicast
socket.LeaveMulticast(multicastConfig);

4. HTTP Client Extensions

Convenient extensions for working with HttpClient.

User Agent Configuration

using System.Net.Http;
using Ecng.Net;

var httpClient = new HttpClient();

// Apply Chrome user agent
httpClient.ApplyChromeAgent();
// Sets: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36...

Bearer Token Authentication

using System.Security;
using Ecng.Net;

var httpClient = new HttpClient();
var token = new SecureString();
// ... populate token

// Set bearer authentication
httpClient.SetBearer(token);
// Adds header: Authorization: Bearer {token}

HTTP Headers Constants

using Ecng.Net;

// Use predefined header constants
httpClient.DefaultRequestHeaders.Add(HttpHeaders.UserAgent, "MyApp/1.0");
httpClient.DefaultRequestHeaders.Add(HttpHeaders.AcceptEncoding, "gzip, deflate");
httpClient.DefaultRequestHeaders.Add(HttpHeaders.CacheControl, "no-cache");

// Available constants:
// - Authorization
// - AcceptEncoding
// - AcceptLanguage
// - CacheControl
// - Connection
// - KeepAlive
// - LastModified
// - ProxyAuthenticate
// - ProxyAuthorization
// - ProxyConnection
// - UserAgent
// - Referer
// - WWWAuthenticate

5. Authentication Schemas

Helper methods for formatting authentication headers.

using System.Security;
using Ecng.Net;

// Bearer authentication
var bearerToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
string authHeader = AuthSchemas.Bearer.FormatAuth(bearerToken);
// Returns: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

// Basic authentication
var credentials = "username:password".UTF8().Base64();
string basicAuth = AuthSchemas.Basic.FormatAuth(credentials);
// Returns: "Basic dXNlcm5hbWU6cGFzc3dvcmQ="

// With SecureString
var secureToken = new SecureString();
// ... populate secure token
string secureAuth = AuthSchemas.Bearer.FormatAuth(secureToken);

6. OAuth Support

Interfaces for implementing OAuth authentication flows.

using Ecng.Net;

// Implement OAuth provider
public class MyOAuthProvider : IOAuthProvider
{
    public async Task<IOAuthToken> RequestToken(
        long socialId,
        bool isDemo,
        CancellationToken cancellationToken)
    {
        // Request token from OAuth server
        var token = await GetOAuthTokenAsync(socialId, isDemo);

        return new OAuthToken
        {
            Value = token.AccessToken,
            Expires = DateTime.UtcNow.AddSeconds(token.ExpiresIn)
        };
    }
}

// OAuth token implementation
public class OAuthToken : IOAuthToken
{
    public string Value { get; set; }
    public DateTime? Expires { get; set; }
}

7. Retry Policy with Exponential Backoff

Configure and execute retry logic for network operations.

using System.Net.Sockets;
using Ecng.Net;

// Configure retry policy
var retryPolicy = new RetryPolicyInfo
{
    ReadMaxCount = 5,        // Max retry attempts for reads
    WriteMaxCount = 3,       // Max retry attempts for writes
    InitialDelay = TimeSpan.FromSeconds(1),    // Initial delay
    MaxDelay = TimeSpan.FromSeconds(30)        // Maximum delay cap
};

// Configure which socket errors to retry
retryPolicy.Track.Clear();
retryPolicy.Track.Add(SocketError.TimedOut);
retryPolicy.Track.Add(SocketError.HostNotFound);
retryPolicy.Track.Add(SocketError.ConnectionRefused);

// Execute with retry logic
var result = await retryPolicy.TryRepeat(
    async (ct) =>
    {
        // Your async operation
        return await httpClient.GetStringAsync("https://api.example.com/data", ct);
    },
    maxCount: retryPolicy.ReadMaxCount,
    cancellationToken
);

// Retry delays use exponential backoff with jitter:
// Attempt 1: ~1s + jitter
// Attempt 2: ~2s + jitter
// Attempt 3: ~4s + jitter
// Attempt 4: ~8s + jitter
// Attempt 5: ~16s + jitter (capped at MaxDelay)

Manual Delay Calculation

var policy = new RetryPolicyInfo();

// Calculate delay for specific attempt
TimeSpan delay1 = policy.GetDelay(1); // ~1 second + jitter
TimeSpan delay2 = policy.GetDelay(2); // ~2 seconds + jitter
TimeSpan delay3 = policy.GetDelay(3); // ~4 seconds + jitter

8. Email Utilities

Helpers for working with email messages and SMTP.

Email Validation

using Ecng.Net;

// Validate email format
bool isValid = "user@example.com".IsEmailValid(); // true
bool isInvalid = "invalid.email".IsEmailValid();   // false

Email Message Extensions

using System.Net.Mail;
using Ecng.Net;

var message = new MailMessage
{
    From = new MailAddress("sender@example.com"),
    Subject = "Test Email",
    Body = "Plain text body"
};

message.To.Add("recipient@example.com");

// Add HTML body
message.AddHtml("<html><body><h1>Hello!</h1></body></html>");

// Add plain text alternative
message.AddPlain("Hello in plain text!");

// Attach files
using var fileStream = File.OpenRead("document.pdf");
message.Attach("document.pdf", fileStream);

// Send asynchronously (Note: Method is marked obsolete, use SmtpClient.SendMailAsync directly)
await message.SendAsync(cancellationToken);

Creating Attachments

using System.IO;
using System.Net.Mail;
using System.Net.Mime;
using Ecng.Net;

// Create attachment from stream
using var stream = new MemoryStream(fileBytes);
var attachment = MailHelper.ToAttachment("report.pdf", stream);

// Create attachment with custom encoding
var customAttachment = MailHelper.CreateAttachment(
    stream,
    "report.pdf",
    TransferEncoding.Base64
);

// Attach to message
message.Attachments.Add(attachment);

9. HTTP Status Code Utilities

Extract and work with HTTP status codes from exceptions.

using System.Net;
using System.Net.Http;
using Ecng.Net;

try
{
    await httpClient.GetAsync("https://api.example.com/resource");
}
catch (HttpRequestException ex)
{
    // Try to extract status code
    HttpStatusCode? statusCode = ex.TryGetStatusCode();

    if (statusCode == HttpStatusCode.NotFound)
    {
        Console.WriteLine("Resource not found");
    }
    else if (statusCode == HttpStatusCode.Unauthorized)
    {
        Console.WriteLine("Authentication required");
    }
}

// Create custom HTTP exceptions
var notFoundException = HttpStatusCode.NotFound.CreateHttpRequestException(
    "The requested resource was not found"
);

var unauthorizedException = HttpStatusCode.Unauthorized.CreateHttpRequestException(
    "Invalid API key"
);

// Customize status code phrases for better detection
NetworkHelper.SetStatusCodePhrase(HttpStatusCode.TooManyRequests, "rate limit");

10. Socket Error Handling

Extract socket errors from exceptions.

using System.Net.Sockets;
using Ecng.Net;

try
{
    // Network operation
    await socket.ConnectAsync(endpoint);
}
catch (Exception ex)
{
    // Extract socket error from exception chain
    SocketError? socketError = ex.TryGetSocketError();

    if (socketError == SocketError.TimedOut)
    {
        Console.WriteLine("Connection timed out");
    }
    else if (socketError == SocketError.ConnectionRefused)
    {
        Console.WriteLine("Connection refused by server");
    }
}

11. IP Address and Subnet Operations

Work with IP addresses and subnet calculations.

using System.Net;
using Ecng.Net;

var ipAddress = IPAddress.Parse("192.168.1.100");

// Check if IP is in subnet
bool isInSubnet = ipAddress.IsInSubnet("192.168.1.0/24"); // true
bool notInSubnet = ipAddress.IsInSubnet("10.0.0.0/8");    // false

// Works with IPv6
var ipv6 = IPAddress.Parse("2001:db8::1");
bool isInV6Subnet = ipv6.IsInSubnet("2001:db8::/32"); // true

12. Network Path Detection

Detect various types of network paths and addresses.

using Ecng.Net;

// UNC path detection
bool isUnc1 = @"\\server\share\file.txt".IsUncPath(); // true
bool isUnc2 = "//server/share/file.txt".IsUncPath();  // true

// URL path detection
bool isUrl1 = "https://example.com/path".IsUrlPath(); // true
bool isUrl2 = "http://example.com".IsUrlPath();       // true
bool isUrl3 = "ftp://ftp.example.com".IsUrlPath();    // true

// File URI detection
bool isFileUri = "file:///C:/path/to/file.txt".IsFileUriPath(); // true

// WebDAV path detection
bool isWebDav1 = "dav://server/path".IsWebDavPath();   // true
bool isWebDav2 = "davs://server/path".IsWebDavPath();  // true (secure)

// Host:port address detection
bool isHostPort1 = "127.0.0.1:8080".IsHostPortAddress();     // true
bool isHostPort2 = "localhost:5000".IsHostPortAddress();     // true
bool notHostPort = "C:\\folder".IsHostPortAddress();         // false (Windows path)

// General network path detection (checks all above)
bool isNetwork1 = @"\\server\share".IsNetworkPath();     // true
bool isNetwork2 = "https://example.com".IsNetworkPath(); // true
bool isNetwork3 = "localhost:8080".IsNetworkPath();      // true
bool isLocal = "C:\\local\\file.txt".IsNetworkPath();    // false

13. Image File Detection

Detect image files by extension.

using Ecng.Net;

// Check if file is an image
bool isPng = "photo.png".IsImage();     // true
bool isJpg = "picture.jpg".IsImage();   // true
bool isSvg = "icon.svg".IsImage();      // true
bool isWebP = "image.webp".IsImage();   // true
bool notImage = "document.pdf".IsImage(); // false

// Supported formats: .png, .jpg, .jpeg, .bmp, .gif, .svg,
//                   .webp, .ico, .tiff, .avif, .apng

// Check if file is a vector image
bool isVector = "icon.svg".IsImageVector();  // true
bool notVector = "photo.jpg".IsImageVector(); // false

14. URL Content Detection

Detect URLs in text content.

using Ecng.Net;

// Check if string contains URL patterns
bool hasUrl1 = "Check out https://example.com".CheckContainsUrl(); // true
bool hasUrl2 = "Visit http://site.com".CheckContainsUrl();         // true
bool hasUrl3 = "Link: ftp://files.com".CheckContainsUrl();        // true
bool hasUrl4 = "Click href=page.html".CheckContainsUrl();         // true
bool noUrl = "No URLs here".CheckContainsUrl();                    // false

// Check if Uri is localhost
var localhostUri = new Uri("http://localhost:8080");
bool isLocalhost = localhostUri.IsLocalhost(); // true

var remoteUri = new Uri("https://example.com");
bool notLocalhost = remoteUri.IsLocalhost(); // false

15. Gravatar Support

Generate Gravatar URLs from email addresses.

using Ecng.Net;

string email = "user@example.com";

// Get Gravatar token (MD5 hash of email)
string token = email.GetGravatarToken();
// Returns: "b58996c504c5638798eb6b511e6f49af"

// Get full Gravatar URL
string gravatarUrl = token.GetGravatarUrl(size: 200);
// Returns: "https://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af?size=200"

// Complete flow
string avatarUrl = email.GetGravatarToken().GetGravatarUrl(80);

16. URL Safety and Cleaning

Clean and validate URLs for safety.

using Ecng.Net;

// Check URL safety and clean
string unsafeUrl = "Тест URL with спец!@#chars%";
string safeUrl = unsafeUrl.CheckUrl(
    latin: true,   // Convert to Latin characters
    screen: true,  // Apply light screening
    clear: true    // Remove unsafe characters
);

// Individual operations
string cleared = "url%with*unsafe+chars".ClearUrl();
// Removes unsafe URL characters

// Convert to uppercase URL encoding
string upperEncoded = "test@example".UrlEncodeToUpperCase();

Advanced Examples

Complete HTTP Client with Retry Policy

using System.Net.Http;
using System.Net.Sockets;
using Ecng.Net;

public class ResilientHttpClient
{
    private readonly HttpClient _httpClient;
    private readonly RetryPolicyInfo _retryPolicy;

    public ResilientHttpClient()
    {
        _httpClient = new HttpClient();
        _httpClient.ApplyChromeAgent();

        _retryPolicy = new RetryPolicyInfo
        {
            ReadMaxCount = 5,
            InitialDelay = TimeSpan.FromSeconds(1),
            MaxDelay = TimeSpan.FromSeconds(30)
        };

        _retryPolicy.Track.Add(SocketError.TimedOut);
        _retryPolicy.Track.Add(SocketError.ConnectionReset);
    }

    public async Task<string> GetWithRetryAsync(
        string url,
        CancellationToken ct = default)
    {
        return await _retryPolicy.TryRepeat(
            async (token) =>
            {
                var response = await _httpClient.GetAsync(url, token);
                response.EnsureSuccessStatusCode();
                return await response.Content.ReadAsStringAsync();
            },
            maxCount: _retryPolicy.ReadMaxCount,
            cancellationToken: ct
        );
    }
}

// Usage
var client = new ResilientHttpClient();
var data = await client.GetWithRetryAsync("https://api.example.com/data");

Building API URLs with Query Parameters

using Ecng.Net;

public class ApiClient
{
    private readonly Url _baseUrl;

    public ApiClient(string apiBaseUrl)
    {
        _baseUrl = new Url(apiBaseUrl);
    }

    public string BuildSearchUrl(string query, int page, int pageSize, string sortBy)
    {
        var url = _baseUrl.Clone();
        url.QueryString
            .Append("q", query)
            .Append("page", page)
            .Append("pageSize", pageSize)
            .Append("sort", sortBy);

        return url.ToString();
    }

    public string BuildFilteredUrl(Dictionary<string, object> filters)
    {
        var url = _baseUrl.Clone();

        foreach (var filter in filters)
        {
            url.QueryString.Append(filter.Key, filter.Value);
        }

        return url.ToString();
    }
}

// Usage
var client = new ApiClient("https://api.example.com/search");
var searchUrl = client.BuildSearchUrl("stocks", 1, 20, "date");
// Returns: https://api.example.com/search?page=1&pageSize=20&q=stocks&sort=date

Multicast UDP Receiver

using System.Net;
using System.Net.Sockets;
using System.Text;
using Ecng.Net;

public class MulticastReceiver : IDisposable
{
    private readonly Socket _socket;
    private readonly MulticastSourceAddress _config;

    public MulticastReceiver(string groupAddress, string sourceAddress, int port)
    {
        _config = new MulticastSourceAddress
        {
            GroupAddress = IPAddress.Parse(groupAddress),
            SourceAddress = IPAddress.Parse(sourceAddress),
            Port = port,
            IsEnabled = true
        };

        _socket = new Socket(
            AddressFamily.InterNetwork,
            SocketType.Dgram,
            ProtocolType.Udp
        );

        _socket.SetSocketOption(
            SocketOptionLevel.Socket,
            SocketOptionName.ReuseAddress,
            true
        );

        _socket.Bind(new IPEndPoint(IPAddress.Any, _config.Port));
        _socket.JoinMulticast(_config);
    }

    public async Task<string> ReceiveAsync(CancellationToken ct = default)
    {
        var buffer = new byte[NetworkHelper.MtuSize];
        var received = await _socket.ReceiveAsync(buffer, SocketFlags.None, ct);
        return Encoding.UTF8.GetString(buffer, 0, received);
    }

    public void Dispose()
    {
        if (_config.IsEnabled)
        {
            _socket.LeaveMulticast(_config);
        }
        _socket.Dispose();
    }
}

// Usage
using var receiver = new MulticastReceiver("239.255.0.1", "192.168.1.100", 5000);
var message = await receiver.ReceiveAsync(cancellationToken);

Constants

Maximum Transmission Unit (MTU)

using Ecng.Net;

// Standard MTU size for network operations
int mtuSize = NetworkHelper.MtuSize; // 1600 bytes

Best Practices

URL Encoding: Always encode user input when building URLs to prevent injection attacks.
Retry Policies: Configure retry policies based on your network reliability requirements. Use exponential backoff to avoid overwhelming servers.
Cancellation Tokens: Always pass cancellation tokens to async operations for proper cleanup.
Resource Disposal: Dispose of sockets, HTTP clients, and mail messages properly using using statements.
Security: Use SecureString for sensitive tokens and credentials when possible.
Error Handling: Always catch and handle network exceptions appropriately. Use TryGetSocketError and TryGetStatusCode for detailed error information.
SSL/TLS: Always validate certificates in production environments. Only disable validation for testing purposes.
Multicast: Remember to leave multicast groups when done to free up system resources.

Dependencies

.NET Standard 2.0+
Ecng.ComponentModel
Newtonsoft.Json

Thread Safety

Most classes in this library are not thread-safe by default. When using from multiple threads:

Use proper synchronization for shared instances
Consider using thread-safe collections like SynchronizedSet where available
Create separate instances per thread when possible

Performance Considerations

Query String: Query strings are compiled and cached. Modifications trigger recompilation.
Retry Policy: Uses jitter to prevent thundering herd problems.
URL Encoding: Encoding operations allocate new strings. Cache results when possible.
Socket Operations: Reuse sockets when possible to avoid connection overhead.

Platform Support

.NET Standard 2.0
.NET 6.0
.NET 10.0
Cross-platform (Windows, Linux, macOS)

License

Part of the StockSharp/Ecng project. Please refer to the main project license for details.

Related Libraries

Ecng.Common: Core utilities and extensions
Ecng.Collections: Thread-safe collections
Ecng.ComponentModel: Component model utilities

Contributing

This library is part of the Ecng ecosystem. For contributions, please refer to the main project guidelines.

Support

For issues, questions, or contributions related to Ecng.Net, please visit the main project repository.