HtmlTextWriter.EncodeUrl Method

Performs minimal URL encoding by converting spaces in the specified URL to the string "%20".

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

protected:
String^ EncodeUrl (
	String^ url
)
protected String EncodeUrl (
	String url
)
protected function EncodeUrl (
	url : String
) : String
Not applicable.

Parameters

url

A string containing the URL to encode.

Return Value

A string containing the encoded URL.

URL encoding of a character consists of a percent symbol (%), followed by the two-digit hexadecimal representation (case-insensitive) of the ISO-Latin code point for the character. The hexadecimal representation of a space is 20.

The following code example demonstrates how to call the EncodeUrl method to convert any spaces in the URL that is passed as a parameter in an AddAttribute method call.

// If an <anchor> element is rendered and an href
// attribute has not been defined, call the AddAttribute
// method to add an href attribute
// and set it to http://www.cohowinery.com.
// Use the EncodeUrl method to convert any spaces to %20.
if ( TagKey == HtmlTextWriterTag::A )
{
   if (  !IsAttributeDefined( HtmlTextWriterAttribute::Href ) )
   {
      AddAttribute( "href", EncodeUrl( "http://www.cohowinery.com" ) );
   }
}

// If an Anchor element is being rendered and an href
// attribute has not been defined, call the AddAttribute
// method to add an href
// attribute and set it to http://www.cohowinery.com.
// Use the EncodeUrl method to convert any spaces to %20.
if (get_TagKey().Equals(HtmlTextWriterTag.A)) {
    if (!(IsAttributeDefined(HtmlTextWriterAttribute.Href))) {
        AddAttribute("href", EncodeUrl("http://www.cohowinery.com"));
    }
}

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: