Uri Constructeurs

Définition

Initialise une nouvelle instance de la classe Uri.

Surcharges

Uri(String)

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

Uri(SerializationInfo, StreamingContext)
Obsolète.

Initialise une nouvelle instance de la classe Uri à partir des instances spécifiées des classes SerializationInfo et StreamingContext.

Uri(String, Boolean)
Obsolète.
Obsolète.
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.

Uri(String, UriCreationOptions)

Initialise une nouvelle instance de la classe avec l’URI Uri spécifié et des autres UriCreationOptions.

Uri(String, UriKind)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié. 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.

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.

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.

Uri(Uri, String, Boolean)
Obsolète.
Obsolète.
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.

Uri(String)

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

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

Paramètres

uriString
String

Chaîne qui identifie la ressource à représenter par l'instance de Uri. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets, par exemple « http://[2607:f8b0:400d:c06::69] ».

Exceptions

uriString a la valeur null.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez plutôt l’exception de la classe de base FormatException.

uriString est vide.

- ou -

Le schéma spécifié dans uriString n’est pas correctement mis en forme. Consultez CheckSchemeName(String).

- ou -

uriString contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte spécifié dans uriString n’est pas valide.

- ou -

Le nom de fichier spécifié dans uriString n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.

- ou -

Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.

- ou -

La longueur de uriString dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.

- ou -

Il existe une séquence de caractères non valide dans uriString.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Exemples

L’exemple suivant crée une Uri instance avec l’URI http://www.contoso.com/.

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

Remarques

Ce constructeur crée une Uri instance à partir d’une chaîne d’URI. Il analyse l’URI, le met au format canonique et effectue les encodages d’échappement nécessaires.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.

Ce constructeur part du principe que le string paramètre fait référence à un URI absolu et équivaut à appeler le Uri constructeur avec UriKind la valeur .Absolute Si le string paramètre passé au constructeur est un URI relatif, ce constructeur lève un UriFormatException.

S’applique à

Uri(SerializationInfo, StreamingContext)

Attention

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initialise une nouvelle instance de la classe Uri à partir des instances spécifiées des classes SerializationInfo et StreamingContext.

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Paramètres

serializationInfo
SerializationInfo

Instance de la classe SerializationInfo contenant les informations requises pour sérialiser la nouvelle instance de Uri.

streamingContext
StreamingContext

Instance de la classe StreamingContext contenant la source du flux sérialisé associé à la nouvelle instance de Uri.

Attributs

Exceptions

Le paramètre serializationInfo contient un URI null.

Le paramètre serializationInfo contient un URI qui est vide.

- ou -

Le schéma spécifié n’est pas mis en forme correctement. Consultez CheckSchemeName(String).

- ou -

L’URI contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans l’URI n’est pas valide.

- ou -

Le nom d’hôte spécifié dans l’URI n’est pas valide.

- ou -

Le nom de fichier spécifié dans l’URI n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans l’URI n’est pas valide.

- ou -

Le nom d’hôte ou d’autorité spécifié dans l’URI ne peut pas se terminer par des barres obliques inverses.

- ou -

Le numéro de port spécifié dans l’URI n’est pas valide ou ne peut pas être analysé.

- ou -

La longueur de l’URI dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans l’URI dépasse 1023 caractères.

- ou -

Il existe une séquence de caractères non valide dans l’URI.

- ou -

Le chemin MS-DOS spécifié dans l’URI doit commencer par c:\\.

Remarques

Ce constructeur implémente l’interface ISerializable pour la Uri classe .

Voir aussi

S’applique à

Uri(String, Boolean)

Attention

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

Attention

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.

