ADO GetString Method

The GetString method returns the specified Recordset as a string. This method can be used to fill HTML tables in ASP files.


Set str=objRecordset.GetString(format,n,coldel,rowdel,nullexpr)

Parameter Description
format Optional. A StringFormatEnum value that specifies the format when retrieving a Recordset as a string
n Optional. The number of rows to be converted in the Recordset
coldel Optional. If format is set to adClipString it is a column delimiter. Otherwise it is the tab character
rowdel Optional. If format is set to adClipString it is a row delimiter. Otherwise it is the carriage return character
nullexpr Optional. If format is set to adClipString it is an expression used instead of a null value. Otherwise it is an empty string


To create an HTML table with data from a recordset, we only need to use three of the parameters above:
  • coldel - the HTML to use as a column-separator
  • rowdel - the HTML to use as a row-separator
  • NullExpr - the HTML to use if a column is NULL
Note: The GetString() method is an ADO 2.0 feature. You can download ADO 2.0 at

In the following example we will use the GetString() method to hold the recordset as a string:

set conn=Server.CreateObject("ADODB.Connection")
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "SELECT Companyname, Contactname FROM Customers", conn
%>< <table border="1" width="100%"> <tr> <td><%Response.Write(str)%></td> </tr> </table> <% rs.close conn.close set rs = Nothing set conn = Nothing %> </body> </html>

StringFormatEnum Values

Constant Value Description
adClipString 2 Delimits rows by the rowdel parameter, columns by the coldel parameter, and null values by the nullexpr parameter

Goto Recordset Object Complete Reference
Share this article :
Copyright © 2012. Best Online Tutorials | Source codes | Programming Languages - All Rights Reserved