MOVE方法

在一个Recordset对象中，相对于光标的当前位置移动光标。

适用于

Recordset脚本对象

语法

object.move ( nRecords )

参量

object

一个Recordset脚本对象。

nRecords

一个整数，规定光标要移动过的记录数。如果这个值大于零，位置向前移动（朝向记录集末尾方向）。如果这个值小于零，位置向后移动（朝向记录集开头方向）。说明如果成功，返回True，如果没成功，返回False。

使用这个移动方法移动光标是相对于它的当前位置的。

要想在记录集中按绝对位置移动光标，就要使用moveAbsolute方法。移动光标的其他方法还有：moveFirst、moveLast、movePrevious和moveNext。

参见

MOVEABSOLUTE方法， MOVEFIRST方法， MOVELAST方法， MOVENEXT方法， BOF属性， EOF属性

MOVEABSOLUTE方法

在一个Recordset对象中，把光标移到一个指定的索引位置。

适用于

Recordset脚本对象

语法

object.moveAbsolute ( nIndex )

参量

object

一个Recordset脚本对象。

nIndex

一个整数，规定从1开始的绝对索引。

说明

如果成功，返回True，如果没成功，返回False。

在Recordset对象中，使用moveAbsolute规定光标要移动的绝对索引。

要想在记录集中按相对位置移动光标，就要使用move方法。移动光标的其他方法还有：moveFirst、moveLast、movePrevious和moveNext。

举例

下边把光标移动到第四个记录

myRS.moveAbsolute ( 4 ) ;

参见

MOVE方法， MOVEFIRST方法， MOVELAST方法， MOVENEXT方法， MOVEPREVIOUS方法， BOF属性， EOF属性

MOVEFIRST方法

在一个Recordset对象中，把光标移到第一个记录位置。

适用于

Recordset脚本对象

语法

object.moveFirst ( )

参量

object

一个Recordset脚本对象。

说明

如果成功，返回True，如果没成功，返回False。

可以用来移动光标的方法有：move、moveAbsolute、moveFirst、moveLast、movePrevious和moveNext。

参见

CANCELOPERATION方法， MOVE方法， MOVEABSOLUTE方法， MOVELAST方法， MOVENEXT方法， MOVEPREVIOUS方法， BOF属性， EOF属性

MOVELAST方法

在一个Recordset对象中，把光标移到最后记录位置。

适用于

Recordset脚本对象

语法

object.moveLast ( )

参量

object

一个Recordset脚本对象。

说明

如果成功，返回True，如果没成功，返回False.

以用来移动光标的方法有：move、moveAbsolute、moveFirst、moveLast、movePrevious和moveNext。

参见

CANCELOPERATION方法， MOVE方法， MOVEABSOLUTE方法， MOVEFIRST方法， MOVENEXT方法， MOVEPREVIOUS方法， BOF属性， EOF属性

MOVENEXT方法

在一个Recordset对象中，把光标向前移动一个记录。

适用于

Recordset脚本对象

语法

object.moveNext ( )

参量

object

一个Recordset脚本对象。

说明

可以用来移动光标的方法有：move、moveAbsolute、moveFirst、moveLast、movePrevious和moveNext。

参见

CANCELOPERATION方法， MOVE方法， MOVEABSOLUTE方法， MOVEFIRST方法， MOVELAST方法， MOVEPREVIOUS方法， BOF属性， EOF属性

MOVEPREVIOUS方法

在一个Recordset对象中，把光标向后移动一个记录位置。

适用于

Recordset脚本对象

语法

object.movePrevious ( )

参量

object

一个Recordset脚本对象。

说明

如果成功，返回True，如果没成功，返回False。

可以用来移动光标的方法有：move、moveAbsolute、moveFirst、moveLast、movePrevious和moveNext。

参见

CANCELOPERATION方法， MOVE方法， MOVEABSOLUTE方法， MOVEFIRST方法， MOVELAST方法， MOVENEXT方法， BOF属性， EOF属性

NAVIGATEURL方法

使浏览器导航到指定的URL，而状态不变。

适用于

PageObject脚本对象

语法

object.navigateURL ( strURL )

参量

object

一个PageObject脚本对象。

strURL

