Condividi tramite


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();
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)

Origine:
UriBuilder.cs
Origine:
UriBuilder.cs
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

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

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);
public UriBuilder (Uri uri);
new UriBuilder : Uri -> UriBuilder
Public Sub New (uri As 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

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(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 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

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(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

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.

Si applica a

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(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

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.

Si applica a

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(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

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 = 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.

Si applica a