Compartilhar via


UriBuilder Construtores

Definição

Inicializa uma nova instância da classe UriBuilder.

Sobrecargas

Nome Description
UriBuilder()

Inicializa uma nova instância da classe UriBuilder.

UriBuilder(String)

Inicializa uma nova instância da UriBuilder classe com o URI especificado.

UriBuilder(Uri)

Inicializa uma nova instância da UriBuilder classe com a instância especificada Uri .

UriBuilder(String, String)

Inicializa uma nova instância da UriBuilder classe com o esquema e o host especificados.

UriBuilder(String, String, Int32)

Inicializa uma nova instância da UriBuilder classe com o esquema, o host e a porta especificados.

UriBuilder(String, String, Int32, String)

Inicializa uma nova instância da UriBuilder classe com o esquema, o host, o número da porta e o caminho especificados.

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

Inicializa uma nova instância da UriBuilder classe com o esquema, o host, o número da porta, o caminho e o identificador de cadeia de caracteres ou fragmento especificados.

UriBuilder()

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da classe UriBuilder.

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

Comentários

O construtor sem parâmetros cria uma nova instância da UriBuilder classe com suas propriedades inicializadas da seguinte maneira.

Propriedade Valor Inicial
Fragment Empty
Anfitrião "loopback"
Senha Empty
Caminho "/"
Porto -1
Consulta Empty
Scheme "http"
UserName Empty

Aplica-se a

UriBuilder(String)

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com o URI especificado.

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

Parâmetros

uri
String

Uma cadeia de caracteres de URI.

Exceções

uri é null.

uri é uma cadeia de caracteres de comprimento zero ou contém apenas espaços.

- ou -

A rotina de análise detectou um esquema de forma inválida.

- ou -

O analisador detectou mais de duas barras consecutivas em um URI que não usa o esquema "file".

- ou -

uri não é um URI válido.

Comentários

Esse construtor inicializa uma nova instância da UriBuilder classe com as Fragmentpropriedades , , , HostPath, Porte UriQuerySchemepropriedades definidas como especificado em .uri

Se uri não especificar um esquema, o esquema usará como padrão "http:".

Aplica-se a

UriBuilder(Uri)

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com a instância especificada Uri .

public:
 UriBuilder(Uri ^ uri);
public UriBuilder(Uri uri);
new UriBuilder : Uri -> UriBuilder
Public Sub New (uri As Uri)

Parâmetros

uri
Uri

Uma instância da classe Uri.

Exceções

uri é null.

Comentários

Esse construtor inicializa uma nova instância da UriBuilder classe com as Fragmentpropriedades , , , HostPath, Porte UriQuerySchemepropriedades definidas como especificado em .uri

Aplica-se a

UriBuilder(String, String)

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com o esquema e o host especificados.

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)

Parâmetros

schemeName
String

Um protocolo de acesso à Internet.

hostName
String

Um nome de domínio ou endereço IP no estilo DNS.

Exemplos

O exemplo a seguir cria uma UriBuilder instância que contém o URI 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")

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida schemeName como e a Host propriedade definida como hostName. Port é inicializado para o valor -1 para indicar que a porta padrão para o esquema deve ser usada e a Path propriedade é definida como o caractere de barra (/).

Aplica-se a

UriBuilder(String, String, Int32)

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com o esquema, o host e a porta especificados.

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)

Parâmetros

scheme
String

Um protocolo de acesso à Internet.

host
String

Um nome de domínio ou endereço IP no estilo DNS.

portNumber
Int32

Um número de porta IP para o serviço.

Exceções

portNumber é menor que -1 ou maior que 65.535.

Exemplos

O exemplo a seguir cria uma UriBuilder instância que contém o URI 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)

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida como schemeName, a Host propriedade definida como hostName, e a Port propriedade definida como portNumber. A Path propriedade é definida como o caractere de barra (/).

Se o portNumber valor for definido como -1, isso indicará que o valor da porta padrão para o esquema será usado para se conectar ao host.

Aplica-se a

UriBuilder(String, String, Int32, String)

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com o esquema, o host, o número da porta e o caminho especificados.

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)

Parâmetros

scheme
String

Um protocolo de acesso à Internet.

host
String

Um nome de domínio ou endereço IP no estilo DNS.

port
Int32

Um número de porta IP para o serviço.

pathValue
String

O caminho para o recurso da Internet.

Exceções

port é menor que -1 ou maior que 65.535.

Exemplos

O exemplo a seguir cria uma UriBuilder instância que contém o URI 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")

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida como schemeName, a Host propriedade definida como hostName, a Port propriedade definida como portNumber, e a Path propriedade definida como pathValue.

Se o portNumber valor for definido como -1, isso indicará que o valor da porta padrão para o esquema será usado para se conectar ao host.

Aplica-se a

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

Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs
Origem:
UriBuilder.cs

Inicializa uma nova instância da UriBuilder classe com o esquema, o host, o número da porta, o caminho e o identificador de cadeia de caracteres ou fragmento especificados.

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)

Parâmetros

scheme
String

Um protocolo de acesso à Internet.

host
String

Um nome de domínio ou endereço IP no estilo DNS.

port
Int32

Um número de porta IP para o serviço.

path
String

O caminho para o recurso da Internet.

extraValue
String

Uma cadeia de caracteres de consulta ou um identificador de fragmento.

Exceções

extraValue não é nem nullEmpty, nem um identificador de fragmento válido começa com um sinal de número (#), nem uma cadeia de caracteres de consulta válida começa com um ponto de interrogação (?).

port é menor que -1 ou maior que 65.535.

Exemplos

O exemplo a seguir cria uma UriBuilder instância que contém o URI 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")

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida como schemeName, a Host propriedade definida como hostName, a Port propriedade definida como portNumber, e a Path propriedade definida como pathValue. Se extraValue começar com um sinal de número (#), será Fragment definido como extraValue. Se extraValue começar com um ponto de interrogação (?), então Query será definido como extraValue.

Se o portNumber valor for definido como -1, isso indicará que o valor da porta padrão para o esquema será usado para se conectar ao host.

Aplica-se a