UriBuilder Constructores

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.Extensions.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.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
Source:
UriBuilder.cs
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

Se aplica a

UriBuilder(String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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:".

Se aplica a

UriBuilder(Uri)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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.

Se aplica a

UriBuilder(String, String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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 (/).

Se aplica a

UriBuilder(String, String, Int32)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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.

Se aplica a

UriBuilder(String, String, Int32, String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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.

Se aplica a

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

Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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.

Se aplica a