UriBuilder Construtores

Definição

Namespace:: System

Assemblies:: System.dll, System.Runtime.Extensions.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentNullException

uri é null.

UriFormatException

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 , , , Host Path, Porte Uri Query Schemepropriedades 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

ArgumentNullException

uri é null.

Comentários

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

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 = 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

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 = 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

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

ArgumentException

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

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 = 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

Comentários

Esta página foi útil?