UriBuilder Costruttori

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.Extensions.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 UriBuilder classe con lo schema, l'host, il numero di porta, il percorso e la stringa di query o l'identificatore di frammento specificati.

UriBuilder()

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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

Si applica a

UriBuilder(String)

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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 nella libreria di classi portabile intercettare invece l'eccezione della classe di base, FormatException, .

Commenti

Questo costruttore inizializza una nuova istanza della UriBuilder classe con le Fragmentproprietà , Host, Path, Query Port, , Schemee Uri impostate come specificato in uri.

Se uri non specifica uno schema, per impostazione predefinita lo schema è "http:".

Si applica a

UriBuilder(Uri)

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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à , Host, Path, Query Port, , Schemee Uri impostate come specificato in uri.

Si applica a

UriBuilder(String, String)

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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);

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 sul valore -1 per indicare la porta predefinita per lo schema da utilizzare e la Path proprietà è impostata sul carattere barra (/).

Si applica a

UriBuilder(String, String, Int32)

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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);

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 barra (/).

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

Si applica a

UriBuilder(String, String, Int32, String)

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: 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);

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

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

Si applica a

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

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Source:: UriBuilder.cs

Inizializza una nuova istanza della UriBuilder classe con lo schema, l'host, 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);

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 su schemeName, la Host proprietà impostata su hostName, la Port proprietà impostata su portNumbere la Path proprietà impostata su pathValue. Se extraValue inizia con un segno di numero (#), viene Fragment impostato su extraValue. Se extraValue inizia con un punto interrogativo (?), viene Query impostato su extraValue.

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

Si applica a

UriBuilder Costruttori

Definizione

Overload

UriBuilder()

Commenti

Si applica a

UriBuilder(String)

Parametri

Eccezioni

Commenti

Si applica a

UriBuilder(Uri)

Parametri

Eccezioni

Commenti

Si applica a

UriBuilder(String, String)

Parametri

Esempio

Commenti

Si applica a

UriBuilder(String, String, Int32)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

UriBuilder(String, String, Int32, String)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

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

Parametri

Eccezioni

Esempio

Commenti

Si applica a

Commenti e suggerimenti

Risorse aggiuntive