Tutorials References Exercises Sign Up Menu
Create Website Get Certified Pro

ADO GetString Method

❮ Complete Recordset Object Reference

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

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 http://www.microsoft.com/data/download.htm.


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%">

set rs = Nothing
set conn = Nothing

Show example »

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

❮ Complete Recordset Object Reference