Uri Uri Uri Uri Constructors

Définition

Surcharges

Uri(String) Uri(String) Uri(String) Uri(String)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié.Initializes a new instance of the Uri class with the specified URI.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe Uri à partir des instances spécifiées des classes SerializationInfo et StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié et contrôle explicite de l'échappement des caractères.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié.Initializes a new instance of the Uri class with the specified URI. Ce constructeur vous permet de spécifier si la chaîne d'URI est un URI relatif, un URI absolu ou si elle est indéterminée.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Initialise une nouvelle instance de la classe Uri fondée sur l'URI de base et la chaîne URI relative spécifiés.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Initialise une nouvelle instance de la classe Uri en s'appuyant sur la combinaison d'une instance de Uri de base et d'une instance de Uri relative.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Initialise une nouvelle instance de la classe Uri fondée sur les URI de base et relatifs spécifiés, avec contrôle explicite de l'échappement des caractères.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

Uri(String) Uri(String) Uri(String) Uri(String)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié.Initializes a new instance of the Uri class with the specified URI.

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

Paramètres

uriString
String String String String

Chaîne qui identifie la ressource à représenter par l'instance de Uri.A string that identifies the resource to be represented by the Uri instance. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets,Note that an IPv6 address in string form must be enclosed within brackets. par exemple « http://[2607:f8b0:400d:c06::69] ».For example, "http://[2607:f8b0:400d:c06::69]".

Exceptions

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString est vide.uriString is empty.

ou-or- Le schéma spécifié dans uriString n’est pas correctement mis en forme.The scheme specified in uriString is not correctly formed. Consultez CheckSchemeName(String).See CheckSchemeName(String).

ou-or- uriString contient trop de barres obliques.uriString contains too many slashes.

- ou --or- Le mot de passe spécifié dans uriString n’est pas valide.The password specified in uriString is not valid.

- ou --or- Le nom d’hôte spécifié dans uriString n’est pas valide.The host name specified in uriString is not valid.

ou-or- Le nom de fichier spécifié dans uriString n’est pas valide.The file name specified in uriString is not valid.

ou-or- Le nom d’utilisateur spécifié dans uriString n’est pas valide.The user name specified in uriString is not valid.

- ou --or- Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in uriString cannot be terminated by backslashes.

- ou --or- Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.The port number specified in uriString is not valid or cannot be parsed.

- ou --or- La longueur de uriString dépasse 65 519 caractères.The length of uriString exceeds 65519 characters.

- ou --or- La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.The length of the scheme specified in uriString exceeds 1023 characters.

- ou --or- Il existe une séquence de caractères non valide dans uriString.There is an invalid character sequence in uriString.

- ou --or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemples

L’exemple suivant crée une instance Uri avec l’URI http://www.contoso.com/.The following example creates a Uri instance with the URI http://www.contoso.com/.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri myUri = new Uri("http://www.contoso.com/");

Dim myUri As New Uri("http://www.contoso.com/")

Remarques

Ce constructeur crée une instance Uri à partir d’une chaîne d’URI.This constructor creates a Uri instance from a URI string. Il analyse l’URI, le met au format canonique et effectue tous les encodages d’échappement requis.It parses the URI, puts it in canonical format, and makes any required escape encodings.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.This constructor does not ensure that the Uri refers to an accessible resource.

Ce constructeur suppose que le paramètre string fait référence à un URI absolu et équivaut à appeler le constructeur Uri avec UriKind défini sur Absolute.This constructor assumes that the string parameter references an absolute URI and is equivalent to calling the Uri constructor with UriKind set to Absolute. Si le paramètre string passé au constructeur est un URI relatif, ce constructeur lèvera une UriFormatException.If the string parameter passed to the constructor is a relative URI, this constructor will throw a UriFormatException.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe Uri à partir des instances spécifiées des classes SerializationInfo et StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Paramètres

serializationInfo
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

Instance de la classe SerializationInfo contenant les informations requises pour sérialiser la nouvelle instance de Uri.An instance of the SerializationInfo class containing the information required to serialize the new Uri instance.

