URI Class

Анализирует универсальные коды ресурсов (URI).

.NET:  Этот тип отображается как System.Uri.

Синтаксис


var uri = new Windows.Foundation.Uri(string);
var uri = new Windows.Foundation.Uri(string, string);

Атрибуты

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Члены

UriКласс имеет следующие типы членов:

Конструкторы

UriКласс имеет эти конструкторы.

КонструкторОписание
Uri(String) Creates a Uniform Resource Identifier (URI) from the specified string.
Uri(String, String) Creates a Uniform Resource Identifier (URI) by combining a base Uniform Resource Identifier (URI) and a relative Uniform Resource Identifier (URI).

 

Методы

The Uri Класс имеет следующие методы. В C#, Visual Basic и C++ также наследует методы от Object Класс.

МетодОписание
CombineUri Adds the specified Uniform Resource Identifier (URI) to the current Uniform Resource Identifier (URI).
Equals(Uri) Determines whether the specified Uniform Resource Identifier (URI) is equal to the current Uniform Resource Identifier (URI).
EscapeComponent Converts a URI string to its escaped representation.
ToString Gets a canonical string representation for the current Uri.
UnescapeComponent Converts the specified string by replacing any escape sequences with their unescaped representation.

 

Свойства

UriКласс имеет следующие свойства.

СвойствоТип доступаОписание

AbsoluteCanonicalUri

Только для чтенияGets a fully canonicalized RFC-complaint representation of the current URI.

AbsoluteUri

Только для чтенияGets the entire, non-canonical IRI.

DisplayIri

Только для чтенияGets the decoded unicode characters that make up the current URI.

DisplayUri

Только для чтенияGets a representation of the IRI that can be used for display purposes.

Domain

Только для чтенияGets the domain name, including top-level domain, from a Uniform Resource Identifier (URI).

Extension

Только для чтенияGets the file name extension of the resource that is referenced in the Uniform Resource Identifier (URI).

Fragment

Только для чтенияGets the text following a fragment marker (#), including the fragment marker itself.

Host

Только для чтенияGets the fully qualified domain name.

Password

Только для чтенияGets the password, as parsed from a Uniform Resource Identifier (URI).

Path

Только для чтенияGets the path and resource name.

Port

Только для чтенияGets the port number.

Query

Только для чтенияGets the query string.

QueryParsed

Только для чтенияGets a parsed URL query string.

RawUri

Только для чтенияGets the entire original Uniform Resource Identifier (URI) string.

SchemeName

Только для чтенияGets the protocol scheme name.

Suspicious

Только для чтенияGets a value that indicates whether the Uniform Resource Identifier (URI) is not well-formed.

UserName

Только для чтенияGets the user name as parsed from a Uniform Resource Identifier (URI).

 

Примечания

При построении приложений Магазина Windows с использованием платформы Microsoft .NET Framework этот класс скрыт, и разработчики должны использовать класс System.Uri, в котором для кодирования и декодирования универсальных кодов ресурсов (URI) используется стандарт RFC 3987. Класс Uri не кодирует не входящие в набор ASCII символы в универсальных кодах ресурсов, начинающихся с file://, с использованием знака процента, и интерпретирует процентную кодировку с использованием текущей кодовой страницы пользователя.

Ниже показаны составные части примера универсального кода ресурса (URI).

scheme://username:password@host:port/path.extension?query#fragment

Примеры.

ftp://user:password@ftp.microsoft.com:8080/path/bin/file.asp?q=query#fragment

В этом примере:

  • scheme равно ftp
  • host равно ftp.microsoft.com
  • domain имеет значение microsoft.com (является подмножеством host).
  • port равно 8080
  • extension равно asp

Примеры

В этом примере создается URI, в котором используется HTTP-протокол для доступа к веб-сайту.


// The URI string
var uriToLaunch = "http://www.bing.com";

// Create a Uri object from the URI string 
var uri = new Windows.Foundation.Uri(uriToLaunch);

В этом примере создается URI, в котором используется протокол ms-appx для доступа к файлу изображения в пакете приложения.


// The URI string
var uriImage = "ms-appx:///images/SecondaryTileDefault-sdk.png";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriImage);

В этом примере создается URI, в котором используется протокол ms-appdata для доступа к локальному хранилищу данных приложения.


// The URI string
var uriFile = "ms-appdata:///local/file.ext";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriFile);

Требования

Минимальный поддерживаемый клиент

Windows 8 [Приложения для Магазина Windows, классические приложения]

Минимальный поддерживаемый сервер

Windows Server 2012 [Приложения для Магазина Windows, классические приложения]

Минимальный поддерживаемый телефон

Windows Phone 8

Пространство имен

Windows.Foundation
Windows::Foundation [C++]

Metadata

Windows.winmd

См. также

Ссылка на содержимое

 

 

Показ:
© 2015 Microsoft