这些属性只用于脚本对象模型。对于适用于设计期间控件的属性列表，参见本手册前边“设计期间控件属性”。

ABSOLUTEPOSITION属性

规定当前记录在记录集中的绝对位置。

适用于

Recordset脚本对象

语法object.absolutePosition[=index]

参量

object

一个记录集脚本对象

index

规定索引的绝对位置。

说明

这个记录集的索引是从1开始的。

参见

RECORDSET设计期间控件， RECORDSET脚本对象， BOF属性， EOF属性

ALT属性（脚本对象模型）

如果指定的图像不能用，则此属性用于指定按钮上显示的替换文本。此属性在客户脚本（Microsoft Internet Explorer 4.0）运行期间不能用。

适用于

Button脚本对象

语法

objButton.alt

参量

objButton

一个按钮脚本对象

说明

在图像装载期间也显示这个替换文本，它的表现就像Microsoft InternetExplorer 4.0浏览器中的ToolTip。

参见

BUTTON设计期间控件， BUTTON脚本对象

BOF属性

规定光标是否定位在Recordset对象中第一个记录之前。运行期间为只读性质。在设计期间不能使用。

适用于

Recordset脚本对象

语法

object.BOF

参量

object

一个记录集脚本对象

说明

这个属性包含一个布尔值。如果值为真，则光标定位在记录集对象中第一个记录之前。否则，该值为假。

使用这个属性避免在记录集第一个记录之前进行备份。

注意：

这个属性确定光标是否定位在记录集第一个记录之前。使用EOF属性规定光标是否定位在记录集最后记录之后。

举例

下边VBScript示范在记录集中以相反方向进行移动：

MyRecordset.moveLast

Do While not MyRecordset.BOF

