Uri.Host Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets the host component of this instance.
Namespace: System
Assembly: System (in System.dll)
Syntax
'Declaration
Public ReadOnly Property Host As String
public string Host { get; }
Property Value
Type: System.String
A String that contains the host name. This is usually the DNS host name or IP address of the server.
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | This property is valid only for an absolute Uri instance. |
Remarks
The Host property gets the host component of this Uri instance. This property value does not include the port number.
Silverlight-based applications are cross-platform, so they run in most modern Web browsers, including Apple Safari version 2.0 and later on Apple Mac OS X. However, full parsing for UNC style paths in a Uri is supported only on Windows. Any backslashes in a Uri for the UriSchemeFile representing a UNC path are converted to forward slashes on Apple Mac OS X.
An example that displays this issue is below:
Uri testUri = Uri(@"file://\\computer\download\file.ext");
On Windows, this UNC path is converted to the following Uri:
file://computer/download/file.ext
The AbsolutePath is /download/file.ext.
The Host property is equal to: computer.
The IsUnc property is true.
The LocalPath property is \\computer\download\file.ext.
On Apple Mac OS X, this UNC path is converted to the following Uri:
file::////computer/download/file.ext
The AbsolutePath property is //computer/download/file.ext.
The Host property is an empty string.
The IsUnc property is false.
The LocalPath property is computer/download/file.ext.
Examples
The following example writes the host name (www.contoso.com) of the server to the console.
Dim baseUri As New Uri("https://www.contoso.com:8080/")
Dim myUri As New Uri(baseUri,"shownew.htm?date=today")
outputBlock.Text &= "Uri.Host: "
outputBlock.Text &= myUri.Host
outputBlock.Text &= vbCrLf
Uri baseUri = new Uri("https://www.contoso.com:8080/");
Uri myUri = new Uri(baseUri, "shownew.htm?date=today");
outputBlock.Text += "Uri.Host: ";
outputBlock.Text += myUri.Host;
outputBlock.Text += "\n";
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.