UriBuilder Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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 fragmento ou de cadeia de consulta especificados.

UriBuilder()

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

UriBuilder(String)

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

ArgumentNullException

uri é null.

UriFormatException

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 classe com as UriBuilderFragmentpropriedades , 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:".

UriBuilder(Uri)

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

ArgumentNullException

uri é null.

Comentários

Esse construtor inicializa uma nova instância da classe com as UriBuilderFragmentpropriedades , Host, Path, Port, Query, Schemee Uri definidas conforme especificado em uri.

UriBuilder(String, String)

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

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

UriBuilder(String, String, Int32)

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

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

ArgumentOutOfRangeException

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 como hostNamee a Port propriedade definida como portNumber. 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.

UriBuilder(String, String, Int32, String)

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

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

ArgumentOutOfRangeException

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 como hostName, a Port propriedade definida como portNumbere a Path propriedade definida como pathValue.

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.

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

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 fragmento ou de cadeia de consulta 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);

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

ArgumentException

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 (?).

ArgumentOutOfRangeException

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 como hostName, a Port propriedade definida como portNumbere a Path propriedade definida como pathValue. Se extraValue começar com um sinal de número (#), 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.