Share via


HostString Struct

Definition

Represents the host portion of a URI can be used to construct URI's properly formatted and encoded for use in HTTP headers.

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)
Inheritance
HostString
Implements

Constructors

HostString(String, Int32)

Creates a new HostString from its host and port parts.

HostString(String)

Creates a new HostString without modification. The value should be Unicode rather than punycode, and may have a port. IPv4 and IPv6 addresses are also allowed, and also may have ports.

Properties

HasValue

Returns true if the host is set.

Host

Returns the value of the host part of the value. The port is removed if it was present. IPv6 addresses will have brackets added if they are missing.

Port

Returns the value of the port part of the host, or null if none is found.

Value

Returns the original value from the constructor.

Methods

Equals(HostString)

Compares the equality of the Value property, ignoring case.

Equals(Object)

Compares against the given object only if it is a HostString.

FromUriComponent(String)

Creates a new HostString from the given URI component. Any punycode will be converted to Unicode.

FromUriComponent(Uri)

Creates a new HostString from the host and port of the give Uri instance. Punycode will be converted to Unicode.

GetHashCode()

Gets a hash code for the value.

MatchesAny(StringSegment, IList<StringSegment>)

Matches the host portion of a host header value against a list of patterns. The host may be the encoded punycode or decoded unicode form so long as the pattern uses the same format.

ToString()

Returns the value as normalized by ToUriComponent().

ToUriComponent()

Returns the value properly formatted and encoded for use in a URI in a HTTP header. Any Unicode is converted to punycode. IPv6 addresses will have brackets added if they are missing.

Operators

Equality(HostString, HostString)

Compares the two instances for equality.

Inequality(HostString, HostString)

Compares the two instances for inequality.

Applies to