UriBuilder Costruttori

Definizione

Inizializza una nuova istanza della classe UriBuilder.Initializes a new instance of the UriBuilder class.

Overload

UriBuilder()

Inizializza una nuova istanza della classe UriBuilder.Initializes a new instance of the UriBuilder class.

UriBuilder(String)

Inizializza una nuova istanza della classe UriBuilder con l'URI specificato.Initializes a new instance of the UriBuilder class with the specified URI.

UriBuilder(Uri)

Inizializza una nuova istanza della classe UriBuilder con l'istanza di Uri specificata.Initializes a new instance of the UriBuilder class with the specified Uri instance.

UriBuilder(String, String)

Inizializza una nuova istanza della classe UriBuilder con lo schema e l'host specificati.Initializes a new instance of the UriBuilder class with the specified scheme and host.

UriBuilder(String, String, Int32)

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host e la porta specificati.Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

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.Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

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

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host, il numero di porta, il percorso e la stringa di query o l'identificatore di frammento specificati.Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

UriBuilder()

Inizializza una nuova istanza della classe UriBuilder.Initializes a new instance of the UriBuilder class.

public:
 UriBuilder();
public UriBuilder ();
Public Sub New ()

Commenti

Il costruttore senza parametri crea una nuova istanza della UriBuilder classe con le proprietà inizializzate come indicato di seguito.The parameterless constructor creates a new instance of the UriBuilder class with its properties initialized as follows.

ProprietàProperty Valore inizialeInitial Value
FragmentFragment Empty
HostHost loopback"loopback"
PasswordPassword Empty
PathPath "/""/"
PortaPort -1-1
QueryQuery Empty
SchemeScheme "http""http"
UserNameUserName Empty

UriBuilder(String)

Inizializza una nuova istanza della classe UriBuilder con l'URI specificato.Initializes a new instance of the UriBuilder class with the specified URI.

public:
 UriBuilder(System::String ^ uri);
public UriBuilder (string uri);
new UriBuilder : string -> UriBuilder
Public Sub New (uri As String)

Parametri

uri
String

Stringa URI.A URI string.

Eccezioni

uri è null.uri is null.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uri è una stringa di lunghezza zero o contiene solo spazi. uri is a zero-length string or contains only spaces. -oppure--or- Durante la routine di analisi è stato rilevato uno schema in un formato non valido.The parsing routine detected a scheme in an invalid form. In alternativa-or- Il parser ha rilevato più di due barre consecutive in un URI in cui non è usato lo schema "file".The parser detected more than two consecutive slashes in a URI that does not use the "file" scheme. -oppure--or- uri non è un URI valido.uri is not a valid URI.

Commenti

Questo UriBuilder Costruttore Inizializza una nuova istanza della classe con le Fragmentproprietà, Host, Path, Port, Query, Schemee Uri impostate come specificato in uri.This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

Se uri non specifica uno schema, per impostazione predefinita lo schema è "http:".If uri does not specify a scheme, the scheme defaults to "http:".

UriBuilder(Uri)

Inizializza una nuova istanza della classe UriBuilder con l'istanza di Uri specificata.Initializes a new instance of the UriBuilder class with the specified Uri instance.

public:
 UriBuilder(Uri ^ uri);
public UriBuilder (Uri uri);
new UriBuilder : Uri -> UriBuilder

Parametri

uri
Uri

Istanza della classe Uri.An instance of the Uri class.

Eccezioni

uri è null.uri is null.

Commenti

Questo UriBuilder Costruttore Inizializza una nuova istanza della classe con le Fragmentproprietà, Host, Path, Port, Query, Schemee Uri impostate come specificato in uri.This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

UriBuilder(String, String)

Inizializza una nuova istanza della classe UriBuilder con lo schema e l'host specificati.Initializes a new instance of the UriBuilder class with the specified scheme and host.

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.An Internet access protocol.

hostName
String

Nome dominio di tipo DNS o indirizzo IP.A DNS-style domain name or IP address.

Esempi

Nell'esempio seguente viene creata UriBuilder un'istanza di contenente l' http://www.contoso.com/URI.The following example creates a UriBuilder instance that contains the URI http://www.contoso.com/.

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

Dim myUri As New UriBuilder("http", "www.contoso.com")

Commenti