streamingContext
StreamingContext StreamingContext StreamingContext StreamingContext

Instance de la classe StreamingContext contenant la source du flux sérialisé associé à la nouvelle instance de Uri.An instance of the StreamingContext class containing the source of the serialized stream associated with the new Uri instance.

Exceptions

Le paramètre serializationInfo contient un URI null.The serializationInfo parameter contains a null URI.

Le paramètre serializationInfo contient un URI qui est vide.The serializationInfo parameter contains a URI that is empty.

ou-or- Le schéma spécifié n’est pas mis en forme correctement.The scheme specified is not correctly formed. Consultez CheckSchemeName(String).See CheckSchemeName(String).

- ou --or- L’URI contient trop de barres obliques.The URI contains too many slashes.

ou-or- Le mot de passe spécifié dans l’URI n’est pas valide.The password specified in the URI is not valid.

ou-or- Le nom d’hôte spécifié dans l’URI n’est pas valide.The host name specified in URI is not valid.

ou-or- Le nom de fichier spécifié dans l’URI n’est pas valide.The file name specified in the URI is not valid.

- ou --or- Le nom d’utilisateur spécifié dans l’URI n’est pas valide.The user name specified in the URI is not valid.

- ou --or- Le nom d’hôte ou d’autorité spécifié dans l’URI ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in the URI cannot be terminated by backslashes.

- ou --or- Le numéro de port spécifié dans l’URI n’est pas valide ou ne peut pas être analysé.The port number specified in the URI is not valid or cannot be parsed.

- ou --or- La longueur de l’URI dépasse 65 519 caractères.The length of URI exceeds 65519 characters.

ou-or- La longueur du schéma spécifié dans l’URI dépasse 1023 caractères.The length of the scheme specified in the URI exceeds 1023 characters.

- ou --or- Il existe une séquence de caractères non valide dans l’URI.There is an invalid character sequence in the URI.

ou-or- Le chemin MS-DOS spécifié dans l’URI doit commencer par c:\\.The MS-DOS path specified in the URI must start with c:\\.

Remarques

Ce constructeur implémente l’interface ISerializable pour la classe Uri.This constructor implements the ISerializable interface for the Uri class.

Voir aussi

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Avertissement

Cette API est désormais obsolète.

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié et contrôle explicite de l'échappement des caractères.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

public:
 Uri(System::String ^ uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

Paramètres

uriString
String String String String

Chaîne qui identifie la ressource à représenter par l'instance de Uri.A string that identifies the resource to be represented by the Uri instance. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets,Note that an IPv6 address in string form must be enclosed within brackets. par exemple « http://[2607:f8b0:400d:c06::69] ».For example, "http://[2607:f8b0:400d:c06::69]".

dontEscape
Boolean Boolean Boolean Boolean

true si uriString est entièrement converti en séquence d'échappement ; sinon, false.true if uriString is completely escaped; otherwise, false.

Exceptions

uriString est vide ou contient uniquement des espaces.uriString is empty or contains only spaces.

ou-or- Le schéma spécifié dans uriString n'est pas valide.The scheme specified in uriString is not valid.

ou-or- uriString contient trop de barres obliques.uriString contains too many slashes.

- ou --or- Le mot de passe spécifié dans uriString n’est pas valide.The password specified in uriString is not valid.

ou-or- Le nom d’hôte spécifié dans uriString n’est pas valide.The host name specified in uriString is not valid.

ou-or- Le nom de fichier spécifié dans uriString n’est pas valide.The file name specified in uriString is not valid.

ou-or- Le nom d’utilisateur spécifié dans uriString n’est pas valide.The user name specified in uriString is not valid.

ou-or- Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in uriString cannot be terminated by backslashes.

ou-or- Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.The port number specified in uriString is not valid or cannot be parsed.

ou-or- La longueur de uriString dépasse 65 519 caractères.The length of uriString exceeds 65519 characters.

- ou --or- La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.The length of the scheme specified in uriString exceeds 1023 characters.

- ou --or- Il existe une séquence de caractères non valide dans uriString.There is an invalid character sequence in uriString.

ou-or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemples

L’exemple suivant crée une instance Uri pour l’URI http://www.contoso.com/Hello%20World.htm.The following example creates a Uri instance for the URI http://www.contoso.com/Hello%20World.htm. Étant donné que l’URI contenu est entièrement placé dans une séquence d’échappement et se présente sous une forme canonique, le paramètre dontEscape peut avoir la valeur true.Because the contained URI is completely escaped and is in canonical form, the dontEscape parameter can be set to true.

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );
Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

