Extract Method (ExtractionCursor, String, String, ActionType)

Response Extract Method (ExtractionCursor, String, String, ActionType)

C# API

Extracts text from the response content - everything between (but not including) the specified before and after string objects - returning an empty string if they cannot be found, and specifying what action to take in case of failure.

Namespace: Facilita.Web
Assembly: clrWebBrowser (in clrWebBrowser.dll) Version: 9.5.8.37 (1.0.0.0)

Syntax

C++

Copy to Clipboard Print

public string Extract(
	ExtractionCursor cursor,
	string before,
	string after,
	ActionType failAction
)

public string Extract(
	ExtractionCursor cursor,
	string before,
	string after,
	ActionType failAction
)

Parameters

cursor: Type: Facilita.Native ExtractionCursor
An ExtractionCursor object to store the success/failure of the action, and the index in the response at which the match was found.

before: Type: System String
This text is searched for in the response content, and the returned string starts immediately after this text occurs in the content.

after: Type: System String
This text is searched for in the response content after the before text has been found, and the returned string ends immediately before this text occurs in the content.

failAction: Type: Facilita.Fc.Runtime ActionType
The action to take if the text cannot be found.

Return Value

The extracted text, or an empty string if the extract failed.

Remarks

Information about the success/failure of this method will be stored in the ExtractionCursor object passed.

Note
The search is case-sensitive.

Examples

The following example demonstrates extracting text from a HTML Response, and causing a warning to appear in the Virtual User event log if the text could not be found.

C++

Copy to Clipboard Print

Response response = request.Send();
ExtractionCursor cursor = new ExtractionCursor();

// extract the value from the HTML text 
// <input type="text" name="f_customer" size="32" maxlength="32" value="Joe Smith"> 
string extractedText = response.Extract(
                        cursor,
                        "value=\"",
                        "\"",
                        ActionType.ACT_WARNING);

WriteMessage(string.Format("The value {0} was found at position {1}", extractedText, cursor.Index));

Response response = request.Send();
ExtractionCursor cursor = new ExtractionCursor();

// extract the value from the HTML text 
// <input type="text" name="f_customer" size="32" maxlength="32" value="Joe Smith"> 
string extractedText = response.Extract(
                        cursor,
                        "value=\"",
                        "\"",
                        ActionType.ACT_WARNING);

WriteMessage(string.Format("The value {0} was found at position {1}", extractedText, cursor.Index));