Uri.MakeRelative(Uri) Méthode
Définition
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.
Attention
The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202
Attention
Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).
Attention
Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.
Attention
The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202
Détermine la différence entre deux instances de Uri.
public:
System::String ^ MakeRelative(Uri ^ toUri);
[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")]
public string MakeRelative (Uri toUri);
[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")]
public string MakeRelative (Uri toUri);
[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")]
public string MakeRelative (Uri toUri);
[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")]
public string MakeRelative (Uri toUri);
public string MakeRelative (Uri toUri);
[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string
[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")>]
member this.MakeRelative : Uri -> string
[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")>]
member this.MakeRelative : Uri -> string
[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string
member this.MakeRelative : Uri -> string
Public Function MakeRelative (toUri As Uri) As String
Paramètres
- toUri
- Uri
URI à comparer à l'URI en cours.
Retours
Si le nom d'hôte et le schéma de cette instance d'URI et toUri
sont identiques, cette méthode retourne une String qui représente un URI relatif qui, lorsqu'il est ajouté à l'instance d'URI actuelle, donne le paramètre toUri
.
Si le nom d'hôte ou le schéma est différent, cette méthode retourne une String qui représente le paramètre toUri
.
- Attributs
Exceptions
toUri
a la valeur null
.
Cette instance représente un URI relatif ; cette méthode 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 = 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, toUri
et les résultats de l’appel MakeRelative.
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.