W3Schools.com

ADO GetString Method

Recordset Object Reference 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.

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

Example

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.

Example

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>

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

Recordset Object Reference Complete Recordset Object Reference
W3Schools Certification

W3Schools' Online Certification

The perfect solution for professionals who need to balance work, family, and career building.

More than 10 000 certificates already issued!

Get Your Certificate »

The HTML Certificate documents your knowledge of HTML.

The CSS Certificate documents your knowledge of advanced CSS.

The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.

The jQuery Certificate documents your knowledge of jQuery.

The XML Certificate documents your knowledge of XML, XML DOM and XSLT.

The ASP Certificate documents your knowledge of ASP, SQL, and ADO.

The PHP Certificate documents your knowledge of PHP and SQL (MySQL).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE