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).

 

备注

使用 Microsoft .NET Framework 生成 Windows Store 应用程序时,此类会隐藏,开发人员应使用 System.Uri 类,该类使用 RFC 3987 来编码和解码 URI。Uri 类在 file:// URI 不采用百分号编码非 ASCII 字符但使用用户的当前代码页解释百分号编码。

以下是示例 URI 的部分的分解:

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

例如:

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

在此示例中:

  • schemeftp
  • hostftp.microsoft.com
  • domainmicrosoft.comhost 的子集)
  • port8080
  • extensionasp

示例

此示例创建一个使用 http 协议访问网站的 URI。


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

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

此示例创建一个使用 ms-appx 协议来访问应用程序包中图像文件的 URI 。


// 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);

此示例为您的应用程序创建一个使用 ms-appdata 协议来访问本地应用程序数据存储中文件的 URI 。


// 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++]

元数据

Windows.winmd

另请参见

如何引用内容

 

 

显示:
© 2014 Microsoft