Uri.MakeRelativeUri(Uri) Metodo

Definizione

Determina la differenza tra due istanze di Uri.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);
public Uri MakeRelativeUri (Uri uri);
member this.MakeRelativeUri : Uri -> Uri
Public Function MakeRelativeUri (uri As Uri) As Uri

Parametri

uri
Uri

URI da confrontare con l'URI corrente.

Restituisce

Uri

Se il nome host e lo schema di questa istanza di URI e uri sono identici, questo metodo restituisce un oggetto Uri relativo che, se aggiunto all'istanza di URI corrente, restituisce uri.

Se il nome host o lo schema è differente, questo metodo restituisce un oggetto Uri che rappresenta il parametro uri.

Eccezioni

uri è null.

Questa istanza rappresenta un URI relativo e questa proprietà è valida solo per URI assoluti.

Esempio

Nell'esempio seguente vengono create 2 Uri istanze. La differenza nelle informazioni sul percorso viene scritta nella 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

Commenti

Nella tabella seguente viene illustrata l'istanza dell'URI, toUrie i risultati della chiamata MakeRelativeUri.

Istanza URI corrente toUri Valore restituito
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

Le informazioni utente, se presenti nell'URI, vengono ignorate.

Si applica a