L' UriBuilder istanza viene inizializzata con Scheme la proprietà impostata schemeName su e Host la proprietà impostata hostNamesu.The UriBuilder instance is initialized with the Scheme property set to schemeName and the Host property set to hostName. Portviene inizializzato sul valore-1 per indicare che deve essere utilizzata la porta predefinita per lo schema e la Path proprietà è impostata sul carattere barra (/).Port is initialized to the value -1 to indicate the default port for the scheme should be used, and the Path property is set to the slash character (/).

UriBuilder(String, String, Int32)

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host e la porta specificati.Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

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.An Internet access protocol.

host
String

Nome dominio di tipo DNS o indirizzo IP.A DNS-style domain name or IP address.

portNumber
Int32

Numero di porta IP per il servizio.An IP port number for the service.

Eccezioni

portNumber è minore di -1 o maggiore di 65.535.portNumber is less than -1 or greater than 65,535.

Esempi

Nell'esempio seguente viene creata UriBuilder un'istanza di contenente l' http://www.contoso.com:8080/URI.The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/.

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

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080)

Commenti

L' UriBuilder istanza viene inizializzata con Scheme la proprietà impostata schemeNamesu, Host la proprietà impostata hostNamesu e la Port proprietà impostata su portNumber.The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, and the Port property set to portNumber. La Path proprietà è impostata sul carattere barra (/).The Path property is set to the slash character (/).

Se è impostato su un valore pari a-1, significa che il valore di porta predefinito per l' scheme oggetto verrà hostutilizzato per la connessione a. portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

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.Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

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.An Internet access protocol.

host
String

Nome dominio di tipo DNS o indirizzo IP.A DNS-style domain name or IP address.

port
Int32

Numero di porta IP per il servizio.An IP port number for the service.

pathValue
String

Percorso alla risorsa Internet.The path to the Internet resource.

Eccezioni

port è minore di -1 o maggiore di 65.535.port is less than -1 or greater than 65,535.

Esempi

Nell'esempio seguente viene creata UriBuilder un'istanza di contenente l' http://www.contoso.com:8080/index.htmURI.The following example creates a UriBuilder instance that contains the 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");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm")

Commenti

L' UriBuilder istanza viene inizializzata con Scheme la proprietà impostata schemeNamesu, Host la proprietà impostata hostNamesu, Port la proprietà impostata portNumber su e Path la proprietà impostata su pathValue.The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber and the Path property set to pathValue.

Se è impostato su un valore pari a-1, significa che il valore di porta predefinito per l' scheme oggetto verrà hostutilizzato per la connessione a. portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

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

Inizializza una nuova istanza della classe UriBuilder con lo schema, l'host, il numero di porta, il percorso e la stringa di query o l'identificatore di frammento specificati.Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

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.An Internet access protocol.

host
String

Nome dominio di tipo DNS o indirizzo IP.A DNS-style domain name or IP address.

port
Int32

Numero di porta IP per il servizio.An IP port number for the service.

path
String

Percorso alla risorsa Internet.The path to the Internet resource.

extraValue
String

Stringa di query o identificatore di frammento.A query string or fragment identifier.

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 (?).extraValue is neither null nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?).

port è minore di -1 o maggiore di 65.535.port is less than -1 or greater than 65,535.

Esempi

Nell'esempio seguente viene creata UriBuilder un'istanza di contenente l' http://www.contoso.com:8080/index.htm#topURI.The following example creates a UriBuilder instance that contains the 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");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm", "#top")

Commenti

L' UriBuilder istanza viene inizializzata con Scheme la proprietà impostata schemeNamesu, Host la proprietà impostata hostNamesu, Port la proprietà impostata portNumbersu e la Path proprietà è impostata su pathValue.The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber, and the Path property is set to pathValue. Se extraValue inizia con un simbolo di cancelletto (#) Fragment , viene impostato extraValuesu.If extraValue begins with a number sign (#), then Fragment is set to extraValue. Se extraValue inizia con un punto interrogativo (?) Query , viene impostato su extraValue.If extraValue begins with a question mark (?), then Query is set to extraValue.

Se è impostato su un valore pari a-1, significa che il valore di porta predefinito per l' scheme oggetto verrà hostutilizzato per la connessione a. portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

Si applica a