Scripting Class

Namespace: Rebex.TerminalEmulation

Assembly: Rebex.Terminal.dll (version 7.0.9147)

Provides enhanced scripting functionality. Makes it possible to programmatically send commands and process responses.

Syntax

public class Scripting

Inheritance

Object

Scripting

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Properties

Name	Description
AutoMatchPrompt	Gets or sets whether to automatically match prompt in WaitFor(ScriptEvent), ReadUntil(ScriptEvent), ReadUntilPrompt(), ReadLine(), ReadChar() and CheckFor(ScriptEvent) methods. Default value is false.
FinalExitCode	Gets the exit code of the receiving channel when the connection was closed.
HoldReceivedData	Gets or sets a value indicating whether to hold received data in ReceivedData property. Default value is true.
LastResult	Gets the result of last called ReadUntilPrompt(), ReadLine(), ReadChar() or ReadUntil(ScriptEvent) method. Please note that calling other scripting methods reset this to null.
Prompt	Gets or sets the sequence that is used to detect command prompt. To use regular expressions, prepend the string with "regex:". To use wildcards, prepend the string with "mask:". Prompt sequence is used by ReadUntilPrompt() method (and other methods if Prompt is specified). To detect the current prompt automatically , use DetectPrompt() method.
ReceivedData	Gets data received since the previous data-receiving method. If HoldReceivedData is set to false, this returns null.
Terminal	Gets the containing terminal object.
Timeout	Gets or sets the timeout for receiving data in milliseconds. Default value is one minute.
TrimReadUntilResponse	Gets or sets a value indicating whether ReadUntilPrompt(), ReadLine(), ReadChar() and ReadUntil(ScriptEvent) methods remove the prompt or end-of-line from the returned value. Default value is true.

Methods

Name	Description
CheckFor(ScriptEvent)	Checks whether the specified condition is currently met.
CheckFor(ScriptEvent[])	Checks whether the specified conditions are currently met. The events are processed as if the OR operator was applied.
Close()	Closes the connection to the server.
DetectPrompt()	Detects the prompt which the server currently uses and sets the Prompt property.
KeepAlive()	Sends a keep alive packet (NOOP) to the server.
Process()	Processes response from the server. If no data is available to be received, waits until the Timeout interval expires.
Process(Int32)	Processes response from the server. If no data is available to be received, waits until the specified interval expires.
ReadChar()	Receives a printable character from the server.
ReadLine()	Receives response from the server until an end-of-line sequence is received.
ReadUntil(ScriptEvent)	Receives response from the server until the specified condition is met.
ReadUntil(ScriptEvent[])	Reads the response from previously sent command until the criteria are met. The events are processed as if the OR operator was applied.
ReadUntilPrompt()	Receives response from the server until the Prompt is received.
Send(FunctionKey)	Sends a key to the server. This is used for sending function keys such as Enter or F10.
Send(FunctionKey, ConsoleModifiers)	Sends a key to the server.
Send(ConsoleKey, ConsoleModifiers)	Sends a key to the server.
Send(ConsoleKeyInfo)	Sends a key to the server. This is used for sending simple keys or combinations such as Ctrl+C.
Send(String)	Sends text to the server.
SendBreak(Int32)	Sends a break request to the server. This may or may not have an effect, depending on the server. Sending Ctrl+C using Send(ConsoleKey, ConsoleModifiers) is usually more reliable.
SendCommand(String)	Sends a command to the server and waits for the server to accept it.
SendData(Byte[], Int32, Int32)	Sends raw data to the server.
WaitFor(ScriptEvent)	Receives response from the server until a condition is met.
WaitFor(ScriptEvent[])	Processes response from the server until a condition is met. The events are processed as if the OR operator was applied.