通过


Uri 构造函数

定义

初始化 Uri 类的新实例。

重载

名称 说明
Uri(String)

使用指定的 URI 初始化类的新实例 Uri

Uri(SerializationInfo, StreamingContext)
已过时.

从类的Uri指定实例初始化类的新实例SerializationInfoStreamingContext

Uri(String, Boolean)
已过时.
已过时.
已过时.
已过时.

使用指定的 URI 初始化类的新实例 Uri ,并显式控制字符转义。

Uri(String, UriCreationOptions)

使用指定的 URI 和其他 UriCreationOptionsURI 初始化类的新实例Uri

Uri(String, UriKind)

使用指定的 URI 初始化类的新实例 Uri 。 使用此构造函数可以指定 URI 字符串是相对 URI、绝对 URI 还是不确定。

Uri(Uri, String)

根据指定的基 URI 和相对 URI 字符串初始化类的新实例 Uri

Uri(Uri, Uri)

根据指定的基Uri实例和相对Uri实例的组合初始化类的新Uri实例。

Uri(Uri, String, Boolean)
已过时.
已过时.
已过时.
已过时.

根据指定的基 URI 和相对 URI 初始化类的新实例 Uri ,并显式控制字符转义。

Uri(String)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

使用指定的 URI 初始化类的新实例 Uri

public:
 Uri(System::String ^ uriString);
public Uri(string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)

参数

uriString
String

一个字符串,标识要由 Uri 实例表示的资源。

例外

uriStringnull

uriString 为空。

-或-

未正确形成指定的 uriString 方案。 请参阅 CheckSchemeName(String)

-或-

uriString 包含过多斜杠。

-或-

在密码、主机名、文件名或用户名中 uriString 指定的密码、主机名或用户名无效。

-或-

在 中指定的 uriString 主机或颁发机构名称由反斜杠终止。

-或-

指定的 uriString 端口号无效或无法分析。

-或-

长度 uriString 超过 65519 个字符(仅限 .NET 9 和早期版本)。

-或-

指定的 uriString 方案的长度超过 1023 个字符。

-或-

中存在无效字符序列 uriString

-或-

指定的 uriString MS-DOS 路径不以 c:\\开头。

示例

以下示例使用 URI http://www.contoso.com/创建一个Uri实例。

Uri myUri = new Uri("http://www.contoso.com/");
let myUri = Uri "http://www.contoso.com/"
Dim myUri As New Uri("http://www.contoso.com/")

注解

此构造函数从 URI 字符串创建 Uri 实例。 它分析 URI,将其置于规范格式,并进行任何所需的转义编码。

此构造函数不确保 Uri 引用可访问的资源。

uriString如果表示 IPv6 地址,则必须用括号括起来,例如“http://[2607:f8b0:400d:c06::69]”。

此构造函数假定 string 参数引用绝对 URI,等效于调用 Uri 设置为 UriKindAbsolute构造函数。 string如果传递给构造函数的参数是相对 URI,则此构造函数将引发一个 UriFormatException

适用于

Uri(SerializationInfo, StreamingContext)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

注意

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

从类的Uri指定实例初始化类的新实例SerializationInfoStreamingContext

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

参数

serializationInfo
SerializationInfo

序列化新 Uri 实例所需的信息。

streamingContext
StreamingContext

与新 Uri 实例关联的序列化流的源。

属性

例外

serializationInfo 参数包含 URI null

serializationInfo 参数包含一个为空的 URI。

-或-

指定的方案格式不正确。 请参阅 CheckSchemeName(String)

-或-

URI 包含过多的斜杠。

-或-

URI 中指定的密码、主机名、文件名或用户名无效。

-或-

URI 中指定的主机或颁发机构名称由反斜杠终止。

-或-

URI 中指定的端口号无效或无法分析。

-或-

URI 长度超过 65519 个字符(仅限 .NET 9 和早期版本)。

-或-

URI 中指定的方案的长度超过 1023 个字符。

-或-

