Uri.MakeRelativeUri(Uri) Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

Uri.cs

Détermine la différence entre deux Uri instances.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);

public Uri MakeRelativeUri(Uri uri);

member this.MakeRelativeUri : Uri -> Uri

Public Function MakeRelativeUri (uri As Uri) As Uri

Paramètres

uri

Uri

URI à comparer à l’URI actuel.

Retours

Uri

Si le nom d’hôte et le schéma de cette instance d’URI sont uri identiques, cette méthode retourne un relatif Uri qui, lorsqu’elle est ajoutée à l’instance d’URI actuelle, génère uri.

Si le nom d’hôte ou le schéma est différent, cette méthode retourne un Uri paramètre qui représente le uri paramètre.

Exceptions

ArgumentNullException

uri a la valeur null.

InvalidOperationException

Cette instance représente un URI relatif et cette propriété est valide uniquement pour les URI absolus.

Exemples

L’exemple suivant crée 2 Uri instances. La différence dans les informations de chemin d’accès est écrite dans la console.

// Create a base Uri.
Uri address1 = new Uri("http://www.contoso.com/");

// Create a new Uri from a string.
Uri address2 = new Uri("http://www.contoso.com/index.htm?date=today");

// Determine the relative Uri.
Console.WriteLine("The difference is {0}", address1.MakeRelativeUri(address2));

// Create a base Uri.
let address1 = Uri "http://www.contoso.com/"

// Create a new Uri from a string.
let address2 = Uri "http://www.contoso.com/index.htm?date=today"

// Determine the relative Uri.
printfn $"The difference is {address1.MakeRelativeUri address2}"

    ' Create a base Uri.
    Dim address1 As New Uri("http://www.contoso.com/")
    
    ' Create a new Uri from a string.
    Dim address2 As New Uri("http://www.contoso.com/index.htm?date=today")
    
    ' Determine the relative Uri.  
    Console.WriteLine("The difference is {0}", address1.MakeRelativeUri(address2))

End Sub

Remarques

Le tableau suivant montre l’instance d’URI, toUriet les résultats de l’appel MakeRelativeUri.

Instance d’URI actuelle	toUri	Valeur renvoyée
http://www.contoso.com/	http://www.contoso.com/test/test.htm	test/test.htm
http://www.contoso.com/test1/	http://www.contoso.com/	../
http://www.contoso.com:8000/	http://www.contoso.com/test/test.htm	http://www.contoso.com/test/test.htm
http://username@www.contoso.com/	http://www.contoso.com/test1/test1.txt	test1/test1.txt

Les informations utilisateur, si elles sont présentes dans l’URI, sont ignorées.