UriBuilder Costruttori

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

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

Inizializza una nuova istanza della classe UriBuilder.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

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

UriBuilder(String)

Origine:

UriBuilder.cs

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

public:
 UriBuilder(System::String ^ uri);

public UriBuilder (string uri);

new UriBuilder : string -> UriBuilder

Public Sub New (uri As String)

Parametri

uri

String

Stringa URI.

Eccezioni

ArgumentNullException

uri è null.

UriFormatException

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:".

UriBuilder(Uri)

Origine:

UriBuilder.cs

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

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

Parametri

uri

Uri

Istanza della classe Uri.

Eccezioni

ArgumentNullException

uri è null.

Commenti

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

UriBuilder(String, String)

Origine:

UriBuilder.cs

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

public:
 UriBuilder(System::String ^ schemeName, System::String ^ hostName);

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

new UriBuilder : string * string -> UriBuilder

Public Sub New (schemeName As String, hostName As String)

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 = gcnew UriBuilder(  "http", "www.contoso.com" );

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

let myUri = UriBuilder "http","www.contoso.com"

Dim myUri As 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 (/).

UriBuilder(String, String, Int32)

Origine:

UriBuilder.cs

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

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int portNumber);

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

new UriBuilder : string * string * int -> UriBuilder

Public Sub New (scheme As String, host As String, portNumber As Integer)

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

ArgumentOutOfRangeException

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 = gcnew UriBuilder( "http", "www.contoso.com",8080 );

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

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

Dim myUri As 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.

UriBuilder(String, String, Int32, String)

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(System::String ^ scheme, System::String ^ host, int port, System::String ^ pathValue);

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

new UriBuilder : string * string * int * string -> UriBuilder

Public Sub New (scheme As String, host As String, port As Integer, pathValue As String)

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

ArgumentOutOfRangeException

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 = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm" );

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

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

Dim myUri As 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.

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

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(System::String ^ scheme, System::String ^ host, int port, System::String ^ path, System::String ^ extraValue);

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

new UriBuilder : string * string * int * string * string -> UriBuilder

Public Sub New (scheme As String, host As String, port As Integer, path As String, extraValue As String)

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

ArgumentException

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

ArgumentOutOfRangeException

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 = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm","#top" );

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

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

Dim myUri As 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.