UriBuilder Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Provides a custom constructor for uniform resource identifiers (URIs) and modifies URIs for the Uri class.

Inheritance Hierarchy

System..::.Object
System..::.UriBuilder

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

Syntax

Public Class UriBuilder
public class UriBuilder

The UriBuilder type exposes the following members.

Constructors

Name Description
UriBuilder()()() Initializes a new instance of the UriBuilder class.
UriBuilder(String) Initializes a new instance of the UriBuilder class with the specified URI.
UriBuilder(Uri) Initializes a new instance of the UriBuilder class with the specified Uri instance.
UriBuilder(String, String) Initializes a new instance of the UriBuilder class with the specified scheme and host.
UriBuilder(String, String, Int32) Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.
UriBuilder(String, String, Int32, String) Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.
UriBuilder(String, String, Int32, String, String) Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

Top

Properties

Name Description
Fragment Gets or sets the fragment portion of the URI.
Host Gets or sets the Domain Name System (DNS) host name or IP address of a server.
Password Gets or sets the password associated with the user that accesses the URI.
Path Gets or sets the path to the resource referenced by the URI.
Port Gets or sets the port number of the URI.
Query Gets or sets any query information included in the URI.
Scheme Gets or sets the scheme name of the URI.
Uri Gets the Uri instance constructed by the specified UriBuilder instance.
UserName The user name associated with the user that accesses the URI.

Top

Methods

Name Description
Equals Compares an existing Uri instance with the contents of the UriBuilder for equality. (Overrides Object..::.Equals(Object).)
Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
GetHashCode Returns the hash code for the URI. (Overrides Object..::.GetHashCode()()().)
GetType Gets the Type of the current instance. (Inherited from Object.)
MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
ToString Returns the display string for the specified UriBuilder instance. (Overrides Object..::.ToString()()().)

Top

Remarks

The UriBuilder class provides a convenient way to modify the contents of a Uri instance without creating a new Uri instance for each modification.

The UriBuilder properties provide read/write access to the read-only Uri properties so that they can be modified.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

System Namespace

Uri