要导航到的URL。

说明

如果从客户脚本中调用navigateURL方法，窗体便传递给服务器，并且直接出现在这个目的URL上。如果这个方法在服务器脚本中调用，结果便直接出现在浏览器中。

要在一个链接中放置一个URL，使用这种方法会更好一些；也可以使用window.location.href，因为它保持状态不变。在一个页面的会晤作用域或应用作用域中，在导航到其他页面之前需要更新的时候，就使用这个方法。

注意：

这个方法只能用于本地页面，不能用于引用的页面。例如，在一个名字叫做Page1的页面上，可以调用thisPage.navigateURL或Page1.navigateURL，但是不能调用Page2.navigateURL。

OPEN方法

打开一个Recordset（记录集）对象。

适用于

Recordset脚本对象

语法

object.open ( )

参量

object

一个Recordset脚本对象。

说明

使用setRecordSource方法在打开一个Recordset对象之前设置连接属性。使用isOpen方法确定Recordset对象是否已经打开。

举例这个例子表示如何使用Textbox中的一个值，改变查询（Query）子句的所在位置。

function btnQuery_onclick( )

{

    if ( RS1.isOpen( ) )

        RS1.close( ); //must close the recordset before changing the SQLText

        RS1.setSQLText(′Select * from TABLE1where (ID=+ txtQuery.value +′) ′);

        RS1.open( );

}

参见

CLOSE方法， ISOPEN方法

REMOVEITEM方法

从Listbox或OptionGroup对象去掉一个项。

适用于

Listbox脚本对象, OptionGroup脚本对象

语法

object.removeItem ( nIndex )

参量

object

一个Listbox或OptionGroup 脚本对象。

nIndex

一个整数，规定项在列表中的位置。索引从零开始。

说明

如果去掉项成功，返回True，否则返回False。其RowSource绑定到一个Recordset对象上的对象不支持这个removeItem方法。

参见

REQUERY方法

通过重查询数据库的办法，刷新当前记录集。

适用于

Recordset脚本对象

语法

object.requery ( )

参量

object

一个Recordset 脚本对象。

说明

这个方法对打开的记录集返回一组新记录。这对在记录集打开的情况下改变数据库的情况是很有用的。然而，为避免降低性能，只能在需要的时候使用这个方法。

参见

RECORDSET设计期间控件

SELECTBYCAPTION方法

根据标题在一个OptionGroup对象中选择一个项。

适用于

OptionGroup脚本对象

语法

object.selectbyCaption ( strCaption )

参量

object

一个OptionGroup 脚本对象。strCaption 一个标题串。

说明

如果成功，返回选定项的索引，如果不成功，返回－1。

举例

下边例子创建一个有五个选项按钮的组，并且选择第四个按钮。

function window_onload ( )

{

    for ( i = 0; i < 5 ; i ++)

    {

        opTest.addItem(″Item″ + i, i );

    }

    opText.selectedByCaption = ″Item3″; // select the 4th item in the group

}

参见

SELECTBYINDEX方法， SELECTBYVALUE方法

SELECTBYINDEX方法

根据索引在一个OptionGroup对象中选择一个项。

适用于

OptionGroup脚本对象

语法

object.selectbyIndex ( nIndex )

参量

object

一个OptionGroup 脚本对象。

NIndex

要选择项的索引（从零开始）。

说明

如果成功，返回选定项的索引，如果不成功，返回－1。

举例

function window_onload ( )

{

    for ( i = 0; i < 5 ; i ++)

    {

        optTest.addItem(″Item″ + i, i );

    }

    op Text.selectByIndex(0); // select the first item in the list

}

参见

SELECTBYCAPTION方法， SELECTBYVALUE方法

SELECTBYTEXT方法

在一个OptionGroup对象中，根据它的文本选择一个项。

适用于

Listbox脚本对象

语法

object.selectByText ( strText )

参量

object

一个Listbox脚本对象。

strText

规定希望选择的项文本。

说明

使用selectByValue方法，根据项的VALUE属性选择一个项。

举例

在下边的例子中，事件处理程序把一些项加到一个已经存在的名字叫做Listbox1的Listbox上，并且对thisPage每次刚刚开始在服务器上进行处理的情

况，把默认选择设置为“Cars”。

Function thisPage_onenter( )

{

    ListBox1.addItem(″Cars″, 1 );

    ListBox1.addItem(″Planes″, 2 );

    ListBox1.addItem(″Trains″, 3 );

    ListBox1.selectByText(″Cars″ );

}

参见

GETTEXT方法， GETVALUE方法， SELECTBYVALUE方法， SETTEXT方法， SETVALUE方法

SELECTBYVALUE方法

根据VALUE属性选择一个项。

适用于

Listbox脚本对象

语法

object.selectByValue ( value )

参量

object

一个Listbox或OptionGroup脚本对象。

Value

对应于HTML VALUE属性的一个串。

说明

如果成功，返回选定项的索引，如果不成功，返回－1。

使用selectByText方法，根据项的文本选择一个项。

举例

在下边的例子中，事件处理程序把一些项加到一个已经存在的名字叫做Listbox1的Listbox上，并且对thisPage每次刚刚开始在服务器上进行处理的情况，把默认选择设置为“Cars”。

Function thisPage_onenter( )

{

    ListBox1.addItem(″Cars″, 1 );

    ListBox1.addItem(″Planes″, 2 );

    ListBox1.addItem(″Trains″, 3 );

    ListBox1.selectByValue( 1 );

}

参见

GETTEXT方法， GETVALUE方法， SELECTBYCAPTION方法， SELECTBYINDEX方法， SETTEXT方法， SETVALUE方法

SETALIGNMENT方法

确定对象按钮是纵向排列还是横向排列。

适用于

OptionGroup脚本对象, RecordsetNavbar脚本对象

语法

object.setAlignment ( nAlign )

参量

object

一个RecordsetNavbar或OptionGroup脚本对象。

nAlign

确定排列的一个整数。nAlign 接受下列值：

说明

欲返回一个值，则使用getAlignment方法。

举例

在下边一行中，按钮在RecordsetNavbar对象上按横向排列。

RecordsetNavbar1.setAlignment ( 1 ) ;

参见

GETALIGNMENT方法

SETBOOKMARK方法

设置指向一个具体记录的书签。

适用于

Recordset脚本对象

语法

object.setBookmark ( strBookmark )

参量

object

一个Recordset脚本对象。

strBookmark

书签的串名字。

说明

欲获取书签，则使用getBookmark方法。

getBookmark 和serBookmark方法同ADO记录集书签类似，但是可以持续保留在各页之间。

在绑定到ASP中的数据上时，每次对页面服务时因为默认表现都要求代码程序关闭(Close)并重新打开(Reopen)记录集，并且因为记录集一旦关闭，ADO书签便成为无效的，因此，Microsoft Visual InterDev实现一种定制书签，其表现同ADO书签一样。

这样，就可以存储一个书签，关闭记录集，重新打开记录集，并设置书签，于是就找到了要到达的记录。

举例

下边的脚本存储一个书签，关闭记录集，重新打开这个记录集，再设置书签，于是就来到正确的记录位置。

Sub SampleBookMark( )

Dim tmpBookMark

    myRS.Open( )

    myRS.moveNext( ) ′now we are on the second record

    tmpBookMark = myTS.getBookMark( )

    ′now close the recordset

    myRS.Close( )

    ‘typically your bookmark is invalid, but in Visual InterDev it is not

    ′we will re-open this recordset, but assume this is another page perhaps

    myRS.Open( )

    ′let's also assume that several records have been inserted before

    ′and after the record we bookmarked

    myRS.setBookMark(tmpBookMark)

    ′we are now on the same record we were before

    ′(which this time is not necessarily the 2nd record)

End Sub

参见

GETBOOKMARK方法

SETBORDER方法

返回一个值，表示OptionGroup对象周围是否有边框。

适用于

OptionGroup脚本对象

语法

object.getBorder ( value)

参量

object

一个OptionGroup脚本对象。

Value

确定是否有边框的一个整数。value 接受下述值：

参见

GETBORDER方法

SETBUTTONSTYLE方法

确定哪个按钮显示图像，哪个按钮显示文本。

适用于

RecordsetNavbar脚本对象

语法

object.getButtonStyle ( nStyles)