Response.write MyRecordset.fields.getValue("myfield”)

MyRecordset.movePrevious

Loop

参见

RECORDSET设计期间控件， RECORDSET脚本对象， ABSOLUTEPOSITION属性， EOF属性

CANCELEVENT属性

确定在客户机上出现的事件是否从客户机传递到服务器进行处理。只在客户脚本中有效。

适用于

PageObject脚本对象

语法

thisPage.cancelEvent[=Boolean]

参量

Boolean

如果设置为真，则窗体将不传递给服务器去调用服务器的事件处理程序。如果是假（默认），则传递窗体。

说明

一个客户动作可以使得一个脚本对象调用一个服务器功能去处理事件。如果出现一个onbeforeserverevent事件，便在窗体传递给服务器之前调用。

onbeforeserverevent事件的比较好的用法是在窗体传递给服务器之前对客户机的数据进行验证。如果此后希望避免递交，就把cancelEvent属性置为真。

举例

下边是在一次删除按钮时，俘获按钮点击事件的例子。这个脚本在处理删除之前提示用户加以确认。

< SCRIPT LANGUAGE = javascript >

function thisPage_onbeforeserverevent( obj, event ) {

if (obj == “btnDelete” {

    if (event ==onclick”){

        if (confirm( Are you sure you want to Delete”)) {

            alert( Deleted per your request?;

        }

        else {

            alert ( Delete cancelled”;

            thisPage.cancelEvent = true;

        }

     }

   }

}

< /SCRIPT >

参见

PAGEOBJECT设计期间控件， ONBEFORESERVEREVENT事件， PAGEOBJECT脚本对象

DISABLED属性

规定这个对象是否对用户的输入作出响应。

适用于

Checkbox脚本对象，Listbox脚本对象，Textbox脚本对象

语法

object.disabled [ = Boolean]

参量

object

一个脚本对象

Boolean

如果是假（默认），该对象允许对用户输入作出响应。如果是真，则对象不能响应。

说明

在编辑拥有Enabled（允许）属性的设计期间控件的时候，这个设计期间控件设置该关闭脚本对象属性（本节原文是disabled Property，而在这里原文是disabled script object property。棗译者注）。当Enabled设计期间属性为真时，这个“关闭脚本对象”属性便是假。类似，在Enabled属性为假时，“关闭脚本对象”为真。

这个属性对应于数据对象模型中的关闭属性。

参见

ENABLED属性

EOF属性

规定光标是否定位在Recordset后边。运行期间为只读型。在设计期间不能使用。

适用于

Recordset脚本对象

语法

object.EOF

参量

object

一个记录集脚本对象

说明

这个属性包含一个布尔值。如果该值为真，则光标定位在记录集对象中最后记录之后。否则，该值为假。

使用这个属性可以避免移动到记录集最后记录之后。

注意：

这个属性确定光标是否定位在记录集最后记录之后。

使用EOF属性规定光标是否定位在记录集最后记录之后。

举例

在下边VBScript例子中，只要光标不定位在记录集末尾之后，“myfield”的值就写到页面中：

Do While not MyRecordset.EOF

    Response.write MyRecordset.fields.getValue(“myfield”)

    MyRecordset.moveNext

Loop

参见

ABSOLUTEPOSITION属性, BOF属性

FIELDS属性

规定字段脚本对象的一个实例。

适用于

Recordset脚本对象

语法

object.field

参量

object

一个Recordset组脚本

说明

这个字段脚本对象是Recordset脚本对象的一个子对象。

举例

在下边VBScript例子中，只要光标不定位在记录集末尾之后，“myfield”的值就写到页面中：

Do While not MyRecordset.EOF

    Response.write MyRecordset.fields.getValue( “myfield”)

    MyRecordset.moveNext

Loop

参见

RECORDSET设计期间控件， RECORDSET脚本对象

FIRSTENTERED属性

指明浏览器是刚刚导航到“激活服务器页面”（Active Server Page-ASP）,还是因为往返于服务器传递窗体的结构而导航到正被处理的页面。在运行期间为只读型。

适用于

PageObject脚本对象

语法

thisPage.firstEntered

说明

这个属性包含一个布尔值。如果ASP页面因为浏览器导航到该页面（HTTPGET）而正被处理，则firstEntered为真。如果这个页面因为往返于服务器传递一个窗体（HTTP POST）而正被处理，则firstEntered为假。

这对使用这个属性以及PageObject对象的onenter事件来确定是否需要把初始值分配给属性是很有用的。

举例

下边脚本为一个检查框赋初始值：

< SCRIPT RUNAT = SERVER LANGUAGE = JSCRIPT >

function thisPage_onenter ( )

{

    if (thisPage.firstEntered)

        Chenckbox1.setChecked(true);

} 

< /SCRIPT >

参见

PAGEOBJECT脚本对象

ID属性（脚本对象模型）

为一个脚本对象规定唯一的标识符。在运行期间为只读型。

适用于

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

语法

[strID =] object.id

参量

strID

标识对象的一个字符串。对每个页面是唯一的。串必须以字符开始，后边跟着字符数字。例如CeckboxStock和c24546是可接受的，而4CheckBox是不可接受的。

Object.

一个脚本对象。

说明

这个id属性值是要编写脚本的对象名字。此外，这个值是ID属性，这个属性是要分配给要发送给浏览器的HTML标记的。

当这个对象被一个设计期间控件创建的时候，这个id和名字脚本对象属性都由这个设计期间控件的id属性来设置。因此，典型的脚本对象名字和id属性都有一个标识值。

在编辑设计期间控件的时候：

· 设计期间id属性出现在Properties窗口中。

· 设计期间id属性映射到设计期间控件的Property Pages对话框的General标签卡上的Name属性中。

参见

NAME属性， ID属性(设计期间控件)

MAINTAINSTATE属性

规定对象状态是否通过服务器处理而得到维护。

适用于

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

语法

object.maintainState [=Boolean]

参量

object

一个脚本对象

Boolean

如果设置为真（默认），便维护对象状态。

说明

在maintainState属性设置为真（默认）时，脚本对象通过服务器处理来维护它们的属性和值。如果脚本平台设置为客户（Microsoft Internet Explorer 4.0DHTML），则不用这个属性，这是因为这个对象状态已经在DHTML中由客户进程处理了。

NAME属性

规定脚本对象的名字。在运行期间为只读型。

适用于

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

语法

[strName =] object.name

参量

strName

标识对象的一个字符串。串必须以字符开始，后边跟着字符数字。例如CheckboxStock和c24546是可接受的，而4CheckBox是不允许的。

Object

一个脚本对象

说明

当这个对象被一个设计期间控件创建的时候，这个id和名字脚本对象属性都由这个设计期间控件的id属性来设置。因此，典型的脚本对象名字和id属性都有一个标识值。

注意：

在编写脚本时，正是这个id属性标识一个脚本。

在编辑设计期间控件的时候：

· 设计期间id属性出现在Properties窗口中。

· 设计期间id属性映射到设计期间控件的Property Pages对话框的General标签卡上的Name属性中。

参见

ID属性(设计期间控件)

NAVIGATETARGET属性

为导航规定一个目标，例如一个帧。只用于客户脚本。

适用于

PageObject脚本对象

语法

object.navitageTarget

参量

object

一个PageObject对象

说明

这个navigateTarget属性影响导航方法的功能。这里的导航方法是navigateURL和在导航脚本对象上发布的方法。

这个属性使得使用Microsoft Visual InterDev脚本对象模型变得容易，而且还使用帧组，从而有可能强制在不同帧内进行导航。

NavigateTarget的默认值是窗口对象，这个窗口对象导致对更新当前帧的过程进行导航。然而，navigateTarget可以设置为不同的帧，这样将导航到的页面就强制出现在这个帧中。

注意：

任何窗口都可以分配给navigateTarget，其中包括从window.open( )功能返回的值。

举例

 < SCRIPT LANGUAGE=javascript >

thisPage.navigateTarget = parent.frames.MyFrame;

MyPage.navigate.MyMethod( );

< /SCRIPT >

上述脚本调用MyPage上的MyMethod并在MyFrame中显示结果页面。在同内容分开的帧中组建一个导航条时，这个navigateTarget属性非常有用。导航按钮可以有代码，像上述例子那样，控制在内容帧中显示。

PAGESIZE属性（脚本对象模型）

在按下“Previous”或“Next”按钮时，此属性指出光标在记录集中移动所经过的记录数。

适用于RecordsetNavbar脚本对象

语法

object.pageSize [=number]

参量

object

一个RecordsetNavbar脚本对象

number

一个正整数。

说明

按照默认设置，RecordsetNavbar 对象的“Previous”和“Next”按钮，把光标的位置在记录集中移动一个记录。如果pageSize属性设置为大于1的数，则光标就按照这个属性的数向前或向后移动，移动的记录数与这个属性指定的记录数相同。

参见

RECORDSET脚本对象

SELECTEDINDEX属性

表示当前选择项的索引。

适用于

Listbox脚本对象

语法

object.selectedIndex [ = index]

参量

object

一个Listbox（列表框）脚本对象

index

按照下表描述的规定当前选择项的索引：

说明

列表中第一项的索引是0。getCount方法总是比selectedIndex的值多1。

举例

使用DHTML中的窗口onload（装载）事件填充一个listbox（列表框）：

function window_onload( )

{

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

    {

        myListbox.addItem(“Item”+ i );

    }

    myListbox.selectedIndex = 3; // select the 4th item

}

参见

GETCOUNT方法， GETSELECTEDINDEX方法

SIZE属性

规定在一个列表框中要显示的项数。

适用于

Listbox脚本对象

语法

object.size[ = number ]

参量

object

一个列表框脚本对象

number

一个正整数

说明

确定在列表框中要显示的项数。在使用Listbox设计期间控件时，Lines（行）属性便映射成这个规模脚本对象属性。

参见

LINES属性

SRC属性

规定一个按钮上要出现的图像的URL。

适用于

Button脚本对象

语法

object.src

参量

object

一个按钮脚本对象

说明

这个URL可以是相对的也可以是绝对的。例如Images/Greenleaves.Gif和/UploadFiles3/200631720851734.gif都是可接受的。如果在一个Button对象上选择显示图像，就要用altText属性规定替换文本。

参见

ALTTEXT属性(设计期间控件)， ALT属性(脚本对象模型)

UPDATEONMOVE属性（脚本对象模型）

决定Recordset（记录集）对象是否在用户点击一个RecordsetNavbar按钮时更新。

适用于

RecordsetNavbar脚本对象

语法

object.updateOnMove [=Boolean]

参量

object

一个RecordsetNavbar脚本对象

Boolean

如果是真，这个Recordset对象便更新；如果是假，则不更新。

说明

任何时候用户点击RecordsetNavbar按钮中的一个按钮，Recordset对象的光标位置便移动。

注意：

这个属性只能用于RecordsetNavbar对象。在调用某一种移动方法时，这个属性不能使记录集更新。

VALUE属性（脚本对象模型）

为VALUE属性规定一个串。

适用于

Button脚本对象, Checkbox脚本对象, Textbox脚本对象

语法

object.value

参量

object

一个脚本对象

说明

这个值属性设置VALUE属性，而脚本对象创建的内部HTML便使用这个属性。

对于Button对象，这个属性规定在按钮上要出现的下一个串。

举例

每当用户点击Button1Textbox1的值，如果Textbox1的值用户没设置，就赋予“默认”值。

< SCRIPT LANGUAGE = javascript >

function Button1_onclick( ) {

if (Textbox1.value ==””)

    {

    Textbox1.value = “default”

    }

}

< /SCRIPT >