UriBuilder Constructeurs

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

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ôte UriBuilder , le numéro de port, le chemin d’accès et l’identificateur de chaîne de requête ou de fragment 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 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

UriBuilder(String)

Source:

UriBuilder.cs

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

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 « 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 une nouvelle instance de la UriBuilder classe avec les Fragmentpropriétés , Host, QueryPortSchemePath, et 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 : ».

UriBuilder(Uri)

Source:

UriBuilder.cs

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

ArgumentNullException

uri a la valeur null.

Remarques

Ce constructeur initialise une nouvelle instance de la UriBuilder classe avec les Fragmentpropriétés , Host, QueryPortSchemePath, et Uri définies comme spécifié dans .uri

UriBuilder(String, String)

Source:

UriBuilder.cs

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);

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

L’instance UriBuilder est initialisée 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 (/).

UriBuilder(String, String, Int32)

Source:

UriBuilder.cs

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);

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

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

L’instance UriBuilder est initialisée 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.

UriBuilder(String, String, Int32, String)

Source:

UriBuilder.cs

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);

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

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

L’instance UriBuilder est initialisée avec la Scheme propriété définie sur schemeName, 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.

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

Source:

UriBuilder.cs

Initialise une nouvelle instance de la classe avec le schéma, l’hôte UriBuilder , le numéro de port, le chemin d’accès et l’identificateur de chaîne de requête ou de fragment 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 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

ArgumentException

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

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

L’instance UriBuilder est initialisée avec la Scheme propriété définie sur schemeName, 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.