ZennoLab Assemblies Documentation
FindElementByName Method (Document)
Example 
ZennoLab.CommandCenter Namespace > Document Class : FindElementByName Method

Type: System.String

The name that defines search condition of HTML elements.

Searches for an element by the name, and returns the first occurrence.
Syntax
public HtmlElement FindElementByName( 
   string name
)

Parameters

name

Type: System.String

The name that defines search condition of HTML elements.

Return Value

Type: Zennolab.CommandCenter.HtmlElement

The first element that matches the conditions defined by the name, if found; otherwise, the result is void.

Remarks
If html element was not found then this method returns the HtmlElement object in which IsVoid or IsNill property is "true".
Example
The following code example demonstrates uses of the FindElementByName method.
public static int Execute(Instance instance, IZennoPosterProjectModel project)
{
    // clear cookie
    instance.ClearCookie();
    
    // go to lessons.zennolab.com
    Tab tab = instance.MainTab;
    if ((tab.IsVoid) || (tab.IsNull)) return -1;
    if (tab.IsBusy) tab.WaitDownloading();
    tab.Navigate("lessons.zennolab.com", "");
    if (tab.IsBusy) tab.WaitDownloading();
    
    // find html element by name
    HtmlElement he = tab.MainDocument.FindElementByName("text");
    if (he.IsVoid) return -1;
    
    return 0;
}
public static function Execute($instance, $project)
{
    // clear cookie
    $instance->ClearCookie();
    
    // go to lessons.zennolab.com
    $tab = $instance->MainTab;
    if (($tab->IsVoid) || ($tab->IsNull)) return -1;
    if ($tab->IsBusy) $tab->WaitDownloading();
    $tab->Navigate("lessons.zennolab.com", "");
    if ($tab->IsBusy) $tab->WaitDownloading();
    
    // find html element by name
    $he = $tab->MainDocument->FindElementByName("text");
    if ($he->IsVoid) return -1;
    
    return 0;
}
Requirements

Target Platforms: Desktop: Windows XP SP3 and older. Server: Windows Server 2003 and older.

See Also

Reference

Document Class
Document Members
FindElementByAttribute Method
FindElementById Method
FindElementByTag Method
FindElementByXPath Method
FindElementsByAttribute Method
FindElementsById Method
FindElementsByName Method
FindElementsByTags Method
FindElementsByXPath Method
QuerySelector Method
QuerySelectorAll Method