Attention

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

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié et contrôle explicite de l'échappement des caractères.

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. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri (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")]
public Uri (string uriString, bool dontEscape);
public Uri (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. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<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")>]
new Uri : string * bool -> Uri
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

Paramètres

uriString
String

Chaîne qui identifie la ressource à représenter par l'instance de Uri. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets, par exemple « http://[2607:f8b0:400d:c06::69] ».

dontEscape
Boolean

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

Attributs

Exceptions

uriString a la valeur null.

uriString est vide ou contient uniquement des espaces.

- ou -

Le schéma spécifié dans uriString n'est pas valide.

- ou -

uriString contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte spécifié dans uriString n’est pas valide.

- ou -

Le nom de fichier spécifié dans uriString n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.

- ou -

Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.

- ou -

La longueur de uriString dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.

- ou -

Il existe une séquence de caractères non valide dans uriString.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Exemples

L’exemple suivant crée une Uri instance pour l’URI http://www.contoso.com/Hello%20World.htm. Étant donné que l’URI contenu est complètement placé dans une séquence d’échappement et est sous forme canonique, le dontEscape paramètre peut être défini sur 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);
let myUri = 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 Uri instance à partir d’une chaîne d’URI. Il analyse l’URI et le met au format canonique.

Le dontEscape paramètre contrôle si les caractères réservés sont traduits en séquences d’échappement. Ce paramètre doit être défini sur uniquement si vous êtes certain que tous les caractères réservés dans l’URI ont été placés true dans une séquence d’échappement. La définition de la valeur sur true pour un URI qui n’a pas été complètement échappé peut entraîner un comportement inattendu. Il est vivement recommandé de toujours définir ce paramètre sur 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. Si la séquence de caractères suivant un pourcentage n’est pas valide, le pourcentage est remplacé par %25.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.

S’applique à

Uri(String, UriCreationOptions)

Initialise une nouvelle instance de la Uri classe avec l’URI spécifié et un supplément .UriCreationOptions

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);
public Uri (string uriString, in UriCreationOptions creationOptions);
new Uri : string * UriCreationOptions -> Uri
Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Paramètres

uriString
String

Chaîne qui identifie la ressource à représenter par l'instance de Uri.

creationOptions
UriCreationOptions

Options qui contrôlent la façon dont le Uri est créé et se comporte.

S’applique à

Uri(String, UriKind)

Initialise une nouvelle instance de la classe Uri avec l'URI spécifié. 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.

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

Paramètres

uriString
String

Chaîne qui identifie la ressource à représenter par l'instance de Uri. Notez qu’une adresse IPv6 sous forme de chaîne doit être placée entre crochets, par exemple « http://[2607:f8b0:400d:c06::69] ».

uriKind
UriKind

Spécifie si la chaîne d'URI est un URI relatif, un URI absolu ou si elle est indéterminée.

Exceptions

uriKind n'est pas valide.

uriString a la valeur null.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez plutôt l’exception de la classe de base FormatException.

uriString contient un URI relatif et uriKind est Absolute.

ou

uriString contient un URI absolu et uriKind est Relative.

ou

uriString est vide.

- ou -

Le schéma spécifié dans uriString n’est pas correctement mis en forme. Consultez CheckSchemeName(String).

- ou -

uriString contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte spécifié dans uriString n’est pas valide.

- ou -

Le nom de fichier spécifié dans uriString n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans uriString n’est pas valide.

- ou -

Le nom d’hôte ou d’autorité spécifié dans uriString ne peut pas se terminer par des barres obliques inverses.

- ou -

Le numéro de port spécifié dans uriString n’est pas valide ou ne peut pas être analysé.

- ou -

La longueur de uriString dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans uriString dépasse 1 023 caractères.

- ou -

Il existe une séquence de caractères non valide dans uriString.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Remarques

Les URI relatifs et absolus ont des restrictions différentes sur leur format. Par exemple, un URI relatif ne nécessite pas de schéma ou d’autorité. La valeur que vous spécifiez dans uriKind doit correspondre au type d’URI passé dans uriString. Toutefois, si RelativeOrAbsolute est spécifié, la chaîne d’URI peut être relative ou absolue.

S’applique à

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.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri (Uri baseUri, 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 de base.

relativeUri
String

URI relatif à ajouter à l'identificateur de base.

Exceptions

baseUri a la valeur null.

baseUri n’est pas une instance absolue de Uri.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez plutôt l’exception de la classe de base FormatException.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.

- ou -

Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

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.

- ou -

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é.

- ou -

La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.

- ou -

L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Exemples

L’exemple suivant crée une instance de la Uri classe en combinant les URI http://www.contoso.com relatifs et catalog/shownew.htm pour former l’URI http://www.contoso.com/catalog/shownew.htmabsolu .

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());
let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"
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 Uri instance en combinant le baseUri et le 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 est créée à l’aide Uri uniquement relativeUride .

Si le baseUri a des parties relatives (comme /api), la partie relative doit être terminée par une barre oblique ( par exemple /api/), si la partie relative de baseUri doit être conservée dans le construit Uri.

En outre, si le relativeUri commence par une barre oblique, il remplacera toute partie relative du baseUri

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.

S’applique à

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.

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 absolu qui est la base de la nouvelle instance de Uri.

relativeUri
Uri

Instance de Uri relative qui est combinée avec baseUri.

Exceptions

baseUri n’est pas une instance absolue de Uri.

baseUri a la valeur null.

baseUri n’est pas une instance absolue de Uri.

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez plutôt l’exception de la classe de base FormatException.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.

- ou -

Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

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.

- ou -

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é.

- ou -

La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.

- ou -

L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Exemples

Cet exemple crée une instance absolue Uri , absoluteUriet une instance relative Uri , relativeUri. Une nouvelle Uri instance, combinedUri, est ensuite créée à partir de ces deux 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.
let absoluteUri = Uri "http://www.contoso.com/"

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

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{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 instance en combinant une Uri instance absolue Uri , baseUri, avec une instance relative Uri , relativeUri. Si relativeUri est une instance absolue Uri (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance est créée à l’aide Uri uniquement relativeUride .

Si le baseUri a des parties relatives (comme /api), la partie relative doit être terminée par une barre oblique ( par exemple /api/), si la partie relative de baseUri doit être conservée dans le construit Uri.

En outre, si le relativeUri commence par une barre oblique, il remplacera toute partie relative du baseUri

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.

S’applique à

Uri(Uri, String, Boolean)

Attention

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

Attention

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.

Attention

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

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.

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. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri (Uri baseUri, 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")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);
public Uri (Uri baseUri, 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. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, 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. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<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")>]
new Uri : Uri * string * bool -> Uri
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Paramètres

baseUri
Uri

URI de base.

relativeUri
String

URI relatif à ajouter à l'identificateur de base.

dontEscape
Boolean

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

Attributs

Exceptions

baseUri a la valeur null.

baseUri n’est pas une instance absolue de Uri.

L’URI formé en combinant baseUri et relativeUri est vide ou contient uniquement des espaces.

- ou -

Le schéma spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

L’URI formé en combinant baseUri et relativeUri contient trop de barres obliques.

- ou -

Le mot de passe spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’hôte spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom de fichier spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

Le nom d’utilisateur spécifié dans l’URI formé en combinant baseUri et relativeUri n’est pas valide.

- ou -

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.

- ou -

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é.

- ou -

La longueur de l’URI formé en combinant baseUri et relativeUri dépasse 65 519 caractères.

- ou -

La longueur du schéma spécifié dans l’URI formé en combinant baseUri et relativeUri dépasse 1 023 caractères.

- ou -

L’URI formé en combinant baseUri et relativeUri contient une séquence de caractères non valide.

- ou -

Le chemin MS-DOS spécifié dans uriString doit commencer par c:\\.

Exemples

L’exemple suivant crée une instance de la Uri classe en combinant les URI http://www.contoso.com relatifs et Hello%20World.htm en formant un URI absolu.

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);
let baseUri = Uri "http://www.contoso.com"
let myUri = 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 Uri instance en baseUri combinant et relativeUri. Si l’URI transmis relativeUri est un URI absolu (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance est créée uniquement relativeUrià l’aide Uri de .

Le dontEscape paramètre contrôle si les caractères réservés sont traduits en séquences d’échappement. Ce paramètre doit être défini sur true uniquement si vous êtes certain que tous les caractères réservés de l’URI ont été placés dans une séquence d’échappement. La définition de la valeur sur true pour un URI qui n’a pas été complètement placé dans une séquence d’échappement peut entraîner un comportement inattendu. Il est vivement recommandé de toujours définir ce paramètre sur 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. Si la séquence de caractères suivant un pourcentage n’est pas valide, le pourcentage est remplacé par %25.

Ce constructeur ne garantit pas que le Uri fait référence à une ressource accessible.

Notes pour les appelants

Pour des raisons de sécurité, votre application ne doit pas appeler ce constructeur avec des chaînes d’URI provenant de sources non approuvées et avec dontEscape la valeur true. Vous pouvez également vérifier la validité d’une chaîne d’URI en appelant la IsWellFormedOriginalString() méthode avant d’appeler ce constructeur.

S’applique à