0 out of 1 rated this helpful - Rate this topic

HttpUtility.UrlPathEncode Method

Encodes the path portion of a URL string for reliable HTTP transmission from the Web server to a client.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)
public static string UrlPathEncode(
	string str
)

Parameters

str
Type: System.String

The text to encode.

Return Value

Type: System.String
The encoded text.

The UrlPathEncode method performs the following steps:

  1. Applies the encoding logic of the UrlPathEncode method to only the path part of the URL (which excludes the query string). The method assumes that the URL is encoded as a UTF-8 string.

  2. Encodes non-spaces so that only a subset of the first 128 ASCII characters is used in the resulting encoded string. Any characters at Unicode value 128 and greater, or 32 and less, are URL-encoded.

  3. Encodes spaces as %20.

You can encode a URL using the UrlEncode method or the UrlPathEncode method. However, the methods return different results. The UrlEncode method converts each space character to a plus character (+). The UrlPathEncode method converts each space character into the string %20, which represents a space in hexadecimal notation. Use the UrlPathEncode method when you encode the path portion of a URL in order to guarantee a consistent decoded URL, regardless of which platform or browser performs the decoding. When you use the UrlPathEncode method, the query-string values are not encoded. Therefore, any values that are past the question mark (?) in the string, will not be encoded. If you must pass a URL as a query string, use the UrlEncode method.

For more information about encoding, see Character Encoding in the .NET Framework.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.