参量

object

一个RecordsetNavbar脚本对象。

NStyles

一个整数，是各个按钮样式的和。

说明

setButtonStyles 方法使用一个值表示四个按钮的全部样式。nStyles 的值是下边列表值的和：

欲返回一个值，表示哪个按钮显示图像，哪个按钮显示文本，见setButtonStyles。

举例

下边一行使用值85设置所有四个按钮都作为显示文本的按钮。85是1＋4＋16＋64的和。

RecordsetNavbar1.setButtonStyles ( 85 )

参见

GETBUTTONSTYLE方法

SETCAPTION方法

设置对象的标题。

适用于

Label脚本对象，Checkbox脚本对象，OptionGroup脚本对象

语法

对于Label和Checkbox 对象：

object.setCaption ( strCaption)

对于OptionGroup 对象：

object.setCaption ( strCaption [,nIndex])

参量

object

一个脚本对象。

strCaption

规定标题的一个串。

NIndex

规定OptionGoup中项的索引。如果不采用nIndex，便默认是当前项。说明如果设置标题，则返回真，否则返回假。

对于Checkbox和OptionGroup对象，标题是在客户浏览器上查看页面时，出现在页面复选框后边的文本。

对于Label对象，标题是标签上的文本。

举例

function window_onload( )

{

    for ( i = 0; i < 5 ; i ++)

    {

        optTest.addItem(″Item″+ i );

    }

    optTest.setCaption(″bar″, 3 ); // change the caption of the 4th to″bar″

}

参见

GETCAPTION方法

SETCHECKED方法

设置复选框对象的状态。

适用于

Checkbox脚本对象

语法

object.setChecked ( value)

参量

object

一个Checkbox脚本对象。

value

写到数据库中的值。

说明

这个Checkbox对象用于显示数据库中的二进制数据或把二进制数据写入数据库中。但是不需要使用数据绑定。

在数据绑定时，Checkbox的状态映射成 < INPUT > 标记的VALUE属性。依据提交的窗体，写入到数据库中的值取决于Recordset对象的数据段数据类型和用户输入的数据类型。

可以把多个不同变元类型设置到一个Checkbox中。

· “0”, 0, false, 和 “false”：对Checkbox的所有设置都不检查。

· “1”, 1 , true, “true”, true, 或作为数据或串对待的任何不是0的数，都设置成进行检查。

欲获取Checkbox的状态，见getChecked方法。

举例

function btnCheck_onclick( )

{

    //Toggle the checked state of the checkbox when the user clicks btnCheck

    if ( Checkbox1.getChecked( ) )

        Checkbox1.setChecked( 0 ); // param can be

a number

    else

        Checkbox1.setChecked(″true″); // or a string, or Boolean

}

参见

GETCHECKED方法

SETCOLUMNCOUNT方法

设置Textbox对象中的栏数，以便确定宽度。

适用于

Textbox脚本对象

语法

object.setColumnCount ( nColumns)

参量

object

一个Textbox脚本对象。

nColumns

规定栏数，以便确定宽度。

说明

Textbox对象中的栏数决定客户机中文本框的宽度，单位是字符。这个栏数映射成COLS属性。

欲返回栏数，使用getColumnCount方法。

参见

GETCOLUMNCOUNT方法

SETDATAFIELD方法

规定数据段，以便把对象绑定到一个Recordset对象上

.适用于

Label脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象, Textbox脚本对象

语法

object.setDataField ( field )

参量

object

一个脚本对象。

field

规定把对象绑定到一个Recordset对象的数据段。可以使用数据段的名字和索引。

说明

field

参量

是一个变量表达式，等效于一个数据段的名字或索引，这个数据段可由上述Recordset

对象的getRecordSource方法所使用。

绑定对象便为访问数据库中特定数据提供了访问权。管理单个数据段的绑定对象显示

当前记录中一个指定数据段中的值。getDataSource 和setDataSource两个方法用来把对象绑定到一个Recordset对象上。

如果field对当前Recordset对象是无效的，那么setDataField方法便出现错误。

参见

GETDATAFIELD方法， GETDATASOURCE方法， GETRECORDSOURCE方法， SETDATASOURCE方法， SETRECORDSOURCE方法

SETDATAFORMATAS方法

规定提供给对象的数据是按照文本还是按照HTML进行提交。

适用于

Label脚本对象

语法

object.setDataFormatAs (LBL_TEXT | LBL_HTML)

参量

object

Label（标签）脚本对象。

LBL_TEXT 规定提供的数据按文本处理。

LBL_HTML 规定提供的数据按HTML处理。

说明

如果提供的数据包含HTML，而且希望直接用客户浏览器处理，就用HTML选项。

使用getDataFormatAs返回一个串，这个串表示提供给对象的数据是按照文本还是按照HTML提交。

参见

GETDATAFORMATAS方法

SETDATASOURCE方法

规定用于绑定数据的Recordset对象。

适用于

Label脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象语法object.setDataSource ( objRS)

参量

object

脚本对象。

ObjRS

当前对象要绑定的Recordset（记录集）。

说明

在绑定数据的时候，Recordset对象起数据源的作用。在使用设计期间控件的时候，Recordset对象由Recordset属性提供。

要把对象绑定到数据库的数据段上，就使用getDataField和setDataField两个方法。

举例

在下边一行中，setDataSource把Recordset3设置成绑定到Listbox1的Recordset对象。Listbox1.setDataSource ( Recordset3 )

参见

GETDATASOURCE方法， SETDATAFIELD方法， GETDATAFIELD方法

SETMAXLENGTH方法

设置Textbox对象的最大长度，单位是字符。

适用于

Textbox脚本对象

语法

object.setMaxLength ( number )

参量

object

一个Textbox脚本对象。

number

一个大于0的整数。

说明

欲返回最大长度，则使用getMaxLength方法。

参见

GETMAXLENGTH方法

SETPARAMETER方法

为可被记录集引用的已存过程或参量化查询，设置参量。

适用于

Recordset脚本对象

语法

object.setParameter ( nIndex, strParameter)

参量

object

一个Recordset脚本对象。

nIndex

一个整数，规定在参量数组中从零开始的具体参量的索引。

StrParameter

希望分配给参量的串值。

说明

欲返回已存过程或参量化查询的参量，则使用getParameter方法。

注意：

在javascript中，参量中的所有数据类型都作为串进行传递。

关于参量化查询和DHTML中的内容，参见在http://www.microsoft.com/vinterdev/ 的Microsoft Visual InterDev Web站点的白皮书“Using Parameterized Queries in DHTML”。

关于已存过程的例子

这个例子为一个已存过程设置参量。这个已存过程在Recordset设计期间控件中做了标识，名字叫做“DTCRecordset1”。这里简单假设Recordset控件已经加到页面上，数据库对象设置为“Stored Procedure”，而且这个指定的已存过程已经在Object Name（对象名字）字段中选定。

在Recordset设计期间控件属性页面的Implementation Tab（实施标签卡）中，“Automatically open the recordset”（自动打开记录集）值已经取消检查。

在这个例子中，设置输入参量、打开记录集、然后检取返回参量并核实指定条件。

要注意，对于已存过程，参量数组是从零开始的（这里“0”参量是返回值，而在脚本中，这个参量传递给这个已存过程是从“1”开始的）。

< script language=javascript runat=server >

function InsertUser(strFName, strLName, strEName, stPassword)

    {

    DTCRecordset1.setParameter(1, strFName);

    DTCRecordset1.setParameter(2, strLName);

    DTCRecordset1.setParameter(3, strEName);

    DTCRecordset1.setParameter(4, stPassword);

    DTCRecordset1.open( );

    // Get the new ID

    var getID = DTCRecordset1.getParameter(0);

    // check the return value. Either ID or special case

    if (getID < 1 )

        {

        var msg =″Sorry, Could not add < b > ″+ strFName + ″″+ strLName + ″</b > < br >″;

        switch (getID)

            {

                case -1 ;

                    msg += ″You are already a user in the system. ″+ ″< br > ″;

                }

                Response.Write(msg);

            }

        else if (getID >= 1 )

            {

            // Formulate the response message

            Recsponse.Write(″Welcome″+ strFName +″″+ strLName + ″< p > ″);

            }

}

< /script >

关于参量化查询的例子

