Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore Uri (String, Boolean)

 

Data di pubblicazione: ottobre 2016

Nota: Questa API è ora obsoleta.

Inizializza una nuova istanza della classe Uri con l'URI specificato e con il controllo esplicito dell'escape dei caratteri.

Spazio dei nomi:   System
Assembly:  System (in System.dll)

[ObsoleteAttribute("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(
	string uriString,
	bool dontEscape
)

Parametri

uriString
Type: System.String

URI.

dontEscape
Type: System.Boolean

true se uriString è sottoposto a escape in modo completo; in caso contrario, false. Vedere la sezione Osservazioni.

Exception Condition
ArgumentNullException

uriString è null.

UriFormatException

uriStringè vuoto o contiene solo spazi.

-oppure-

Lo schema specificato in uriString non è valido.

-oppure-

uriString contiene troppe barre.

-oppure-

La password specificata in uriString non è valida.

-oppure-

Il nome host specificato in uriString non è valido.

-oppure-

Il nome file specificato in uriString non è valido.

-oppure-

Il nome utente specificato in uriString non è valido.

-oppure-

Il nome host o dell'autorità specificato in uriString non può terminare con barre rovesciate.

-oppure-

Il numero di porta specificato in uriString non è valido e non può essere analizzato.

-oppure-

La lunghezza di uriString supera 65519 caratteri.

-oppure-

La lunghezza dello schema specificato in uriString supera 1023 caratteri.

-oppure-

uriString contiene una sequenza di caratteri non valida.

-oppure-

Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.

Questo costruttore crea un Uri istanza da una stringa URI. Analizza l'URI e lo inserisce in formato canonico.

Il dontEscape parametro determina se i caratteri riservati vengono convertiti in sequenze di escape. Questo parametro deve essere impostato su true solo se si è certi che tutti i caratteri riservati nell'URI siano stati sottoposti a escape. Impostazione del valore su true per un URI che non sottoposto a escape completo può causare comportamenti imprevisti. È consigliabile impostare sempre questo parametro false.

Se dontEscape è impostato su false, il costruttore di sequenze di escape qualsiasi carattere riservato controllando che tutte le occorrenze di percentuale (%)) sono seguite da una sequenza di escape valida. Se la sequenza di caratteri seguente percentuale non è valida, la percentuale viene sostituita da % 25.

Questo costruttore non garantisce che il Uri fa riferimento a una risorsa accessibile.

Nell'esempio seguente viene creato un Uri istanza per l'URI http://www.contoso.com/Hello%20World.htm. Poiché l'URI contenuto è preceduto da caratteri di escape e presenta il formato canonico, il dontEscape parametro può essere impostato su true.

Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: