Uri.GetLeftPart(UriPartial) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

Uri.cs

Obtient la partie spécifiée d'une instance Uri.

public:
 System::String ^ GetLeftPart(UriPartial part);

public string GetLeftPart (UriPartial part);

member this.GetLeftPart : UriPartial -> string

Public Function GetLeftPart (part As UriPartial) As String

Paramètres

part

UriPartial

Une des valeurs d’énumération qui spécifie la fin de la partie URI à retourner.

Retours

String

Partie spécifiée de l’instance Uri.

Exceptions

InvalidOperationException

L'instance de Uri en cours n'est pas une instance absolue.

ArgumentException

La valeur part spécifiée n'est pas valide.

Exemples

L’exemple suivant crée un Uri instance et écrit le chemin d’accès dans la console.

// Create Uri
Uri^ uriAddress = gcnew Uri( "http://www.contoso.com/index.htm#search" );
Console::WriteLine( uriAddress->Fragment );
Console::WriteLine( "Uri {0} the default port ", uriAddress->IsDefaultPort ? (String^)"uses" : "does not use" );

Console::WriteLine( "The path of this Uri is {0}", uriAddress->GetLeftPart( UriPartial::Path ) );
Console::WriteLine( "Hash code {0}", uriAddress->GetHashCode() );
// The example displays output similar to the following:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291

// Create Uri
Uri uriAddress = new Uri("http://www.contoso.com/index.htm#search");
Console.WriteLine(uriAddress.Fragment);
Console.WriteLine("Uri {0} the default port ", uriAddress.IsDefaultPort ? "uses" : "does not use");

Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path));
Console.WriteLine("Hash code {0}", uriAddress.GetHashCode());
// The example displays output similar to the following:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291

// Create Uri
let uriAddress = Uri "http://www.contoso.com/index.htm#search"
printfn $"{uriAddress.Fragment}"
printfn $"""Uri {if uriAddress.IsDefaultPort then "uses" else "does not use"} the default port """

printfn $"The path of this Uri is {uriAddress.GetLeftPart UriPartial.Path}"
printfn $"Hash code {uriAddress.GetHashCode()}"
// The example displays output similar to the following:
//        #search
//        Uri uses the default port
//        The path of this Uri is http://www.contoso.com/index.htm
//        Hash code -988419291

' Create Uri
Dim uriAddress As New Uri("http://www.contoso.com/index.htm#search")
Console.WriteLine(uriAddress.Fragment)
Console.WriteLine("Uri {0} the default port ", If(uriAddress.IsDefaultPort, "uses", "does not use")) 

Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path))
Console.WriteLine("Hash code {0}", uriAddress.GetHashCode())
' The example displays output similar to the following:
'        #search
'        Uri uses the default port
'        The path of this Uri is http://www.contoso.com/index.htm
'        Hash code -988419291

Remarques

La GetLeftPart méthode retourne une chaîne contenant la partie la plus à gauche de la chaîne d’URI, se terminant par la partie spécifiée par part.

GetLeftPart inclut des délimiteurs dans les cas suivants :

• Scheme inclut le délimiteur de schéma.
• Authority n’inclut pas le délimiteur de chemin d’accès.
• Path inclut le délimiteur de chemin d’accès et tous les délimiteurs de l’URI d’origine jusqu’au délimiteur de requête ou de fragment.
• Query inclut , Pathplus la requête et son délimiteur.

Les exemples suivants montrent un URI et les résultats de l’appel GetLeftPart avec Scheme, Authority, Pathou Query.

URI	Schéma	Authority	Chemin d’accès	Query
http://www.contoso.com/index.htm?date=today	http://	http://www.contoso.com	http://www.contoso.com/index.htm	http://www.contoso.com/index.htm?date=today
http://www.contoso.com/index.htm#main	http://	http://www.contoso.com	http://www.contoso.com/index.htm	http://www.contoso.com/index.htm
mailto:user@contoso.com?subject=uri	mailto:	<none>	mailto:user@contoso.com	mailto:user@contoso.com?subject=uri
nntp://news.contoso.com/123456@contoso.com	nntp://	nntp://news.contoso.com	nntp://news.contoso.com/123456@contoso.com	nntp://news.contoso.com/123456@contoso.com
news:123456@contoso.com	news:	<none>	news:123456@contoso.com	news:123456@contoso.com
file://server/filename.ext	file://	file://server	file://server/filename.ext	file://server/filename.ext