Remarques

Ce constructeur crée une instance Uri à partir d’une chaîne d’URI.This constructor creates a Uri instance from a URI string. Il analyse l’URI et le met au format canonique.It parses the URI and puts it in canonical format.

Le paramètre dontEscape contrôle si les caractères réservés sont convertis en séquences d’échappement.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Ce paramètre doit avoir la valeur true uniquement si vous êtes certain que tous les caractères réservés dans l’URI ont été placés dans une séquence d’échappement.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. La définition de la valeur à true pour un URI qui n’a pas été complètement échappé peut entraîner un comportement inattendu.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. Il est fortement recommandé de toujours définir ce paramètre sur false.It is strongly recommended that you always set this parameter to false.

Si dontEscape a la valeur false, le constructeur échappe tous les caractères réservés en vérifiant que toutes les occurrences de pourcentage (%) sont suivies d’une séquence d’échappement valide.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Si la séquence de caractères qui suit un pourcentage n’est pas valide, le pourcentage est remplacé par% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié.Initializes a new instance of the Uri class with the specified URI. Ce constructeur vous permet de spécifier si la chaîne d'URI est un URI relatif, un URI absolu ou si elle est indéterminée.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri (string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri

Paramètres

uriString
String String String String

Chaîne qui identifie la ressource à représenter par l'instance de Uri.A string that identifies the resource to be represented by the Uri instance. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets,Note that an IPv6 address in string form must be enclosed within brackets. par exemple « http://[2607:f8b0:400d:c06::69] ».For example, "http://[2607:f8b0:400d:c06::69]".

uriKind
UriKind UriKind UriKind UriKind

Spécifie si la chaîne d'URI est un URI relatif, un URI absolu ou si elle est indéterminée.Specifies whether the URI string is a relative URI, absolute URI, or is indeterminate.

Exceptions

uriKind n'est pas valide.uriKind is invalid.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString contient un URI relatif et uriKind est Absolute.uriString contains a relative URI and uriKind is Absolute.

ouor uriString contient un URI absolu et uriKind est Relative.uriString contains an absolute URI and uriKind is Relative.

ouor uriString est vide.uriString is empty.

ou-or- Le schéma spécifié dans uriString n’est pas correctement mis en forme.The scheme specified in uriString is not correctly formed. Consultez CheckSchemeName(String).See CheckSchemeName(String).

ou-or- uriString contient trop de barres obliques.uriString contains too many slashes.

- ou --or- Le mot de passe spécifié dans uriString n’est pas valide.The password specified in uriString is not valid.

- ou --or- Le nom d’hôte spécifié dans uriString n’est pas valide.The host name specified in uriString is not valid.

ou-or- Le nom de fichier spécifié dans uriString n’est pas valide.The file name specified in uriString is not valid.

- ou --or- Le nom d’utilisateur spécifié dans uriString n’est pas valide.The user name specified in uriString is not valid.

ou-or- Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in uriString cannot be terminated by backslashes.

- ou --or- Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.The port number specified in uriString is not valid or cannot be parsed.

- ou --or- La longueur de uriString dépasse 65 519 caractères.The length of uriString exceeds 65519 characters.

- ou --or- La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.The length of the scheme specified in uriString exceeds 1023 characters.

ou-or- Il existe une séquence de caractères non valide dans uriString.There is an invalid character sequence in uriString.

- ou --or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Remarques

