URLSessionFormat

Description

Depending on whether a client computer accepts cookies, this function does the following:

If the client does not accept cookies: automatically appends all required client identification information to a URL
If the client accepts cookies: does not append information

This function automatically determines which identifiers are required, and sends only the required information. It provides a more secure and robust method for supporting client identification than manually encoding the information in each URL, because it sends only required information, when it is required, and it is easier to code.

Return value

A URL; if cookies are disabled for the browser, client and session data are appended.

Syntax

URLSessionFormat(request_URL)

Parameters

Parameter Description

request_URL
URL of a ColdFusion page

Parameter	Description
request_URL	URL of a ColdFusion page

Usage

In the following example, the cfform tag posts a request to another page and sends the client identification, if required. If cookie support is detected, the function returns the following:

myactionpage.cfm

If the detected cookie is not turned on, or cookie support cannot be reliably detected, the function return value is as follows:

myactionpage.cfm?jsessionid=xxxx;cfid=xxxx&cftoken=xxxxxxxx

Example

<cfform 
method="Post" 
action="#URLSessionFormat("MyActionPage.cfm")#>

Version 6

Comments are no longer accepted for ColdFusion MX. ColdFusion 8 is the current version.

Comments

chrisdempsey said on Feb 9, 2005 at 8:47 AM :

It seems like you must have <cfapplication setClientCookies="yes"> for URLSessionFormat() to work as advertised, i.e. not appending CFID and CFTOKEN if cookies are enabled, though setClientCookies defaults to "yes".

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6/CFML_Reference/functions-pt2113.htm

CFML Reference