这个参量化查询的例子为SQL语句设置参量，这个语句在Recordset设计期间控件中名字叫做“DTCRecordset1”。

为了简单，这里假设Recordset设计期间控件已经加到页面上，其数据库对象设置为“SQL Statement”，并且这个SQL Statement是“SELECT * FROM AUserWHETE email=?”。

在Recordset设计期间控件属性页面的Implementation Tab（实施标签卡）中，“Automatically open the recordset”（自动打开记录集）值已经取消检查。参量化查询只对ASP页面工作。

在这个例子中，要设置输入参量、打开记录集、然后返回参量，显示提醒条件。注意，在这个参量化查询中，参量数组是从零开始的。

< script language = javascript runat = server >

  function UserStatus(strEName)

    {

        DTCRecordset1.setParameter(0,strEName);

        DTCRecordset1.open( );

        if (DTCRecordset1.getCount ( ) > 0 )

        {

        var strFName = DTCRecordset1.fields.getValue(″FName″)

        var strLName = DTCRecordset1.fields.getValue(″LName″)

        Response.Write(″Welcome″+ strFName +″″+ strLName +″ < p > ″)

        }

        else

        {

        Response.Write(DTCRecordset1.getParameter(0)+ ″is not in the system″);

        }

    }

< /script >

参见

GETPARAMETER方法

SETPROPERTY方法

设置用户定义的属性值。

适用于

PageObject脚本对象

语法

object.setproperty

参量

object

PageObject脚本对象。

setproperty

规定用户定义的属性，其属性值是希望返回的。

说明

这个方法是由PageObject设计期间控件创建的。对于希望在PageObject控件的定制属性对话框的Properties标签卡上创建的每个属性，PageObject控件以这个属性为基础创建一对方法。例如，如果希望把一个属性加到PageObject控件上，而且命名为“Cost”，那么这个控件就创建getCost和setCost方法。

欲返回用户定义的属性值，就使用getproperty方法。

注意：

可以在PageObject控件的定制属性对话框的Properties标签卡上设置属性的作用域（读/写，客户/服务器）。

获取和设置用户定义属性值的另一种方式是使用getState和setState方法。

参见

GETPROPERTY方法

SETRECORDSOURCE方法

为打开一个Recordset对象，设置连接属性。

适用于

Recordset脚本对象

语法

object.setRecordSource ( rsADO | strConn, strSQL )

参量

object

Recordset脚本对象。

rsADO

一个ADO记录集。

strConn

规定数据连接。

strSQL

规定SQL语句。

说明

这个方法复原Recordset脚本对象中的所有属性。

在使用getRecordSource方法时，得到的是基本ADO Recordset Object，而不是复制品（clone,克隆）。要想调整这个对象，则需要使用setRecordSource把这个对象同Recordset脚本对象恢复同步。

举例

下边的脚本例子假设在页面上有两个Recordset设计期间控件RS1和RS2。当按下clone（克隆）按钮时，RS2就成为使用setRecordSource和getRecordSource方法的RS1的一个克隆。

< SCRIPT ID = clientEventHandlersJS LANGUAGE = javascript >

function btnClone_onclick( )

    {

    RS2.setRecordSource(RS1.getRecordSource( ) );

    }

< /SCRIPT >

在下边的简单脚本中，这个功能根据一个连接串（strconn）使一个记录集初始化。在按Init（初始化）按钮时，Recordset脚本对象RS2使用来自Server1上Pubs数据库中Authors表的内容进行初始化。

< SCRIPT ID = clientEventHandlersJS LANGUAGE = javascript >

function btnInit_onclick( )

    {

    RS2.setRecordSource(′DRIVER = SQL Server; SERVER = Server1; User ID = sa; PASSWORD = ; DATABASE = Pubs′, 慡elect * from authors′ );

    }

< /SCRIPT >

在这第三个例子中，假设有一个Visual Basic ActiveX DLL返回一个记录集。可以把这个记录集分配给Recordset脚本对象。

Sub myRs_onbeforeopen ( )

dim myObj

    set myObj = Server.CreateObject(″MyBusinessObject.MyClass″)

    myRs.setRecordSource(myobj.myRecorsetReturningFunction)

