Uri::CheckHostName Method (String^)


Determines whether the specified host name is a valid DNS name.

Namespace:   System
Assembly:  System (in System.dll)

static UriHostNameType CheckHostName(
	String^ name


Type: System::String^

The host name to validate. This can be an IPv4 or IPv6 address or an Internet host name.

Return Value

Type: System::UriHostNameType

A UriHostNameType that indicates the type of the host name. If the type of the host name cannot be determined or if the host name is null or a zero-length string, this method returns Unknown.

The CheckHostName method checks that the host name provided meets the requirements for a valid Internet host name. It does not, however, perform a host-name lookup to verify the existence of the host.

The following example checks whether the host name is valid.

Console::WriteLine( Uri::CheckHostName( "www.contoso.com" ) );

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Return to top