ReplaceHost Method

Replaces the host in a URI string by a new value.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<CanBeNullAttribute()>
Public Shared Function ReplaceHost( _
   ByVal uriString As String, _
   ByVal host As String _
) As String

'Usage
 
Dim uriString As String
Dim host As String
Dim value As String
 
value = UriUtilities.ReplaceHost(uriString, host)

[CanBeNull()]
public static string ReplaceHost( 
   string uriString,
   string host
)

[CanBeNull()]
public:
static String^ ReplaceHost( 
   String^ uriString,
   String^ host
)

Parameters

uriString: The URI string.
The value of this parameter cannot be null (Nothing in Visual Basic).
host: The new host.
The value of this parameter cannot be null (Nothing in Visual Basic).

Return Value

Returns a new URI string, where the host part is replaced by the . If the URI string cannot be parsed, or the host cannot be replaced yielding a valid URI, the method returns null.

This method can return null (Nothing in Visual Basic).

Exceptions

Exception Description

Exception	Description
System.ArgumentNullException	A `null` reference (`Nothing` in Visual Basic) is passed to a method that does not accept it as a valid argument. This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

System.ArgumentNullException

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

Reference

UriUtilities Class
UriUtilities Members

Documentation Home, Send Feedback. Resources: Knowledge Base, Product Downloads. Technical support: Online Forums, FAQ.

Missing some example? Ask us for it on our Online Forums! You do not have to own a commercial license in order to use Online Forums, and we reply to every post.