Name

Set Statement

Syntax

Set objectvar = (objectexpression | New classname Nothing)
objectvar

Use: Required

Data Type: Object

The name of the object variable or property.

objectexpression

Use: Optional

Data Type: Object

An expression evaluating to an object.

New

Use: Optional

Type: Keyword

Creates a new instance of an object defined using the Class...End Class construct, or with the syntax New RegExp instantiates the Regular Expression object.

classname

Use: Required

Data Type: String literal

The name of the class defined by the Class...End Class construct to be instantiated.

Nothing

Use: Optional

Type: Keyword

Assigns the special data type Nothing to objectvar, thereby releasing the reference to the object.

Description

Assigns an object reference to a variable or property.

Rules at a Glance

  • objectvar doesn’t hold a copy of the underlying object; it simply holds a reference to the object.

  • If the New keyword is used is used to instantiate a VBScript class defined using the Class...End Class construct, a new instance of the class is immediately created and its Class Initialize event fires. This applies only to classes defined using the Class...End Class construct.

    You can also instantiate a Regular Expression object with the New keyword by using a statement like the following:

            Set oRegExp = New RegExp
  • All classes defined by the Class...End Class construct can be created using the New keyword. For external objects, the application’s object model determines which objects can be created and which cannot.

  • If objectvar ...

Get VBScript in a Nutshell, 2nd Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.