Extends the generic Find methods to include HTML specific find objects.
Inheritance Hierarchy
ArtOfTest.WebAii.CoreFind
ArtOfTest.WebAii.Controls.HtmlControlsHtmlFind
Namespace: ArtOfTest.WebAii.Controls.HtmlControls
Assembly: ArtOfTest.WebAii (in ArtOfTest.WebAii.dll) Version: 2018.1.116.0 (2018.1.116.0)
Syntax
The HtmlFind type exposes the following members.
Constructors
Name | Description | |
---|---|---|
HtmlFind |
Create a new Find object.
|
Properties
Name | Description | |
---|---|---|
AssociatedBrowser |
Gets the browser object that is associated with this find object.
If this property is null, then the Find object is associated with a search region.
(Inherited from Find.) | |
FindReferenceType |
Gets the reference type that this Find object is using. (i.e. browser root, testregion ... etc)
(Inherited from Find.) | |
IgnoreFindAllControlMismatch |
Gets/Sets whether to ignore Find.Allxx<TControl>(...) elements
that don't match the TControl specified. (i.e. the TControl type validation fails for
that element). If false, the Find.Allxx method will throw an exception.
(Inherited from Find.) | |
LastFindParam |
Gets the last FindParam used to search.
(Inherited from Find.) | |
LastSearchLog |
Gets the search log for the last find attempt. This log can help diagnose when
find fails to locate an element.
(Inherited from Find.) | |
SearchRegion |
Gets the search region for this Find object. When this is set to a specific region, all search is done locale
to that region. All indexes are calculated starting at zero from this region's element.
If this property is null, then the Find object will perform all searches from the document
root element.
(Inherited from Find.) | |
SearchRootElement |
Gets/Sets the root element that all searches will be performed under.
This element depended on the reference type. [Browser/TestRegion/Element].
(Inherited from Find.) | |
ThrowIfNullOrEmpty |
Gets/Sets whether to throw an exception if any of the find methods returns a null element or any of
the find all methods return empty list of elements.
(Inherited from Find.) |
Methods
Name | Description | |
---|---|---|
AllByAttributes(String) |
Returns a list of elements that have attributes that match the NameValuePairs passed it
fully or partially.
(Inherited from Find.) | |
AllByContent(String) |
Returns a list of elements that have TextContent that match the specified content
The content must start with:
'l:' for exact match strings, 'p:' for partial strings or 'x:' for regular expression
matches. If none are provided, the string will be matched using an exact match 'l:'.
All searches are case-insensitive.
(Inherited from Find.)Examples Remarks Text1
InnerText for div1 : Text1Text2 {recursive}
TextContent of div1 : Text1 {non-recursive}
Default for ByContent is TextContent which is the most common usage.
Text2 | |
AllByContent(String, FindContentType) |
Returns a list of elements that match the specified content.
The content must start with:
'l:' for exact match strings, 'p:' for partial strings or 'x:' for regular expression
matches. If none are provided, the string will be matched using an exact match 'l:'.
All searches are case-insensitive.
(Inherited from Find.)Examples Remarks Text1
InnerText for div1 : Text1Text2 {recursive}
TextContent of div1 : Text1 {non-recursive}
Default for ByContent is TextContent which is the most common usage.
Text2 | |
AllByCustom(PredicateElement) |
Return all elements that match the predicate
(Inherited from Find.) | |
AllByCustomTControl(PredicateTControl) |
Returns all controls that match the predicate and are convertable to TControl.
(Inherited from Find.) | |
AllByExpression(String) |
Find all elements by HTML find expression strings.
(Inherited from Find.) | |
AllByExpression(HtmlFindExpression) |
Find all elements by HtmlFindExpression.
(Inherited from Find.) | |
AllByTagName(String) |
Returns a list of elements with a specific tag name.
(Inherited from Find.) | |
AllByXPath(String) |
Returns a list of elements that match the specified XPath. This function supports
the System.Xml XPath syntax.
(Inherited from Find.) | |
AllControlsTControl |
Gets an IEnmerable for TControl to be used for LINQ queries.
This will return only elements that are convertable to TControl
(Inherited from Find.) | |
AllElements |
Gets a IEnumerable for all elements to be used for LINQ queries
(Inherited from Find.) | |
ByAttributes(String) |
Returns a an element that has attributes that match the NameValuePairs passed it.
All matching is case-insensitive.
(Inherited from Find.) | |
ByContent(String) |
Returns an element by searching its TextContent.
The content must start with:
'l:' for exact match strings, 'p:' for partial strings or 'x:' for regular expression
matches. If none are provided, the string will be matched using an exact match 'l:'.
All searches are case-insensitive.
(Inherited from Find.)Examples | |
ByContent(String, FindContentType) |
Returns an element by searching its content with the options to pick the
content type. (InnerText, InnerMarkup or OuterMarkup)
The content must start with:
'l:' for exact match strings, 'p:' for partial strings or 'x:' for regular expression
matches. If none are provided, the string will be matched using an exact match 'l:'.
All searches are case-insensitive.
(Inherited from Find.)Examples Remarks Text1
InnerText for div1 : Text1Text2 {recursive}
TextContent of div1 : Text1 {non-recursive}
Default for ByContent is TextContent which is the most common usage.
Text2 | |
ByContent(String, FindContentType, String) |
Returns an element by searching its content with the options to pick the
content type. (InnerText, InnerMarkup or OuterMarkup) in addition to a list
of attributes.
The content must start with:
'l:' for exact match strings, 'p:' for partial strings or 'x:' for regular expression
matches. If none are provided, the string will be matched using an exact match 'l:'.
All searches are case-insensitive.
(Inherited from Find.)Examples Remarks Text1
InnerText for div1 : Text1Text2 {recursive}
TextContent of div1 : Text1 {non-recursive}
Default for ByContent is TextContent which is the most common usage.
Text2 | |
ByCustom(PredicateElement) |
Return the element that matches the defined predicate.
(Inherited from Find.) | |
ByCustomTControl(PredicateTControl) |
Get a control by using custom predicate. This function will try to eliminate any elements
that are not convertable to TControl type.
(Inherited from Find.) | |
ByExpression(HtmlFindExpression, Boolean) |
Find Element by HtmlFindExpression.
(Inherited from Find.) | |
ByExpressionTControl(String) |
Find element by HTML find expression strings of type TControl.
(Inherited from Find.) | |
ByExpressionTControl(HtmlFindExpression) |
Find element by HtmlFindExpression of type TControl.
(Inherited from Find.) | |
ById(String) |
Returns an element by looking for its 'id' attribute value.
(Inherited from Find.) | |
ByName(String) |
Returns an element by searching for its 'name' attribute value
(Inherited from Find.) | |
ByNodeIndexPath(String) |
Returns an element by searching for it using a node index path.
(Inherited from Find.)Examples For example: This call: ByNodeIndexPath("0/2/0/1") describes the <target></target> element in the below hierarchy: <referenceElement> (0)<foo> <bar> </bar> <car> </car> (2)<bus> (0)<driver> <cap> </cap> (1)<target> </target> </driver> </bus> </foo> </referenceElement> | |
ByTagIndex(String, Int32) |
Returns an element by its tag name occrrence.
(Inherited from Find.) | |
ByXPath(String) |
Returns an element using an XPath. This function supports
the System.Xml XPath syntax.
(Inherited from Find.) | |
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) | |
FromCollection |
Finds all elements with the HtmlFindExpressions in the collection.
(Inherited from Find.) | |
FromExpressionsFile |
Finds all elements with FindExpressions defined in a file.
(Inherited from Find.) | |
FromExpressionsXml |
Finds all elements with FindExpressions defined in the serialized xml string.
(Inherited from Find.) | |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
Table |
Finds the first table that contains the cell text content specified.
| |
TableCell |
Finds the first table cell that contains the text content specified. If the text is contained
by a control inside that table cell, this method will not find that cell.
| |
TableRow |
Finds the first table row that contains the cell text content specified.
| |
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Events
Name | Description | |
---|---|---|
ReturnedNullOrEmpty |
Invoked when one of the find methods returns null or an empty list of elements.
(Inherited from Find.) |
Extension Methods
Name | Description | |
---|---|---|
jQuery |
Creates and returns a new jQuery object for the Find object.
(Defined by jQueryExtension.) |
See Also