UriBuilder Constructeurs

Définition

Initialise une nouvelle instance de la classe UriBuilder.

Surcharges

UriBuilder()

Initialise une nouvelle instance de la classe UriBuilder.

UriBuilder(String)

Initialise une nouvelle instance de la classe UriBuilder avec l'URI spécifié.

UriBuilder(Uri)

Initialise une nouvelle instance de la classe UriBuilder avec l'instance Uri spécifiée.

UriBuilder(String, String)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma et l'hôte spécifiés.

UriBuilder(String, String, Int32)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma, l'hôte et le port spécifiés.

UriBuilder(String, String, Int32, String)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma, l'hôte, le numéro de port et le chemin d'accès spécifiés.

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

Initialise une nouvelle instance de la classe avec le schéma, l’hôteUriBuilder, le numéro de port, le chemin d’accès et l’identificateur de chaîne ou de fragment de requête spécifiés.

UriBuilder()

Initialise une nouvelle instance de la classe UriBuilder.

public:
 UriBuilder();
public UriBuilder ();
Public Sub New ()

Remarques

Le constructeur sans paramètre crée une nouvelle instance de la UriBuilder classe avec ses propriétés initialisées comme suit.

Propriété Valeur initiale
Fragment Empty
Hôte « bouclage »
Mot de passe Empty
Path "/"
Port -1
Query Empty
Schéma « http »
UserName Empty

S’applique à

UriBuilder(String)

Initialise une nouvelle instance de la classe UriBuilder avec l'URI spécifié.

public:
 UriBuilder(System::String ^ uri);
public UriBuilder (string uri);
new UriBuilder : string -> UriBuilder
Public Sub New (uri As String)

Paramètres

uri
String

Chaîne d’URI.

Exceptions

uri a la valeur null.

uri est une chaîne de longueur nulle ou contient uniquement des espaces.

- ou -

La routine d’analyse a détecté un schéma dans un formulaire non valide.

- ou -

L’analyseur a détecté plus de deux barres obliques consécutives dans un URI qui n’utilise pas le schéma « file ».

- ou -

uri n'est pas un URI valide.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez l’exception de classe de base, FormatException, à la place.

Remarques

Ce constructeur initialise un nouveau instance de la UriBuilder classe avec les Fragmentpropriétés , Host, PortQueryPath, Schemeet Uri définies comme spécifié dans .uri

Si uri ne spécifie pas de schéma, le schéma est défini par défaut sur « http: ».

S’applique à

UriBuilder(Uri)

Initialise une nouvelle instance de la classe UriBuilder avec l'instance Uri spécifiée.

public:
 UriBuilder(Uri ^ uri);
public UriBuilder (Uri uri);
new UriBuilder : Uri -> UriBuilder
Public Sub New (uri As Uri)

Paramètres

uri
Uri

Instance de la classe Uri.

Exceptions

uri a la valeur null.

Remarques

Ce constructeur initialise un nouveau instance de la UriBuilder classe avec les Fragmentpropriétés , Host, PortQueryPath, Schemeet Uri définies comme spécifié dans .uri

S’applique à

UriBuilder(String, String)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma et l'hôte spécifiés.

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)

Paramètres

schemeName
String

Protocole d'accès à Internet.

hostName
String

Nom de domaine de type DNS ou adresse IP.

Exemples

L’exemple suivant crée un UriBuilder instance qui contient l’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")

Remarques

Le UriBuilder instance est initialisé avec la Scheme propriété définie sur schemeName et la Host propriété définie sur hostName. Port est initialisé à la valeur -1 pour indiquer que le port par défaut du schéma doit être utilisé, et la Path propriété est définie sur la barre oblique (/).

S’applique à

UriBuilder(String, String, Int32)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma, l'hôte et le port spécifiés.

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)

Paramètres

scheme
String

Protocole d'accès à Internet.

host
String

Nom de domaine de type DNS ou adresse IP.

portNumber
Int32

Numéro de port IP pour le service.

Exceptions

portNumber est inférieur à -1 ou supérieur à 65 535.

Exemples

L’exemple suivant crée un UriBuilder instance qui contient l’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)

Remarques

Le UriBuilder instance est initialisé avec la Scheme propriété définie sur schemeName, la Host propriété définie sur hostNameet la Port propriété définie sur portNumber. La Path propriété est définie sur la barre oblique (/).

Si est portNumber défini sur une valeur de -1, cela indique que la valeur de port par défaut du schéma sera utilisée pour se connecter à l’hôte.

S’applique à

UriBuilder(String, String, Int32, String)

Initialise une nouvelle instance de la classe UriBuilder avec le schéma, l'hôte, le numéro de port et le chemin d'accès spécifiés.

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)

Paramètres

scheme
String

Protocole d'accès à Internet.

host
String

Nom de domaine de type DNS ou adresse IP.

port
Int32

Numéro de port IP pour le service.

pathValue
String

Chemin d'accès à la ressource Internet.

Exceptions

port est inférieur à -1 ou supérieur à 65 535.

Exemples

L’exemple suivant crée un UriBuilder instance qui contient l’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")

Remarques

Le UriBuilder instance est initialisé avec la Scheme propriété définie schemeNamesur , la Host propriété définie hostNamesur , la Port propriété définie sur portNumberet la Path propriété définie sur pathValue.

Si est portNumber défini sur une valeur de -1, cela indique que la valeur de port par défaut du schéma sera utilisée pour se connecter à l’hôte.

S’applique à

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

Initialise une nouvelle instance de la classe avec le schéma, l’hôteUriBuilder, le numéro de port, le chemin d’accès et l’identificateur de chaîne ou de fragment de requête spécifiés.

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)

Paramètres

scheme
String

Protocole d'accès à Internet.

host
String

Nom de domaine de type DNS ou adresse IP.

port
Int32

Numéro de port IP pour le service.

path
String

Chemin d'accès à la ressource Internet.

extraValue
String

Chaîne de requête ou identificateur de fragment.

Exceptions

extraValue n'est ni null, ni Empty. Un identificateur de fragment valide ne commence pas par un symbole dièse (#), une chaîne de requête valide ne commence pas par un point d'interrogation (?).

port est inférieur à -1 ou supérieur à 65 535.

Exemples

L’exemple suivant crée un UriBuilder instance qui contient l’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")

Remarques

Le UriBuilder instance est initialisé avec la Scheme propriété définie schemeNamesur , la Host propriété définie hostNamesur , la Port propriété définie sur portNumberet la Path propriété définie sur pathValue. Si extraValue commence par un signe numérique (#), Fragment est défini sur extraValue. Si extraValue commence par un point d’interrogation (?), Query est défini sur extraValue.

Si est portNumber défini sur une valeur de -1, cela indique que la valeur de port par défaut du schéma sera utilisée pour se connecter à l’hôte.

S’applique à