User Guide

CCFXRequest class 1063
CCFXRequest::AddQuery
Syntax
CCFXQuery* CCFXRequest::AddQuery(LPCSTR lpszName,
CCFXStringSet* pColumns)
Description
Adds a query to the calling template. The query can be accessed by CFML tags (for example,
CFOUTPUT or CFTABLE) within the template. After calling AddQuery, the query is empty (it has 0
rows). To populate the query with data, call the
CCFXQuery::AddRow and CCFXQuery::SetData
functions.
Returns
Returns a pointer to the query that was added to the template (an object of class CCFXQuery). The
memory allocated for the returned query is freed automatically by ColdFusion after the request is
completed.
Parameters
virtual void SetVariable( LPCSTR lpszName, LPCSTR
lpszValue )
CCFXRequest::SetVariable
sets a
variable in the template that contains this
tag.
virtual CCFXQuery* AddQuery( LPCSTR lpszName,
CCFXStringSet* pColumns )
CCFXRequest::AddQuery
adds a query to
the template that contains this tag.
virtual BOOL Debug()
CCFXRequest::Debug
checks whether the
tag contains the
Debug attribute.
virtual void WriteDebug( LPCSTR lpszOutput )
CCFXRequest::WriteDebug
writes text
output into the debug stream.
virtual CCFXStringSet* CreateStringSet()
CCFXRequest::CreateStringSet
allocates
and returns a
CCFXStringSet instance.
virtual void ThrowException( LPCSTR lpszError,
LPCSTR lpszDiagnostics )
CCFXRequest::ThrowException
throws an
exception and ends processing of this
request.
virtual void ReThrowException
( CCFXException* e )
CCFXRequest::ReThrowException
re-
throws an exception that has been
caught.
virtual void SetCustomData( LPVOID lpvData )
CCFXRequest::SetCustomData
sets
custom (tag specific) data to carry with a
request.
virtual LPVOID GetCustomData()
CCFXRequest::GetCustomData
gets
custom (tag specific) data for a request.
Parameter Description
lpszName Name of query to add to the template (must be unique)
pColumns List of column names to be used in the query