UriBuilder Construtores

Definição

Espaço de Nomes:: System

Assemblagens:: System.dll, System.Runtime.Extensions.dll

Assemblagem:: System.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da UriBuilder classe.

Sobrecargas

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

UriBuilder()

Inicializa uma nova instância da UriBuilder classe.

public:
 UriBuilder();

public UriBuilder();

Public Sub New ()

Observações

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

Property	Valor Inicial
Fragment	Empty
Host	"loopback"
Password	Empty
Path	"/"
Porto	-1
Query	Empty
Esquema	"http"
UserName	Empty

Aplica-se a

UriBuilder(String)

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

Exceções

ArgumentNullException

uri é null.

UriFormatException

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

-ou-

A rotina de análise sintática detetou um esquema numa forma inválida.

-ou-

O analisador detetou mais de duas barras consecutivas num URI que não utiliza o esquema de "ficheiro".

-ou-

uri não é um URI válido.

Nota: Em .NET para aplicações Windows Store ou a Portable Class Library, apanhe a exceção da classe base, FormatException, em vez disso.

Observações

Este construtor inicializa uma nova instância da UriBuilder classe com os Fragment, Host, Path, Port, Query, Scheme, , e Uri propriedades definidas conforme especificado em uri.

Se uri não especificar um esquema, o esquema passa por defeito a "http:".

Aplica-se a

UriBuilder(Uri)

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 Uri classe.

Exceções

ArgumentNullException

uri é null.

Observações

Este construtor inicializa uma nova instância da UriBuilder classe com os Fragment, Host, Path, Port, Query, Scheme, , e Uri propriedades definidas conforme especificado em uri.

Aplica-se a

UriBuilder(String, String)

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

Exemplos

O exemplo seguinte 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")

Observações

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

Aplica-se a

UriBuilder(String, String, Int32)

Inicializa uma nova instância da UriBuilder classe com o esquema, host e 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 ou endereço IP ao estilo DNS.

portNumber: Int32

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

Exceções

ArgumentOutOfRangeException

portNumber é inferior a -1 ou superior a 65.535.

Exemplos

O exemplo seguinte 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)

Observações

A UriBuilder instância é inicializada com a Scheme propriedade definida para schemeName, a Host propriedade definida para hostName, e a Port propriedade definida para portNumber. A Path propriedade está definida para o carácter de barra (/).

Se o portNumber for definido para -1, isto indica que o valor padrão da porta para o esquema será usado para se ligar ao host.

Aplica-se a

UriBuilder(String, String, Int32, String)

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

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 ou endereço IP ao 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

ArgumentOutOfRangeException

port é inferior a -1 ou superior a 65.535.

Exemplos

O exemplo seguinte 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")

Observações

Se o portNumber for definido para -1, isto indica que o valor padrão da porta para o esquema será usado para se ligar ao host.

Aplica-se a

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

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

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 ou endereço IP ao 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 consulta ou identificador de fragmento.

Exceções

ArgumentException

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

ArgumentOutOfRangeException

port é inferior a -1 ou superior a 65.535.

Exemplos

O exemplo seguinte 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")

Observações

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

Se o portNumber for definido para -1, isto indica que o valor padrão da porta para o esquema será usado para se ligar ao host.

Aplica-se a

Comentários

Esta página foi útil?