Table of contents
ADO Tutorial ADO HOME ADO Intro ADO Connect ADO Recordset ADO Display ADO Query ADO Sort ADO Add ADO Update ADO Delete ADO Demo ADO Speed Up ADO Objects ADO Command ADO Connection ADO Error ADO Field ADO Parameter ADO Property ADO Record ADO Recordset ADO Stream ADO DataTypes ADO Summary Examples ADO Examples Exam ADO Exam

Selected Reading
Web Statistics Web Glossary Web Hosting Web Quality Browse Tutorials

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.

Syntax

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:

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:

<html>
<body>

<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"

set rs = Server.CreateObject("ADODB.recordset")
rs.Open "SELECT Companyname, Contactname FROM Customers", conn

str=rs.GetString(,,"</td><td>","</td></tr><tr><td>","&nbsp;")
%>

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

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