Contains, StartsWith și EndsWith în C# (.NET): sintaxă, parametri și exemple practice

Ce face `Contains, StartsWith și EndsWith`

Metodele Contains, StartsWith și EndsWith sunt instrumentele standard pentru căutarea rapidă în șiruri de caractere, validarea extensiilor de fișiere, a prefixelor de URL-uri sau filtrarea textelor. Atunci când ai nevoie nu doar de un răspuns bool, ci și de poziția exactă a sub-șirului, metodele IndexOf și LastIndexOf returnează indexul de la zero al apariției (sau -1 dacă sub-șirul nu există).

O bună practică esențială în .NET este specificarea explicită a parametrului StringComparison. Pentru verificări tehnice (căi de fișiere, antete HTTP, adrese de e-mail, chei de configurare, extensii), folosește întotdeauna StringComparison.Ordinal (sensibil la majuscule) sau StringComparison.OrdinalIgnoreCase (insensibil la majuscule): acestea compară direct codurile binare ale caracterelor, fiind mult mai rapide și imune la diferențele culturale ale sistemului de operare.

Parametri, metode și opțiuni

Parametru / Metodă	Descriere
`text.Contains(string value, StringComparison comp)`	Returnează `true` dacă `value` apare oriunde în interiorul șirului `text`.
`text.StartsWith(string value, StringComparison comp)`	Verifică dacă șirul `text` începe cu secvența `value`.
`text.EndsWith(string value, StringComparison comp)`	Verifică dacă șirul `text` se termină cu secvența `value`.
`text.IndexOf(string value, StringComparison comp)`	Returnează indexul primei apariții a lui `value` (începând de la `0`), sau `-1` dacă nu a fost găsit.
`StringComparison.Ordinal / OrdinalIgnoreCase`	Comparație binară rapidă, independentă de cultura locală (recomandată pentru identificatori, URL-uri, extensii).
`string.IsNullOrWhiteSpace(string? value)`	Metodă statică utilitară care returnează `true` dacă șirul este `null`, gol (`""`) sau format doar din spații albe.

Exemple

Exemplul 1: Validarea URL-urilor și a extensiilor cu OrdinalIgnoreCase

Verificăm protocolul și extensia unui fișier fără a aloca șiruri noi în memorie prin .ToLower().

string url = "HTTPS://cdn.dexblog.ro/arhiva/Raport_2026.PDF";

bool esteHttps = url.StartsWith("https://", StringComparison.OrdinalIgnoreCase);
bool estePdf = url.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase);
bool esteDinArhiva = url.Contains("/arhiva/", StringComparison.OrdinalIgnoreCase);

Console.WriteLine($"Conexiune securizată: {esteHttps}");
Console.WriteLine($"Document PDF:         {estePdf}");
Console.WriteLine($"Din folderul arhivă:  {esteDinArhiva}");

Ieșire în consolă

Conexiune securizată: True
Document PDF:         True
Din folderul arhivă:  True

Exemplul 2: Găsirea poziției unui delimitator cu IndexOf și verificarea șirurilor goale

Folosim string.IsNullOrWhiteSpace pentru validarea inițială și IndexOf pentru a extrage domeniul dintr-o adresă de e-mail.

string email = "contact@dexblog.ro";

if (!string.IsNullOrWhiteSpace(email))
{
    int pozitieArond = email.IndexOf('@');
    if (pozitieArond > 0 && pozitieArond < email.Length - 1)
    {
        string utilizator = email[..pozitieArond];
        string domeniu = email[(pozitieArond + 1)..];
        Console.WriteLine($"Utilizator: {utilizator} | Domeniu: {domeniu}");
    }
}