URI 中有无效的字符序列。

-或-

URI 中指定的 MS-DOS 路径不以 c:\\开头。

注解

此构造函数实现 ISerializable 类的 Uri 接口。

另请参阅

适用于

Uri(String, Boolean)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

注意

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.

注意

This constructor has been deprecated. Use Uri(string) instead.

注意

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

注意

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

使用指定的 URI 初始化类的新实例 Uri ,并显式控制字符转义。

public:
 Uri(System::String ^ uriString, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);
[System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(string uriString, bool dontEscape);
public Uri(string uriString, bool dontEscape);
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

参数

uriString
String

一个字符串,标识要由 Uri 实例表示的资源。 请注意,字符串形式的 IPv6 地址必须括在方括号内。 例如,“http://[2607:f8b0:400d:c06::69]”。

dontEscape
Boolean

true 如果 uriString 完全转义,则为 :否则为 false

属性

例外

uriStringnull

uriString 为空或仅包含空格。

-或-

中指定的 uriString 方案无效。

-或-

uriString 包含过多斜杠。

-或-

在密码、主机名、文件名或用户名中 uriString 指定的密码、主机名或用户名无效。

-或-

在 中指定的 uriString 主机或颁发机构名称由反斜杠终止。

-或-

指定的 uriString 端口号无效或无法分析。

-或-

长度 uriString 超过 65519 个字符(仅限 .NET 9 和早期版本)。

-或-

指定的 uriString 方案的长度超过 1023 个字符。

-或-

uriString存在无效字符序列。

-或-

指定的 uriString MS-DOS 路径不以 c:\\开头。

注解

此构造函数从 URI 字符串创建 Uri 实例。 它分析 URI,并将其置于规范格式。

参数 dontEscape 控制是否将保留字符转换为转义序列。 仅当确定 URI 中的所有保留字符已转义时,才应将 此参数设置为< 将值设置为 true 未完全转义的 URI 可能会导致意外行为。 强烈建议始终将此参数设置为 false

如果 dontEscape 设置为 false,则构造函数通过检查所有匹配的百分比(%)后跟有效的转义序列来转义任何保留字符。 如果百分比后面的字符序列无效,则百分比将替换为 %25。

此构造函数不确保 Uri 引用可访问的资源。

适用于

Uri(String, UriCreationOptions)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

使用指定的 URI 和其他 UriCreationOptionsURI 初始化类的新实例Uri

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);
public Uri(string uriString, in UriCreationOptions creationOptions);
new Uri : string * UriCreationOptions -> Uri
Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

参数

uriString
String

一个字符串,标识要由 Uri 实例表示的资源。

creationOptions
UriCreationOptions

用于控制创建和行为方式 Uri 的选项。

适用于

Uri(String, UriKind)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