end Sub

参见

GETRECORDSOURCE方法

SETROWCOUNT方法

设置一个Textbox脚本对象的行数。

适用于

Textbox脚本对象

语法

object.gsetRowCount ( nRows )

参量

object

Textbox脚本对象。

nRows

规定行数的一个整数。

说明

行数决定文本框的高度。

参见

GETROWCOUNT方法

SETROWSOURCE方法

规定一个记录集，控件从这个记录集中提取自己的查询列表。

适用于

Listbox脚本对象, OptionGroup脚本对象

语法

setRowSource ( objDS, ListFieldName, BoundFieldName )

参量

objDS

数据源对象，对Microsoft Visual InterDev有效。例如，是一个Recordset对象。

ListFieldName

数据段，这个方法要从这个数据段中提取要显示的文本。

BoundFieldName

数据段，对象要把存储的数据绑定到这个数据段上。

说明

ListFieldName和BoundFieldName都是变量表达式，从它们得出一个数据段的名字或索引，而这个数据段是可由Recordset对象的getRecordSource方法所使用的。

参见

GETROWSOURCE方法

SETSQLTEXT方法

设置一个SQL语句，这个语句是在数据库中查询记录集时使用的。

适用于

Recordset脚本对象

语法

object.setSQLText ( strSQL )

参量

object

Recordset脚本对象。

strSQL

SQL语句。

说明

在客户脚本中（Microsoft Internet Explorer 4.0 DHTML），使用setSQLText方法将实际改变RDS控件的SQL属性，这样将导致对数据源的重查询，把记录集复原。

在服务器脚本（ASP）中，setSQLText方法的表现取决于下述因素：

l 如果在创建记录集之前调用setSQLText方法，这个setSQLText方法就为记录集设置SQL语句。

l 如果记录集已经打开，必须在设置这个SQLText之前把这个记录集关闭掉。

注意：

如果在服务器脚本（ASP）中使用setSQLText( )方法，SQLText将在下一次有人进入这个页面时得到维护。

举例

Sub myRS_onbeforeopen ( )

dim sQuery

    sQuery = ″select * from customers where lastname = ′Hoang″′

    myRS.setSQLText(sQuery)

End Sub

参见

GETSQLTEXT方法

SETSTATE方法

设置指定属性的值。

适用于

PageObject脚本对象

语法

object.setState ( property, value)

参量

object

PageObject脚本对象。

property

用户定义的可由PageObject控件创建的属性。

value

希望分配给property的值。

说明

欲删除这个属性，把null（空）提供给value参量。

可以使用getState方法返回一个具体属性的值。

获取或设置用户定义属性值的另一种方法使用getProperty和setProperty方法。

可以为PageObject定制属性对话框的Properties标签卡上的PageObject控件创建用户定义的属性。这也是可以设置这种属性作用域（读/写，客户/服务器）的地方。

有关创建和使用ASP页面属性的内容，详见Visual InterDev在线文档中的“Extending the Scripting Object Model Across Pages”。

参见

GETSTATE方法

SETSTYLE方法

适用于

Button脚本对象, Textbox脚本对象

语法

object.setStyle ( nStyle)

参量

object

一个Textbox或Button脚本对象。

nStyle

规定样式的整数。

说明

对于Button对象，nStyle可以设置为下列值：

对于Textbox，nStyle可以设置成下列值：

欲返回对象样式，则调用getStyle。

参见

GETSTYLE方法

SETTEXT方法

设置Listbox对象的一个项的文本串。

适用于

Listbox脚本对象

语法

object.setText ( strItem [,nIndex] )

参量

object

Listbox脚本对象。

strItem

在列表框中为该项显示的文本。

nIndex

以零开头列表中一个项的索引。如果留下的是null，则索引默认当前选定的项。当前选定项的索引相当于selectedIndex属性的值。

举例

function window_onload( )

{

    for ( i = 0; i < 5 ; i ++)

    {

    1stTest.addItem(″Item″ + i );

    }

    1stTest.selectedIndex = 3;

    1stText.setText(″pickMe″); // Changes the text of the 4th item,

        // which is the currently selected item

}

参见

