HostString 结构
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示 URI 的主机部分,可用于构造正确格式化和编码的 URI,以便在 HTTP 标头中使用。
public value class HostString : IEquatable<Microsoft::AspNetCore::Http::HostString>
public struct 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)
- 继承
-
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) |
比较两个实例的不相等性。 |