UriBuilder Costruttori

Definizione

Inizializza una nuova istanza della classe UriBuilder.

Overload

UriBuilder()

Inizializza una nuova istanza della classe UriBuilder.

UriBuilder(String)

Inizializza una nuova istanza della classe UriBuilder con l'URI specificato.

UriBuilder(Uri)

Inizializza una nuova istanza della classe UriBuilder con l'istanza di Uri specificata.

UriBuilder(String, String)

Inizializza una nuova istanza della classe UriBuilder con lo schema e l'host specificati.

UriBuilder(String, String, Int32)

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host e la porta specificati.

UriBuilder(String, String, Int32, String)

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host, il numero di porta e il percorso specificati.

UriBuilder(String, String, Int32, String, String)

Inizializza una nuova istanza della classe con lo schema, l'host UriBuilder , il numero di porta, il percorso e la stringa di query o l'identificatore di frammento specificati.

UriBuilder()

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder.

public UriBuilder ();

Commenti

Il costruttore senza parametri crea una nuova istanza della UriBuilder classe con le relative proprietà inizializzate come indicato di seguito.

Proprietà Valore iniziale
Frammento Empty
Host "loopback"
Password Empty
Path "/"
Porta -1
Query Empty
Schema "http"
UserName Empty

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(String)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder con l'URI specificato.

public UriBuilder (string uri);

Parametri

uri
String

Stringa URI.

Eccezioni

uri è null.

uri è una stringa di lunghezza zero o contiene solo spazi.

-oppure-

Durante la routine di analisi è stato rilevato uno schema in un formato non valido.

-oppure-

Il parser ha rilevato più di due barre consecutive in un URI in cui non è usato lo schema "file".

-oppure-

uri non è un URI valido.

Nota: in .NET per le app di Windows Store o la libreria di classi portabili, rilevare invece l'eccezione della classe di base, , FormatException.

Commenti

Questo costruttore inizializza una nuova istanza della UriBuilder classe con le Fragmentproprietà , QueryHostPortSchemePathe Uri impostate come specificato in .uri

Se uri non specifica uno schema, lo schema viene predefinito su "http:".

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(Uri)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder con l'istanza di Uri specificata.

public UriBuilder (Uri uri);

Parametri

uri
Uri

Istanza della classe Uri.

Eccezioni

uri è null.

Commenti

Questo costruttore inizializza una nuova istanza della UriBuilder classe con le Fragmentproprietà , QueryHostPortSchemePathe Uri impostate come specificato in .uri

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(String, String)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder con lo schema e l'host specificati.

public UriBuilder (string schemeName, string hostName);
public UriBuilder (string? schemeName, string? hostName);

Parametri

schemeName
String

Protocollo di accesso Internet.

hostName
String

Nome dominio di tipo DNS o indirizzo IP.

Esempio

Nell'esempio seguente viene creata un'istanza UriBuilder contenente l'URI http://www.contoso.com/.

UriBuilder myUri = new UriBuilder("http","www.contoso.com");

Commenti

L'istanza UriBuilder viene inizializzata con la Scheme proprietà impostata su schemeName e la Host proprietà impostata su hostName. Port viene inizializzato nel valore -1 per indicare la porta predefinita per lo schema da usare e la Path proprietà è impostata sul carattere della barra (/).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(String, String, Int32)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host e la porta specificati.

public UriBuilder (string scheme, string host, int portNumber);
public UriBuilder (string? scheme, string? host, int portNumber);

Parametri

scheme
String

Protocollo di accesso Internet.

host
String

Nome dominio di tipo DNS o indirizzo IP.

portNumber
Int32

Numero di porta IP per il servizio.

Eccezioni

portNumber è minore di -1 o maggiore di 65.535.

Esempio

Nell'esempio seguente viene creata un'istanza UriBuilder contenente l'URI http://www.contoso.com:8080/.

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080);

Commenti

L'istanza UriBuilder viene inizializzata con la Scheme proprietà impostata su schemeName, la Host proprietà impostata su hostNamee la Port proprietà impostata su portNumber. La Path proprietà è impostata sul carattere della barra (/).

Se l'oggetto portNumber è impostato su un valore di -1, questo indica che il valore della porta predefinito per lo schema verrà usato per connettersi all'host.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(String, String, Int32, String)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host, il numero di porta e il percorso specificati.

public UriBuilder (string scheme, string host, int port, string pathValue);
public UriBuilder (string? scheme, string? host, int port, string? pathValue);

Parametri

scheme
String

Protocollo di accesso Internet.

host
String

Nome dominio di tipo DNS o indirizzo IP.

port
Int32

Numero di porta IP per il servizio.

pathValue
String

Percorso alla risorsa Internet.

Eccezioni

port è minore di -1 o maggiore di 65.535.

Esempio

Nell'esempio seguente viene creata un'istanza UriBuilder contenente l'URI http://www.contoso.com:8080/index.htm.

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm");

Commenti

L'istanza UriBuilder viene inizializzata con la Scheme proprietà impostata schemeNamesu , la hostNameHost proprietà impostata su , la Port proprietà impostata su portNumbere la Path proprietà impostata su pathValue.

Se l'oggetto portNumber è impostato su un valore di -1, questo indica che il valore della porta predefinito per lo schema verrà usato per connettersi all'host.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

UriBuilder(String, String, Int32, String, String)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
Origine:
UriBuilder.cs

Inizializza una nuova istanza della classe con lo schema, l'host UriBuilder , il numero di porta, il percorso e la stringa di query o l'identificatore di frammento specificati.

public UriBuilder (string scheme, string host, int port, string path, string extraValue);
public UriBuilder (string? scheme, string? host, int port, string? path, string? extraValue);

Parametri

scheme
String

Protocollo di accesso Internet.

host
String

Nome dominio di tipo DNS o indirizzo IP.

port
Int32

Numero di porta IP per il servizio.

path
String

Percorso alla risorsa Internet.

extraValue
String

Stringa di query o identificatore di frammento.

Eccezioni

extraValue non è nullEmpty, un identificatore di frammento valido non inizia con un simbolo di cancelletto (#), né una stringa di query valida inizia con un punto interrogativo (?).

port è minore di -1 o maggiore di 65.535.

Esempio

Nell'esempio seguente viene creata un'istanza UriBuilder contenente l'URI http://www.contoso.com:8080/index.htm#top.

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm","#top");

Commenti

L'istanza UriBuilder viene inizializzata con la Scheme proprietà impostata schemeNamesu , la hostNameHost proprietà impostata su , la Port proprietà impostata su portNumbere la Path proprietà impostata su pathValue. Se extraValue inizia con un segno di numero (#), Fragment è impostato su extraValue. Se extraValue inizia con un punto interrogativo (?), Query è impostato su extraValue.

Se l'oggetto portNumber è impostato su un valore di -1, questo indica che il valore della porta predefinito per lo schema verrà usato per connettersi all'host.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0