GETTEXT方法， GETVALUE方法， SELECTBYCAPTION方法， SELECTBYINDEX方法， SELECTBYTEXT方法， SELECTBYVALUE方法， SETVALUE方法

SETVALUE方法

设置对象的值。

适用于

Listbox脚本对象, OptionGroup脚本对象, fields脚本对象

语法

object.setValue ( Value,[nIndex] )

参量

object

脚本对象。

Value

希望设置的值。

nIndex

以零开头的列表中一个项的索引。如果留下的是null，则索引默认当前选定的项。对于Listbox和OptionGroup对象来说，当前选定项的索引相当于selectedIndex属性的值。

说明

对于Listbox和OptionGroup对象，这种方法设置一个文本串，因为这个串对应于HTML属性VALUE。

参见

GETTEXT方法， GETVALUE方法， SELECTBYCAPTION方法， SELECTBYINDEX方法， SELECTBYTEXT 方法， SELECTBYVALUE方法， SETTEXT方法， SELECTEDINDEX属性

SHOW方法

使得控件在浏览页面时可见。

适用于

Checkbox脚本对象, Grid脚本对象, Label脚本对象, Listbox脚本对象,OptionGroup 脚本对象, PageObject脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.show ( )

参量

object

脚本对象。

说明

要小心，不要把display、hide和show几种方法搞混了。hide 和show两种方法决定对象在浏览页面的时候是否可见，而display方法决定对象是否包含在HTML流中。

举例

function btnCheck_onclick ( )

{

    if ( btnCheck.isVisible( ) ) //Toggle visibility of the checkbox

        Checkbox1.hide( );

    else

        Checkbox1.show( );

}

参见

DISPLAY方法， HIDE方法， ISVISIBLE方法

STARTPAGECONTENT方法

表示由一个ASP页面生成的客户文档内容开始处。只适用于服务器脚本。

适用于

PageObject脚本对象

语法

object.startPageContent ( )

参量

object

PageObject脚本对象。

说明

使用这个方法把文本传递给Response对象，以便把文本发送给浏览器。如果希望包含发送给浏览器的文本流，就使用endPageContent方法结束这个流。

这对从一个导航对象或从thisPage_onenter事件处理程序，调用startPageContent来说是很有用的。

举例

对编写分离的文本块来说，startPageContent和endPageContent方法很有用。

如按照下述例子俘获错误，这两种方法很好用。

function thisPage_onenter( )

{

    if (thisPage.getState(″Error″) == 57 )

    {

        startPageContent( );

        response.write ″Error 57: Please call Helpdesk. ″;

        endPageContent( );

    }

}

参见

ENDPAGECONTENT方法

UNADVISE方法

注销登记的对象。这种对象是用advise（通告）方法登记的。

适用于

Button脚本对象, Checkbox脚本对象, Listbox脚本对象, OptionGroup脚本对象, PageObject脚本对象, Recordset脚本对象, RecordsetNavbar脚本对象, Textbox脚本对象

语法

object.unadvise ( strEvent, id )

参量

object

脚本对象。

strEvent

停止恢复的事件。

id 从advise（通告）方法调用返回的一个标识符。

说明

如果成功，返回True。

使用advise（通告）方法通知一个具体函数对象，以便在事件出现的时候调用。

参见

ADVISE方法

UPDATERECORD方法

用变更的当前记录更新Recordset对象。

适用于

Recordset脚本对象

语法

object.updateRecord ( )

参量

object

Recordset脚本对象。

说明

在使用updateRecord方法的时候，onbeforeupdate事件在记录更新之前调用，而onafterupdate事件在记录更新之后调用。

可以使用下述方法移动光标，去选定当前记录：move、moveNext、movePrevious、moveFirst和moveLast。

在某些情况下，这种更新可能不出现，这是因为出现下列条件之一的缘故。每一种条件都会产生一种可俘获的错误。

• 操作违反基准完整性约束 数据库或Recordset对象尚未更新
• 用户没有完成操作的权限。

要想在Recordset中建立新记录，就使用addRecord方法。Microsoft VisualInterDev 脚本对象模型不支持批量更新。更新必须是一个记录一个记录地进行。

参见

ADDIMMEDIATE方法， ADDRECORD方法， CANCELUPDATE方法