UriBuilder Constructores

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase UriBuilder.

Sobrecargas

UriBuilder()	Inicializa una nueva instancia de la clase UriBuilder.
UriBuilder(String)	Inicializa una nueva instancia de la clase UriBuilder con el identificador URI especificado.
UriBuilder(Uri)	Inicializa una nueva instancia de la clase UriBuilder con la instancia de Uri especificada.
UriBuilder(String, String)	Inicializa una nueva instancia de la clase UriBuilder con el servicio y host que se hayan especificado.
UriBuilder(String, String, Int32)	Inicializa una nueva instancia de la clase UriBuilder con el servicio, el host y el puerto que se hayan especificado.
UriBuilder(String, String, Int32, String)	Inicializa una nueva instancia de la clase UriBuilder con el servicio, el host, el número de puerto y la ruta de acceso que se hayan especificado.
UriBuilder(String, String, Int32, String, String)	Inicializa una nueva instancia de la UriBuilder clase con el esquema, host, número de puerto, ruta de acceso y cadena de consulta o identificador de fragmento especificados.

UriBuilder()

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

Comentarios

El constructor sin parámetros crea una nueva instancia de la clase con sus propiedades inicializadas de la UriBuilder siguiente manera.

Propiedad	Valor inicial
Fragmento	Empty
administrador de flujos de trabajo	"bucle invertido"
Contraseña	Empty
Path	"/"
Puerto	-1
Consultar	Empty
Scheme	"http"
UserName	Empty

UriBuilder(String)

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder con el identificador 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

Una cadena URI.

Excepciones

ArgumentNullException

uri es null.

UriFormatException

uri es una cadena de longitud cero o contiene solo espacios.

o bien

La rutina de análisis detectó un esquema en un formato no válido.

o bien

El analizador detectó más de dos barras diagonales consecutivas en un URI que no utiliza el esquema de "archivo".

o bien

uri no es un URI válido.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, detecte la excepción de clase base, FormatException, en su lugar.

Comentarios

Este constructor inicializa una nueva instancia de la UriBuilder clase con las Fragmentpropiedades , , PathHostPort, Query, , Schemey Uri establecidas como se especifica en uri.

Si uri no especifica un esquema, el esquema tiene como valor predeterminado "http:".

UriBuilder(Uri)

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder con la instancia de Uri especificada.

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

Parámetros

uri

Uri

Instancia de la clase Uri.

Excepciones

ArgumentNullException

uri es null.

Comentarios

Este constructor inicializa una nueva instancia de la UriBuilder clase con las Fragmentpropiedades , , PathHostPort, Query, , Schemey Uri establecidas como se especifica en uri.

UriBuilder(String, String)

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder con el servicio y host que se hayan especificado.

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

Protocolo de acceso a Internet.

hostName

String

Nombre de dominio de estilo DNS o dirección IP.

Ejemplos

En el ejemplo siguiente se crea una UriBuilder instancia que contiene el 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")

Comentarios

La UriBuilder instancia se inicializa con la Scheme propiedad establecida schemeName en y la Host propiedad establecida en hostName. Port se inicializa en el valor -1 para indicar el puerto predeterminado para el esquema y la Path propiedad se establece en el carácter de barra diagonal (/).

UriBuilder(String, String, Int32)

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder con el servicio, el host y el puerto que se hayan especificado.

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

Protocolo de acceso a Internet.

host

String

Nombre de dominio de estilo DNS o dirección IP.

portNumber

Int32

Número de puerto IP para el servicio.

Excepciones

ArgumentOutOfRangeException

portNumber es menor que -1 o mayor que 65 535.

Ejemplos

En el ejemplo siguiente se crea una UriBuilder instancia que contiene el 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)

Comentarios

La UriBuilder instancia se inicializa con la Scheme propiedad establecida schemeNameen , la Host propiedad establecida hostNameen y la Port propiedad establecida en portNumber. La Path propiedad se establece en el carácter de barra diagonal (/).

portNumber Si se establece en un valor de -1, esto indica que el valor de puerto predeterminado para el esquema se usará para conectarse al host.

UriBuilder(String, String, Int32, String)

Source:

UriBuilder.cs

Inicializa una nueva instancia de la clase UriBuilder con el servicio, el host, el número de puerto y la ruta de acceso que se hayan especificado.

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

Protocolo de acceso a Internet.

host

String

Nombre de dominio de estilo DNS o dirección IP.

port

Int32

Número de puerto IP para el servicio.

pathValue

String

Ruta de acceso al recurso de Internet.

Excepciones

ArgumentOutOfRangeException

port es menor que -1 o mayor que 65 535.

Ejemplos

En el ejemplo siguiente se crea una UriBuilder instancia que contiene el 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")

Comentarios

La UriBuilder instancia se inicializa con la Scheme propiedad establecida schemeNameen , la Host propiedad establecida hostNameen , la propiedad establecida en , la Port propiedad establecida portNumberen y la Path propiedad establecida en pathValue.

portNumber Si se establece en un valor de -1, esto indica que el valor de puerto predeterminado para el esquema se usará para conectarse al host.

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

Source:

UriBuilder.cs

Inicializa una nueva instancia de la UriBuilder clase con el esquema, host, número de puerto, ruta de acceso y cadena de consulta o identificador de 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);

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

Protocolo de acceso a Internet.

host

String

Nombre de dominio de estilo DNS o dirección IP.

port

Int32

Número de puerto IP para el servicio.

path

String

Ruta de acceso al recurso de Internet.

extraValue

String

Cadena de consulta o identificador de campo.

Excepciones

ArgumentException

extraValue no es null ni Empty, ni hay un identificador de fragmento válido que comience por un signo de número (#), ni hay ninguna cadena de consulta válida que comience por un signo de interrogación de cierre (?).

ArgumentOutOfRangeException

port es menor que -1 o mayor que 65 535.

Ejemplos

En el ejemplo siguiente se crea una UriBuilder instancia que contiene el 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")

Comentarios

La UriBuilder instancia se inicializa con la Scheme propiedad establecida schemeNameen , la Host propiedad establecida hostNameen , la propiedad establecida en , la Port propiedad establecida portNumberen y la Path propiedad establecida en pathValue. Si extraValue comienza con un signo de número (#), Fragment se establece extraValueen . Si extraValue comienza con un signo de interrogación (?), Query se establece extraValueen .

portNumber Si se establece en un valor de -1, esto indica que el valor de puerto predeterminado para el esquema se usará para conectarse al host.