Les URI relatifs et absolus ont des restrictions différentes quant à leur format.Relative and absolute URIs have different restrictions on their format. Par exemple, un URI relatif ne nécessite pas de schéma ou d’autorité.For example, a relative URI does not require a scheme or an authority. La valeur que vous spécifiez dans uriKind doit correspondre au type d’URI passé uriString.The value you specify in uriKind must match the type of URI passed in uriString. Toutefois, si RelativeOrAbsolute est spécifié, la chaîne d’URI peut être relative ou absolue.However, if RelativeOrAbsolute is specified, the URI string can be relative or absolute.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Initialise une nouvelle instance de la classe Uri fondée sur l'URI de base et la chaîne URI relative spécifiés.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri (Uri baseUri, string relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

Paramètres

baseUri
Uri Uri Uri Uri

URI de base.The base URI.

relativeUri
String String String String

URI relatif à ajouter à l'identificateur de base.The relative URI to add to the base URI.

Exceptions

baseUri n’est pas une instance absolue de Uri.baseUri is not an absolute Uri instance.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

ou-or- Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.The URI formed by combining baseUri and relativeUri contains too many slashes.

- ou --or- Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

ou-or- Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’hôte ou d’autorité spécifié dans l’URI formé en combinant baseUri et relativeUri ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

ou-or- Le numéro de port spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide ou ne peut pas être analysé.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

ou-or- La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

- ou --or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemples

L’exemple suivant crée une nouvelle instance de la classe Uri en combinant les URI relatifs http://www.contoso.com et catalog/shownew.htm pour former l’URI absolu http://www.contoso.com/catalog/shownew.htm.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and catalog/shownew.htm to form the absolute URI http://www.contoso.com/catalog/shownew.htm.

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );
Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());
   
Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

Remarques

Ce constructeur crée une instance Uri en combinant le baseUri et le relativeUri.This constructor creates a Uri instance by combining the baseUri and the relativeUri. Si relativeUri est un URI absolu (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée à l’aide uniquement de relativeUri.If relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Si le baseUri a des parties relatives (comme /api), la partie relative doit se terminer par une barre oblique, (comme /api/), si la partie relative de baseUri doit être conservée dans le @no__t construit-4.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

En outre, si le relativeUri commence par une barre oblique, il remplace toute partie relative du baseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Initialise une nouvelle instance de la classe Uri en s'appuyant sur la combinaison d'une instance de Uri de base et d'une instance de Uri relative.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);
public Uri (Uri baseUri, Uri relativeUri);
new Uri : Uri * Uri -> Uri
Public Sub New (baseUri As Uri, relativeUri As Uri)

Paramètres

baseUri
Uri Uri Uri Uri

Uri absolu qui est la base de la nouvelle instance de Uri.An absolute Uri that is the base for the new Uri instance.

relativeUri
Uri Uri Uri Uri

Instance de Uri relative qui est combinée avec baseUri.A relative Uri instance that is combined with baseUri.

Exceptions

baseUri n’est pas une instance absolue de Uri.baseUri is not an absolute Uri instance.

baseUri n’est pas une instance absolue de Uri.baseUri is not an absolute Uri instance.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

ou-or- Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.The URI formed by combining baseUri and relativeUri contains too many slashes.

ou-or- Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

ou-or- Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

ou-or- Le nom d’hôte ou d’autorité spécifié dans l’URI formé en combinant baseUri et relativeUri ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

- ou --or- Le numéro de port spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide ou ne peut pas être analysé.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

- ou --or- La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

- ou --or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemples

Cet exemple crée une instance absolue Uri, absoluteUri et une instance Uri relative, relativeUri.This example creates an absolute Uri instance, absoluteUri, and a relative Uri instance, relativeUri. Une nouvelle instance de Uri, combinedUri, est ensuite créée à partir de ces deux instances.A new Uri instance, combinedUri, is then created from these two instances.

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// Check whether the new Uri is absolute or relative.
if (  !relativeUri->IsAbsoluteUri )
   Console::WriteLine( "{0} is a relative Uri.", relativeUri );

// Create a new Uri from an absolute Uri and a relative Uri.
Uri^ combinedUri = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );
   // Create an absolute Uri from a string.
   Uri absoluteUri = new Uri("http://www.contoso.com/");

   // Create a relative Uri from a string.  allowRelative = true to allow for 
   // creating a relative Uri.
   Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

   // Check whether the new Uri is absolute or relative.
   if (!relativeUri.IsAbsoluteUri)
       Console.WriteLine("{0} is a relative Uri.", relativeUri);

   // Create a new Uri from an absolute Uri and a relative Uri.
   Uri combinedUri = new Uri(absoluteUri, relativeUri);
   Console.WriteLine(combinedUri.AbsoluteUri);
    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

