ClearScript Library
ClearScript Library
ClearScript Library Reference
Microsoft.ClearScript.Windows.Core
JScriptEngine Class
JScriptEngine Constructor
JScriptEngine Properties
JScriptEngine Methods

# JScriptEngine Class

Represents an instance of the JScript engine.
Inheritance Hierarchy
SystemObject
Microsoft.ClearScriptScriptEngine
Microsoft.ClearScript.Windows.CoreWindowsScriptEngine
Microsoft.ClearScript.Windows.CoreJScriptEngine
Namespace: Microsoft.ClearScript.Windows.Core
Assembly: ClearScript.Windows.Core (in ClearScript.Windows.Core.dll) Version: 7.5.0
Syntax
C#
VB
C++
F#
Copy

    public class JScriptEngine : WindowsScriptEngine,
    	IScriptEngine, IDisposable

    Public Class JScriptEngine
    	Inherits WindowsScriptEngine
    	Implements IScriptEngine, IDisposable

    public ref class JScriptEngine : public WindowsScriptEngine,
    	IScriptEngine, IDisposable

    type JScriptEngine =
        class
            inherit WindowsScriptEngine
            interface IScriptEngine
            interface IDisposable
        end

The JScriptEngine type exposes the following members.

Constructors

| Name | Description
--- | --- | ---
| JScriptEngine(ISyncInvoker) | Initializes a new JScript engine instance.
| JScriptEngine(String, ISyncInvoker) | Initializes a new JScript engine instance with the specified name.
| JScriptEngine(WindowsScriptEngineFlags, ISyncInvoker) | Initializes a new JScript engine instance with the specified options.
| JScriptEngine(String, WindowsScriptEngineFlags, ISyncInvoker) | Initializes a new JScript engine instance with the specified name, options, and synchronous invoker.
| JScriptEngine(String, String, String, WindowsScriptEngineFlags, ISyncInvoker) | Initializes a new JScript engine instance with the specified programmatic identifier, name, list of supported file name extensions, options, and synchronous invoker.

Top
Properties

| Name | Description
--- | --- | ---
| AccessContext | Allows script code to access non-host resources. (Inherited from ScriptEngine)
| AllowReflection | Controls whether script code is permitted to use reflection. (Inherited from ScriptEngine)
| ContinuationCallback | Gets or sets a callback that can be used to halt script execution. (Inherited from ScriptEngine)
| CustomAttributeLoader | Gets or sets the script engine's custom attribute loader. (Inherited from ScriptEngine)
| DefaultAccess | Gets or sets the default script access setting for all members of exposed objects. (Inherited from ScriptEngine)
| DisableDynamicBinding | Enables or disables dynamic method binding. (Inherited from ScriptEngine)
| DisableExtensionMethods | Enables or disables extension method support. (Inherited from ScriptEngine)
| DisableFloatNarrowing | Enables or disables floating point narrowing. (Inherited from ScriptEngine)
| DisableListIndexTypeRestriction | Enables or disables type restriction for array and list elements retrieved by index. (Inherited from ScriptEngine)
| DisableTypeRestriction | Enables or disables type restriction for field, property, and method return values. (Inherited from ScriptEngine)
| DocumentSettings | Gets or sets the script engine's document settings. (Inherited from ScriptEngine)
| EnableAutoHostVariables | Enables or disables automatic host variable tunneling for by-reference arguments to script functions and delegates. (Inherited from ScriptEngine)
| EnableNullResultWrapping | Enables or disables null wrapping for field, property, and method return values. (Inherited from ScriptEngine)
| EnforceAnonymousTypeAccess | Enables or disables access restrictions for anonymous types. (Inherited from ScriptEngine)
| ExposeHostObjectStaticMembers | Controls whether host objects provide access to the static members of their exposed types to script code. (Inherited from ScriptEngine)
| FileNameExtension | Gets the script engine's recommended file name extension for script files. (Overrides ScriptEngineFileNameExtension)
| FormatCode | Enables or disables script code formatting. (Inherited from ScriptEngine)
| Global | Allows the host to access script resources. (Inherited from WindowsScriptEngine)
| HostData | Allows the host to attach arbitrary data to the script engine. (Inherited from ScriptEngine)
| HostWindow | Gets or sets an interface that supports the display of dialogs on behalf of script code. (Inherited from WindowsScriptEngine)
| Name | Gets the name associated with the script engine instance. (Inherited from ScriptEngine)
| NullExportValue | Gets or sets the script engine's null export value. (Inherited from ScriptEngine)
| NullImportValue | Gets or sets the script engine's null import value. (Inherited from ScriptEngine)
| Script | Allows the host to access script resources dynamically. (Inherited from WindowsScriptEngine)
| SyncInvoker | Gets the ISyncInvoker implementation associated with the current script engine. (Inherited from WindowsScriptEngine)
| UndefinedImportValue | Gets or sets the script engine's undefined import value. (Inherited from ScriptEngine)
| UseReflectionBindFallback | Enables or disables the use of reflection-based method binding as a fallback. (Inherited from ScriptEngine)
| VoidResultValue | Gets or sets the script engine's void result export value. (Inherited from ScriptEngine)

