Partilhar via


UriBuilder Construtores

Definição

Inicializa uma nova instância da classe UriBuilder.

Sobrecargas

UriBuilder()

Inicializa uma nova instância da classe UriBuilder.

UriBuilder(String)

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

UriBuilder(Uri)

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

UriBuilder(String, String)

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

UriBuilder(String, String, Int32)

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

UriBuilder(String, String, Int32, String)

Inicializa uma nova instância da classe UriBuilder 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 classe com o esquema, o host, o número da porta, o caminho e o UriBuilder identificador de cadeia de caracteres de consulta ou fragmento especificados.

UriBuilder()

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
Fragmento Empty
Host "loopback"
Senha Empty
Caminho "/"
Porta -1
Consulta Empty
Esquema "http"
UserName Empty

Aplica-se a

UriBuilder(String)

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

Inicializa uma nova instância da classe UriBuilder com 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 do URI.

Exceções

uri é null.

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

- ou -

A rotina de análise detectou um esquema em um formulário inválido.

- ou -

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

- ou -

uri não é um URI válido.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException, em vez disso.

Comentários

Esse construtor inicializa uma nova instância da UriBuilder classe com as Fragmentpropriedades , Host, Path, Port, Query, Schemee Uri definidas conforme 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

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

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 , Host, Path, Port, Query, Schemee Uri definidas conforme especificado em uri.

Aplica-se a

UriBuilder(String, String)

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

Inicializa uma nova instância da classe UriBuilder 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 no estilo DNS ou endereço IP.

Exemplos

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

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida schemeName como e a Host propriedade definida hostNamecomo . Port é inicializado com 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

Inicializa uma nova instância da classe UriBuilder 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 no estilo DNS ou endereço IP.

portNumber
Int32

Um número da 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 = 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)

Comentários

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

Se o portNumber for definido como um valor de -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

Inicializa uma nova instância da classe UriBuilder 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 no estilo DNS ou endereço IP.

port
Int32

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

pathValue
String

O caminho para o recurso de 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 = 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")

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida schemeNamecomo , a Host propriedade definida hostNamecomo , a Port propriedade definida portNumbercomo e a Path propriedade definida pathValuecomo .

Se o portNumber for definido como um valor de -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

Inicializa uma nova instância da classe com o esquema, o host, o número da porta, o caminho e o UriBuilder identificador de cadeia de caracteres de consulta 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 no estilo DNS ou endereço IP.

port
Int32

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

path
String

O caminho para o recurso de Internet.

extraValue
String

Uma cadeia de caracteres de consulta ou identificador do fragmento.

Exceções

extraValue não é null nem Empty e um identificador de fragmento válido não começa com um sinal de cerquilha (#), 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 = 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")

Comentários

A UriBuilder instância é inicializada com a Scheme propriedade definida schemeNamecomo , a Host propriedade definida hostNamecomo , a Port propriedade definida portNumbercomo e a Path propriedade definida pathValuecomo . Se extraValue começar com um sinal numérico (#), será Fragment definido extraValuecomo . Se extraValue começar com um ponto de interrogação (?), será Query definido extraValuecomo .

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

Aplica-se a