UriBuilder Constructeurs

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Initialise une nouvelle instance de la classe UriBuilder.

Surcharges

Nom	Description
UriBuilder()	Initialise une nouvelle instance de la classe UriBuilder.
UriBuilder(String)	Initialise une nouvelle instance de la UriBuilder classe avec l’URI spécifié.
UriBuilder(Uri)	Initialise une nouvelle instance de la UriBuilder classe avec l’instance spécifiée Uri .
UriBuilder(String, String)	Initialise une nouvelle instance de la UriBuilder classe avec le schéma et l’hôte spécifiés.
UriBuilder(String, String, Int32)	Initialise une nouvelle instance de la UriBuilder classe avec le schéma, l’hôte et le port spécifiés.
UriBuilder(String, String, Int32, String)	Initialise une nouvelle instance de la UriBuilder classe 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 UriBuilder classe avec le schéma, l’hôte, 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()

Source:

UriBuilder.cs

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
Host	« bouclage »
Mot de passe	Empty
Chemin	"/"
Port	-1
Requête	Empty
Scheme	« http »
Nom d’utilisateur	Empty

UriBuilder(String)

Source:

UriBuilder.cs

Initialise une nouvelle instance de la UriBuilder classe 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

ArgumentNullException

uri a la valeur null.

UriFormatException

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 « fichier ».

- ou -

uri n’est pas un URI valide.

Remarques

Ce constructeur initialise une nouvelle instance de la UriBuilder classe avec le Fragmentjeu de SchemePortQueryPathpropriétés , Hostet Uri les propriétés définies comme spécifié dans .uri

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

UriBuilder(Uri)

Source:

UriBuilder.cs

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

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

ArgumentNullException

uri a la valeur null.

Remarques

Ce constructeur initialise une nouvelle instance de la UriBuilder classe avec le Fragmentjeu de SchemePortQueryPathpropriétés , Hostet Uri les propriétés définies comme spécifié dans .uri

UriBuilder(String, String)

Source:

UriBuilder.cs

Initialise une nouvelle instance de la UriBuilder classe 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);

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 ou adresse IP de style DNS.

Exemples

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

Remarques

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

UriBuilder(String, String, Int32)

Source:

UriBuilder.cs

Initialise une nouvelle instance de la UriBuilder classe 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);

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 ou adresse IP de style DNS.

portNumber

Int32

Numéro de port IP du service.

Exceptions

ArgumentOutOfRangeException

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

Exemples

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

Remarques

L’instance UriBuilder est initialisée avec la Scheme propriété définie sur schemeName, la Host propriété définie hostNamesur et la Port propriété définie sur portNumber. La Path propriété est définie sur le caractère de barre oblique (/).

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

UriBuilder(String, String, Int32, String)

Source:

UriBuilder.cs

Initialise une nouvelle instance de la UriBuilder classe 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);

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 ou adresse IP de style DNS.

port

Int32

Numéro de port IP du service.

pathValue

String

Chemin d’accès à la ressource Internet.

Exceptions

ArgumentOutOfRangeException

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

Exemples

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

Remarques

L’instance UriBuilder est initialisée avec la Scheme propriété définie schemeNamesur , la Host propriété définie hostNamesur , la Port propriété définie portNumbersur et la Path propriété définie sur pathValue.

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

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

Source:

UriBuilder.cs

Initialise une nouvelle instance de la UriBuilder classe avec le schéma, l’hôte, 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);

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 ou adresse IP de style DNS.

port

Int32

Numéro de port IP du service.

path

String

Chemin d’accès à la ressource Internet.

extraValue

String

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

Exceptions

ArgumentException

extraValue n’est ni null ni ni Empty, ni un identificateur de fragment valide commence-t-il par un signe numérique (#), ni une chaîne de requête valide commence par un point d’interrogation ( ?).

ArgumentOutOfRangeException

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

Exemples

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

Remarques

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

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