Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Uri.GetLeftPart(UriPartial) Method

Определение

Возвращает заданную часть экземпляра Uri.Gets the specified portion of a Uri instance.

public:
 System::String ^ GetLeftPart(UriPartial part);
public string GetLeftPart (UriPartial part);
member this.GetLeftPart : UriPartial -> string
Public Function GetLeftPart (part As UriPartial) As String

Параметры

part
UriPartial UriPartial UriPartial UriPartial

Одно из значений UriPartial, которое указывает окончание возвращаемой части универсального кода ресурса.One of the UriPartial values that specifies the end of the URI portion to return.

Возвраты

Объект String, содержащий указанную часть экземпляра Uri.A String that contains the specified portion of the Uri instance.

Исключения

Текущий экземпляр Uri не является абсолютным.The current Uri instance is not an absolute instance.

Указанное значение part недопустимо.The specified part is not valid.

Примеры

В следующем примере создается Uri экземпляра и записывает путь на консоль.The following example creates a Uri instance and writes the path to the 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 the following output:
//        #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 the following output:
//        #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 the following output:
'        #search
'        Uri uses the default port
'        The path of this Uri is http://www.contoso.com/index.htm
'        Hash code -988419291

Комментарии

GetLeftPart Метод возвращает строку, содержащую слева в строке URI, с частью, заданной параметром part.The GetLeftPart method returns a string containing the leftmost portion of the URI string, ending with the portion specified by part.

GetLeftPart включает разделители в следующих случаях:GetLeftPart includes delimiters in the following cases:

  • Scheme содержит разделитель схемы.Scheme includes the scheme delimiter.

  • Authority отсутствует разделитель пути.Authority does not include the path delimiter.

  • Path включает разделители в исходный URI вплоть до разделителей запроса или фрагмента.Path includes any delimiters in the original URI up to the query or fragment delimiter.

  • Query включает в себя Path, а также запрос и разделитель.Query includes the Path, plus the query and its delimiter.

Ниже приведены примеры URI и результат вызова метода GetLeftPart с Scheme, Authority, Path, или Query.The following examples show a URI and the results of calling GetLeftPart with Scheme, Authority, Path, or Query.

URIURI СхемаScheme ЦентрAuthority ПутьPath ЗапросQuery
http://www.contoso.com/index.htm?date=today http://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:// http://www.contoso.com http://www.contoso.com/index.htm http://www.contoso.com/index.htm
mailto:user@contoso.com?subject=urimailto:user@contoso.com?subject=uri mailto:mailto: mailto:user@contoso.com mailto:user@contoso.com?subject=urimailto:user@contoso.com?subject=uri <none><none>
nntp://news.contoso.com/123456@contoso.com nntp://nntp:// nntp://news.contoso.comnntp://news.contoso.com nntp://news.contoso.com/123456@contoso.com nntp://news.contoso.com/123456@contoso.com
news:123456@contoso.com Новости.news: news:123456@contoso.com news:123456@contoso.com <none><none>
file://server/filename.extfile://server/filename.ext file://file:// file://serverfile://server file://server/filename.extfile://server/filename.ext file://server/filename.extfile://server/filename.ext

Применяется к