Top
Methods

| Name | Description
--- | --- | ---
| AddCOMObject(String, Guid) | Creates a COM/ActiveX object and exposes it to script code. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMObject(String, String) | Creates a COM/ActiveX object and exposes it to script code. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMObject(String, HostItemFlags, Guid) | Creates a COM/ActiveX object and exposes it to script code with the specified options. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMObject(String, HostItemFlags, String) | Creates a COM/ActiveX object and exposes it to script code with the specified options. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMObject(String, Guid, String) | Creates a COM/ActiveX object on the specified server and exposes it to script code. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMObject(String, String, String) | Creates a COM/ActiveX object on the specified server and exposes it to script code. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMObject(String, HostItemFlags, Guid, String) | Creates a COM/ActiveX object on the specified server and exposes it to script code with the specified options. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMObject(String, HostItemFlags, String, String) | Creates a COM/ActiveX object on the specified server and exposes it to script code with the specified options. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMType(String, Guid) | Imports a COM/ActiveX type and exposes it to script code. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMType(String, String) | Imports a COM/ActiveX type and exposes it to script code. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMType(String, HostItemFlags, Guid) | Imports a COM/ActiveX type and exposes it to script code with the specified options. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMType(String, HostItemFlags, String) | Imports a COM/ActiveX type and exposes it to script code with the specified options. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMType(String, Guid, String) | Imports a COM/ActiveX type from the specified server and exposes it to script code. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMType(String, String, String) | Imports a COM/ActiveX type from the specified server and exposes it to script code. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddCOMType(String, HostItemFlags, Guid, String) | Imports a COM/ActiveX type from the specified server and exposes it to script code with the specified options. The registered class is specified by class identifier (CLSID). (Inherited from ScriptEngine)
| AddCOMType(String, HostItemFlags, String, String) | Imports a COM/ActiveX type from the specified server and exposes it to script code with the specified options. The registered class is specified by programmatic identifier (ProgID). (Inherited from ScriptEngine)
| AddHostObject(String, Object) | Exposes a host object to script code. (Inherited from ScriptEngine)
| AddHostObject(String, HostItemFlags, Object) | Exposes a host object to script code with the specified options. (Inherited from ScriptEngine)
| AddHostType(Type) | Exposes a host type to script code with a default name. (Inherited from ScriptEngine)
| AddHostType(HostItemFlags, Type) | Exposes a host type to script code with a default name and the specified options. (Inherited from ScriptEngine)
| AddHostType(String, Type) | Exposes a host type to script code. (Inherited from ScriptEngine)
| AddHostType(String, HostItemFlags, Type) | Exposes a host type to script code with the specified options. (Inherited from ScriptEngine)
| AddHostType(String, String, Type) | Exposes a host type to script code. The type is specified by name. (Inherited from ScriptEngine)
| AddHostType(String, HostItemFlags, String, Type) | Exposes a host type to script code with the specified options. The type is specified by name. (Inherited from ScriptEngine)
| AddHostType(String, String, String, Type) | Exposes a host type to script code. The type is specified by type name and assembly name. (Inherited from ScriptEngine)
| AddHostType(String, HostItemFlags, String, String, Type) | Exposes a host type to script code with the specified options. The type is specified by type name and assembly name. (Inherited from ScriptEngine)
| AddHostTypes | Exposes host types to script code. (Inherited from ScriptEngine)
| AddRestrictedHostObjectT(String, T) | Exposes a host object to script code with the specified type restriction. (Inherited from ScriptEngine)
| AddRestrictedHostObjectT(String, HostItemFlags, T) | Exposes a host object to script code with the specified type restriction and options. (Inherited from ScriptEngine)
| CheckAccess | Determines whether the calling thread has access to the current script engine. (Inherited from WindowsScriptEngine)
| CollectGarbage | Performs garbage collection. (Inherited from WindowsScriptEngine)
| Dispose | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from ScriptEngine)
| Dispose(Boolean) | Releases the unmanaged resources used by the script engine and optionally releases the managed resources. (Inherited from WindowsScriptEngine)
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object)
| Evaluate(String) | Evaluates script code. (Inherited from ScriptEngine)
| Evaluate(DocumentInfo, String) | Evaluates script code with the specified document meta-information. (Inherited from ScriptEngine)
| Evaluate(String, String) | Evaluates script code with an associated document name. (Inherited from ScriptEngine)
| Evaluate(String, Boolean, String) | Evaluates script code with an associated document name, optionally discarding the document after execution. (Inherited from ScriptEngine)
| EvaluateDocument(String) | Loads and evaluates a script document. (Inherited from ScriptEngine)
| EvaluateDocument(String, DocumentCategory) | Loads and evaluates a document with the specified category. (Inherited from ScriptEngine)
| EvaluateDocument(String, DocumentCategory, DocumentContextCallback) | Loads and evaluates a document with the specified category and context callback. (Inherited from ScriptEngine)
| Execute(String) | Executes script code. (Inherited from ScriptEngine)
| Execute(DocumentInfo, String) | Executes script code with the specified document meta-information. (Inherited from ScriptEngine)
| Execute(String, String) | Executes script code with an associated document name. (Inherited from ScriptEngine)
| Execute(String, Boolean, String) | Executes script code with an associated document name, optionally discarding the document after execution. (Inherited from ScriptEngine)
| ExecuteCommand | Executes script code as a command. (Overrides ScriptEngineExecuteCommand(String))
| ExecuteDocument(String) | Loads and executes a script document. (Inherited from ScriptEngine)
| ExecuteDocument(String, DocumentCategory) | Loads and executes a document with the specified category. (Inherited from ScriptEngine)
| ExecuteDocument(String, DocumentCategory, DocumentContextCallback) | Loads and executes a document with the specified category and context callback. (Inherited from ScriptEngine)
| Finalize | Releases unmanaged resources and performs other cleanup operations before the script engine is reclaimed by garbage collection. (Inherited from ScriptEngine)
| GetHashCode | Serves as the default hash function. (Inherited from Object)
| GetStackTrace | Gets a string representation of the script call stack. (Inherited from WindowsScriptEngine)
| GetType | Gets the Type of the current instance. (Inherited from Object)
| Interrupt | Interrupts script execution and causes the script engine to throw an exception. (Inherited from WindowsScriptEngine)
| Invoke | Invokes a global function or procedure. (Inherited from ScriptEngine)
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object)
| ToString | Returns a string that represents the current object. (Inherited from Object)
| VerifyAccess | Enforces that the calling thread has access to the current script engine. (Inherited from WindowsScriptEngine)

Top
Remarks
This class can be used in non-desktop environments such as server applications. An implementation of ISyncInvoker is required to enforce thread affinity.
See Also

#### Reference

Microsoft.ClearScript.Windows.Core Namespace

Copyright © Microsoft Corporation. All rights reserved.

Send comments on this topic to Microsoft