HostString 结构

定义

命名空间:

Microsoft.AspNetCore.Http

程序集:

Microsoft.AspNetCore.Http.Abstractions.dll

包:

Microsoft.AspNetCore.App.Ref v8.0.0

表示 URI 的主机部分，可用于构造正确格式化和编码的 URI，以便在 HTTP 标头中使用。

public value class HostString : IEquatable<Microsoft::AspNetCore::Http::HostString>

public readonly struct HostString : IEquatable<Microsoft.AspNetCore.Http.HostString>

type HostString = struct

Public Structure HostString
Implements IEquatable(Of HostString)

继承

ValueType

HostString

实现

IEquatable<HostString>

构造函数

HostString(String)	创建无修饰的新 HostString。 该值应采用 Unicode 而不是 punycode 编码，并可以包含端口。 也允许使用 IPv4 和 IPv6 地址，这些地址同样可以包含端口。
HostString(String, Int32)	从主机和端口部件创建新的 HostString。

属性

HasValue	如果设置了主机，则返回 true。
Host	返回值的主机部分的值。 如果端口存在，则会将其删除。 将为 IPv6 地址添加括号（如果没有括号）。
Port	返回主机的端口部分的值，如果未找到任何端口部分，则返回 null 。
Value	从构造函数返回原始值。

方法

Equals(HostString)	比较 Value 属性的相等性，忽略大小写。
Equals(Object)	仅当为 HostString 时才与给定的对象进行比较。
FromUriComponent(String)	从给定的 URI 组件创建新的 HostString。 任何 punycode 都将转换为 Unicode。
FromUriComponent(Uri)	从给定 URI 实例的主机和端口创建新的 HostString。 Punycode 将转换为 Unicode。
GetHashCode()	获取值的哈希代码。
MatchesAny(StringSegment, IList<StringSegment>)	将主机标头值的主机部分与模式列表相匹配。 只要模式使用相同的格式，主机可以是编码的 punycode 或解码的 unicode 形式。
ToString()	返回已由 ToUriComponent() 规范化的值。
ToUriComponent()	返回具有正确格式和编码且可在 HTTP 标头的 URI 中使用的值。 任何 Unicode 都将转换为 punycode。 将为 IPv6 地址添加括号（如果没有括号）。

运算符

Equality(HostString, HostString)	比较两个实例的相等性。
Inequality(HostString, HostString)	比较两个实例的不相等性。