...
Eroare C# · Fișiere, HTTP, URI și JSON

System.UriFormatException: Invalid URI: The format of the URI could not be determined.

Pe scurt

Ai creat un `Uri` dintr-un text care nu e o adresă absolută: de obicei lipsește `https://` (`"www.magazin.ro/produse"`) sau textul e o cale relativă. Adaugă schema (`https://`), folosește `UriKind.Relative` pentru căi relative sau validează textul cu `Uri.TryCreate`.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Constructorul new Uri(text) cere implicit o adresă absolută, cu schemă: https://www.magazin.ro/produse. Când textul nu începe cu o schemă recunoscută (http://, https://, file://, ftp://), .NET nu poate determina formatul și aruncă UriFormatException: Invalid URI: The format of the URI could not be determined.

Situații frecvente: adrese introduse de utilizator fără https://, valori din configurare scrise ca localhost:5000/api sau api.magazin.ro, căi relative (produse/7) date unui new Uri fără UriKind.Relative.

Alte forme ale aceleiași excepții:

  • Invalid URI: The hostname could not be parsed. când numele de domeniu are spații sau caractere nepermise ori lipsește ("https://");
  • Invalid URI: The URI is empty. când textul e gol.

Pentru date venite din afară, folosește Uri.TryCreate(text, UriKind.Absolute, out var uri), care întoarce false în loc să arunce excepție.

De ce apare: cauzele frecvente

1Adresă fără schemă

Greșit
C#
var u = new Uri("www.magazin.ro/produse");
Corect
C#
var u = new Uri("https://www.magazin.ro/produse");

Fără https://, textul nu e o adresă absolută, deci formatul nu poate fi determinat.

2Cale relativă tratată ca absolută

Greșit
C#
var cale = new Uri("produse/7");
Corect
C#
var cale = new Uri("produse/7", UriKind.Relative);

Pentru căi relative, spune explicit UriKind.Relative. Le combini apoi cu o bază: new Uri(baza, cale).

3Adresă introdusă de utilizator

Greșit
C#
var u = new Uri(textUtilizator);
Corect
C#
if (!Uri.TryCreate(textUtilizator, UriKind.Absolute, out Uri u))
{
    Console.WriteLine("Adresa nu este valida");
}

TryCreate validează fără excepții și îți permite să afișezi un mesaj clar.

Repară tu

Repară eroarea, direct în pagină

Programul afișează domeniul și calea pentru câteva adrese salvate, dar se oprește la a doua cu System.UriFormatException: Invalid URI: The format of the URI could not be determined. Repară-l ca adresele fără schemă să primească automat https:// și programul să afișeze ambele rânduri.

Codul care dă eroarea
C#
string[] adrese = { "https://www.magazin.ro/produse", "www.magazin.ro/oferte" };
foreach (string a in adrese)
{
    var u = new Uri(a);
    Console.WriteLine($"{u.Host} -> {u.AbsolutePath}");
}
După reparație, programul afișează
www.magazin.ro -> /produse
www.magazin.ro -> /oferte
Indiciu

Înainte de new Uri(...), adaugă "https://" la textele care nu încep cu http:// sau https://.

Alte forme ale mesajului

  • System.UriFormatException: Invalid URI: The hostname could not be parsed.
  • System.UriFormatException: Invalid URI: The URI is empty.

Cum o eviți pe viitor

  • Păstrează în configurare adrese complete, cu schemă: https://api.magazin.ro/.
  • Validează cu Uri.TryCreate orice adresă venită de la utilizator sau din fișiere.
  • Pentru combinarea bazei cu o cale, folosește new Uri(baza, "produse/7") în loc de concatenare de texte.
  • Dacă accepți adrese fără schemă, adaugă tu https:// înainte de a crea Uri-ul.

Întrebări frecvente

De ce localhost:5000/api dă eroare?

Pentru că, fără http://, localhost: e interpretat ca o schemă necunoscută sau formatul nu poate fi determinat. Scrie http://localhost:5000/api.

Uri.IsWellFormedUriString sau Uri.TryCreate?

TryCreate îți dă direct obiectul Uri dacă textul e valid, deci e mai practic. IsWellFormedUriString doar verifică textul și e mai strict cu unele caractere.

Erori înrudite

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.