使用指定的 URI 初始化类的新实例 Uri 。 使用此构造函数可以指定 URI 字符串是相对 URI、绝对 URI 还是不确定。

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri(string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri
Public Sub New (uriString As String, uriKind As UriKind)

参数

uriString
String

一个字符串,标识要由 Uri 实例表示的资源。

uriKind
UriKind

指定 URI 字符串是相对 URI、绝对 URI 还是不确定。

例外

uriKind 无效。

uriStringnull

uriString 包含相对 URI 且 uriKindAbsolute.

uriString 包含绝对 URI 且 uriKindRelative.

uriString 为空。

-或-

未正确形成指定的 uriString 方案。 请参阅 CheckSchemeName(String)

-或-

uriString 包含过多斜杠。

-或-

在密码、主机名、文件名或用户名中 uriString 指定的密码、主机名或用户名无效。

-或-

在 中指定的 uriString 主机或颁发机构名称由反斜杠终止。

-或-

指定的 uriString 端口号无效或无法分析。

-或-

长度 uriString 超过 65519 个字符(仅限 .NET 9 和早期版本)。

-或-

指定的 uriString 方案的长度超过 1023 个字符。

-或-

uriString存在无效字符序列。

-或-

指定的 uriString MS-DOS 路径不以 c:\\开头。

注解

相对 URI 和绝对 URI 对其格式有不同的限制。 例如,相对 URI 不需要方案或颁发机构。 指定的 uriKind 值必须与传入 uriString的 URI 类型匹配。 但是,如果 RelativeOrAbsolute 指定了 URI 字符串,则 URI 字符串可以是相对字符串,也可以是绝对的。

对于 uriString,字符串形式的 IPv6 地址必须括在括号内,例如“http://[2607:f8b0:400d:c06::69]”。

适用于

Uri(Uri, String)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

根据指定的基 URI 和相对 URI 字符串初始化类的新实例 Uri

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri(Uri baseUri, string relativeUri);
public Uri(Uri baseUri, string? relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

参数

baseUri
Uri

基 URI。

relativeUri
String

要添加到基 URI 的相对 URI。

例外

baseUrinull

baseUri 不是绝对 Uri 实例。

组合 baseUri 构成的 URI 为 relativeUri 空或仅包含空格。

-或-

组合 baseUri 在 URI 中指定的方案无效 relativeUri

-或-

通过组合 baseUrirelativeUri 包含过多斜杠而形成的 URI。

-或-

组合而成baseUrirelativeUri的 URI 中指定的密码、主机名、文件名或用户名无效。

-或-

组合在 baseUri URI 中指定的主机或颁发机构名称,并由 relativeUri 反斜杠终止。

-或-

通过组合baseUrirelativeUri而成的 URI 中指定的端口号无效或无法分析。

-或-

通过组合baseUrirelativeUri和超过 65519 个字符(仅限 .NET 9 和早期版本)形成的 URI 的长度。

-或-

通过组合baseUrirelativeUri和超过 1023 个字符在 URI 中指定的方案的长度。

-或-

合并和relativeUri构成baseUri的 URI 中存在无效的字符序列。

-或-

指定的 baseUri MS-DOS 路径不以 c:\\开头。

示例

以下示例通过组合相对 URI http://www.contoso.comcatalog/shownew.htm形成绝对 URI http://www.contoso.com/catalog/shownew.htm来创建类的新实例Uri

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());
let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"
Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

注解

此构造函数通过组合baseUrirelativeUriUri .. 如果是 绝对 URI(包含方案、主机名和端口号),则 使用 < a0/> 创建实例。

baseUri如果具有相对部分(如/api),则必须用斜杠终止相对部分(如/api/),如果要在构造Uri中保留相对部分baseUri

此外,如果 relativeUri 以斜杠开头,它将替换该斜杠的任何相对部分 baseUri

此构造函数不确保 Uri 引用可访问的资源。

适用于

Uri(Uri, Uri)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

根据指定的基Uri实例和相对Uri实例的组合初始化类的新Uri实例。

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);
public Uri(Uri baseUri, Uri relativeUri);
new Uri : Uri * Uri -> Uri
Public Sub New (baseUri As Uri, relativeUri As Uri)

参数

baseUri
Uri

Uri绝对是新Uri实例的基础。

relativeUri
Uri

UribaseUri..

例外

baseUri 不是绝对 Uri 实例。

baseUrinull

baseUri 不是绝对 Uri 实例。

组合 baseUri 构成的 URI 为 relativeUri 空或仅包含空格。

-或-

组合 baseUri 在 URI 中指定的方案无效 relativeUri

-或-

通过组合 baseUrirelativeUri 包含过多斜杠而形成的 URI。

-或-

组合而成baseUrirelativeUri的 URI 中指定的密码、主机名、文件名或用户名无效。

-或-

组合在 baseUri URI 中指定的主机或颁发机构名称,并由 relativeUri 反斜杠终止。

-或-

通过组合baseUrirelativeUri而成的 URI 中指定的端口号无效或无法分析。

-或-

通过组合baseUrirelativeUri和超过 65519 个字符(仅限 .NET 9 和早期版本)形成的 URI 的长度。