Remarques

Ce constructeur crée une nouvelle instance Uri en combinant une instance Uri absolue, baseUri, avec une instance Uri relative, relativeUri.This constructor creates a new Uri instance by combining an absolute Uri instance, baseUri, with a relative Uri instance, relativeUri. Si relativeUri est une instance Uri absolue (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée uniquement à l’aide de relativeUri.If relativeUri is an absolute Uri instance (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Si le baseUri a des parties relatives (comme /api), la partie relative doit se terminer par une barre oblique, (comme /api/), si la partie relative de baseUri doit être conservée dans le @no__t construit-4.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

En outre, si le relativeUri commence par une barre oblique, il remplace toute partie relative du baseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Avertissement

Cette API est désormais obsolète.

Initialise une nouvelle instance de la classe Uri fondée sur les URI de base et relatifs spécifiés, avec contrôle explicite de l'échappement des caractères.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Paramètres

baseUri
Uri Uri Uri Uri

URI de base.The base URI.

relativeUri
String String String String

URI relatif à ajouter à l'identificateur de base.The relative URI to add to the base URI.

dontEscape
Boolean Boolean Boolean Boolean

true si uriString est entièrement converti en séquence d'échappement ; sinon, false.true if uriString is completely escaped; otherwise, false.

Exceptions

baseUri n’est pas une instance absolue de Uri.baseUri is not an absolute Uri instance.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

ou-or- Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.The URI formed by combining baseUri and relativeUri contains too many slashes.

- ou --or- Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

ou-or- Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

ou-or- Le nom d’hôte ou d’autorité spécifié dans l’URI formé en combinant baseUri et relativeUri ne peut pas se terminer par des barres obliques inverses.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

ou-or- Le numéro de port spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide ou ne peut pas être analysé.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

- ou --or- La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

ou-or- Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemples

L’exemple suivant crée une nouvelle instance de la classe Uri en combinant les URI relatifs http://www.contoso.com et Hello%20World.htm pour former un URI absolu.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and Hello%20World.htm to form an absolute URI.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );
 Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

Remarques

Ce constructeur crée une instance Uri en combinant baseUri et relativeUri.This constructor creates a Uri instance by combining baseUri and relativeUri. Si l’URI passé relativeUri est un URI absolu (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée uniquement à l’aide de relativeUri.If the URI passed in relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Le paramètre dontEscape contrôle si les caractères réservés sont convertis en séquences d’échappement.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Ce paramètre doit avoir la valeur true uniquement si vous êtes certain que tous les caractères réservés dans l’URI ont été placés dans une séquence d’échappement.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. La définition de la valeur à true pour un URI qui n’a pas été complètement échappé peut entraîner un comportement inattendu.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. Il est fortement recommandé de toujours définir ce paramètre sur false.It is strongly recommended that you always set this parameter to false. Si dontEscape a la valeur false, le constructeur échappe tous les caractères réservés en vérifiant que toutes les occurrences de pourcentage (%) sont suivies d’une séquence d’échappement valide.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Si la séquence de caractères qui suit un pourcentage n’est pas valide, le pourcentage est remplacé par% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.This constructor does not ensure that the Uri refers to an accessible resource.

Notes pour les appelants

En raison des problèmes de sécurité, votre application ne doit pas appeler ce constructeur avec des chaînes URI provenant de sources non approuvées et avec dontEscape défini sur true.Because of security concerns, your application should not call this constructor with URI strings from untrusted sources and with dontEscape set to true. Vous pouvez également vérifier la validité d’une chaîne d’URI en appelant la méthode IsWellFormedOriginalString() avant d’appeler ce constructeur.Alternately, you can check a URI string for validity by calling the IsWellFormedOriginalString() method prior to calling this constructor.

S’applique à