Uri.MakeRelativeUri(Uri) Méthode

Référence

Définition

Espace de noms:: System

Assemblys:: System.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: Uri.cs

Source:: Uri.cs

Source:: Uri.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 en cours.

Retours

Uri

Si le nom d'hôte et le schéma de cette instance d'URI et uri sont identiques, cette méthode retourne un Uri relatif qui, lorsqu'il est ajouté à l'instance d'URI actuelle, donne uri.

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

Exceptions

ArgumentNullException

uri a la valeur null.

InvalidOperationException

Cette instance représente un URI relatif, et cette propriété est uniquement valide 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 = gcnew Uri( "http://www.contoso.com/" );

// Create a new Uri from a string.
Uri^ address2 = gcnew 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.
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 MakeRelativeUride .

Instance d’URI actuelle	`toUri`	Valeur retourné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.

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Partager via