-或-

通过组合baseUrirelativeUri和超过 1023 个字符在 URI 中指定的方案的长度。

-或-

合并和relativeUri构成baseUri的 URI 中存在无效的字符序列。

-或-

指定的 baseUri MS-DOS 路径不以 c:\\开头。

示例

此示例创建一个绝对 Uri 实例, absoluteUri以及一个相对 Uri 实例 relativeUri。 然后,从这两个实例创建一个新 Uri 实例 combinedUri

// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);
// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
let relativeUri = Uri("/catalog/shownew.htm?date=today", UriKind.Relative)

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{combinedUri.AbsoluteUri}"
    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

注解

此构造函数通过将绝对Uri实例与相对Uri实例baseUri组合在一起来创建一个新Uri实例relativeUri。 如果是 绝对 实例(包含方案、主机名和端口号),则 使用 < a0/> 创建实例。

baseUri如果具有相对部分(如/api),则必须用斜杠终止相对部分(如/api/),如果要在构造Uri中保留相对部分baseUri

此外,如果 relativeUri 以斜杠开头,则它将替换该斜杠的任何相对部分 baseUri

此构造函数不确保 Uri 引用可访问的资源。

适用于

Uri(Uri, String, Boolean)

Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

注意

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.

注意

This constructor has been deprecated. Use Uri(Uri, string) instead.

注意

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

注意

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

根据指定的基 URI 和相对 URI 初始化类的新实例 Uri ,并显式控制字符转义。

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);
public Uri(Uri baseUri, string relativeUri, bool dontEscape);
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

参数

baseUri
Uri

基 URI。

relativeUri
String

要添加到基 URI 的相对 URI。

dontEscape
Boolean

true 如果 baseUrirelativeUri 完全转义,则为 ;否则为 false

属性

例外

baseUrinull

baseUri 不是绝对 Uri 实例。

组合 baseUri 构成的 URI 为 relativeUri 空或仅包含空格。

-或-

组合 baseUri 在 URI 中指定的方案无效 relativeUri

-或-

通过组合 baseUrirelativeUri 包含过多斜杠而形成的 URI。

-或-

组合而成baseUrirelativeUri的 URI 中指定的密码、主机名、文件名或用户名无效。

-或-

组合在 baseUri URI 中指定的主机或颁发机构名称,并由 relativeUri 反斜杠终止。

-或-

通过组合baseUrirelativeUri而成的 URI 中指定的端口号无效或无法分析。

-或-

通过组合baseUrirelativeUri和超过 65519 个字符(仅限 .NET 9 和早期版本)形成的 URI 的长度。

-或-

通过组合baseUrirelativeUri和超过 1023 个字符在 URI 中指定的方案的长度。

-或-

合并和relativeUri构成baseUri的 URI 中存在无效的字符序列。

-或-

指定的 baseUri MS-DOS 路径不以 c:\\开头。

注解

此构造函数 Uri 通过组合 baseUrirelativeUri. 如果传入 relativeUri 的 URI 是绝对 URI(包含方案、主机名和端口号),则 UrirelativeUri使用实例创建。

参数 dontEscape 控制是否将保留字符转换为转义序列。 仅当确定 URI 中的所有保留字符已转义时,才应将 此参数设置为< 将值设置为 true 未完全转义的 URI 可能会导致意外行为。 强烈建议始终将此参数设置为 false。 如果 dontEscape 设置为 false,则构造函数通过检查所有匹配的百分比(%)后跟有效的转义序列来转义任何保留字符。 如果百分比后面的字符序列无效,则百分比将替换为 %25。

此构造函数不确保 Uri 引用可访问的资源。

调用方说明

由于安全问题,应用程序不应使用来自不受信任的源的 URI 字符串和 设置为 的 URI 字符串来调用此构造函数。 或者,可以通过调用此构造函数之前调用 IsWellFormedOriginalString() 方法来检查 URI 字符串的有效性。

适用于