Uri.IsWellFormedUriString(String, UriKind) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Indica se la stringa è ben formata mediante un tentativo di costruire un URI con tale stringa e assicura che la stringa non deve essere ulteriormente sottoposta ad escape.

public:
 static bool IsWellFormedUriString(System::String ^ uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string? uriString, UriKind uriKind);
static member IsWellFormedUriString : string * UriKind -> bool
Public Shared Function IsWellFormedUriString (uriString As String, uriKind As UriKind) As Boolean

Parametri

uriString
String

Stringa usata per tentare di costruire un oggetto Uri.

uriKind
UriKind

Tipo di Uri in uriString.

Restituisce

Boolean

true se la stringa era ben formata, in caso contrario false.

Commenti

Nelle versioni di .NET precedenti alla versione 4.5, per impostazione predefinita la stringa viene considerata ben formata in base a RFC 2396 e RFC 2732. Se l'analisi IDN (International Resource Identifiers) o Internationalized Domain Name (IDN) è abilitata, la stringa viene considerata ben formata in base a RFC 3986 e RFC 3987.

A partire da .NET 4.5, le stringhe vengono sempre considerate ben formate in base a RFC 3986 e RFC 3987, indipendentemente dal fatto che siano abilitati o meno IRI o IDN. Si noti, tuttavia, che questo vale solo per le app destinate a .NET 4.5 o versioni successive. Le app destinate a .NET 4.0 richiamano il codice di compatibilità ed verificano il comportamento precedente (pre-4.5).

La stringa è considerata in formato non corretto, causando la restituzione del metodo false, se si verifica una delle condizioni seguenti

Errore Esempio
La stringa non è preceduta correttamente da un escape. http://www.contoso.com/path???/file name
La stringa è un assoluto Uri che rappresenta un file Uriimplicito. c:\\directory\filename
La stringa è un URI assoluto che manca una barra prima del percorso. file://c:/directory/filename
La stringa contiene barre rovesciate senza caratteri di escape anche se verranno considerate come barre http:\\\host/path/file
La stringa rappresenta un assoluto Uri gerarchico e non contiene "://" www.contoso.com/path/file
Il parser per indica Scheme che la stringa originale non è stata ben formata. L'esempio dipende dallo schema dell'URI.
A partire da .NET 4.5, gli URI relativi con due punti (':') nel primo segmento non sono considerati ben formati. 2013.05.29_14:33:41

Per altre informazioni sul supporto IRI, vedere la sezione Osservazioni per la Uri classe .

Si applica a

Vedi anche