AddRange(Document[]) Method

Adds the documents of the specified array to the end of the DocumentCollection.

Syntax

public void AddRange( 
   Document[] documents
)

Parameters

documents

Type: Zennolab.CommandCenter.Document[]

The array whose documents should be added to the end of the DocumentCollection. The collection itself cannot be null.

Remarks

The order of the elements in the collection is preserved in the DocumentCollection.

Example

The following code example demonstrates the AddRange method and various other methods of the DocumentCollection class that act on ranges.The AddRange method is called, with the array as its argument. The result is that the current elements of the list are added to the end of the list, duplicating all the elements.

public static int Execute(Instance instance, IZennoPosterProjectModel project)
{
    // clear cookie
    instance.ClearCookie();
    
    // go to zennolab.com
    Tab tab = instance.MainTab;
    if ((tab.IsVoid) || (tab.IsNull)) return -1;
    if (tab.IsBusy) tab.WaitDownloading();
    tab.Navigate("zennolab.com");
    if (tab.IsBusy) tab.WaitDownloading();
    
    // get all documents from zennolab.com
    DocumentCollection docCol = tab.AllDocuments;
    
    // go to lessons.zennolab.com
    if ((tab.IsVoid) || (tab.IsNull)) return -1;
    if (tab.IsBusy) tab.WaitDownloading();
    tab.Navigate("lessons.zennolab.com");
    if (tab.IsBusy) tab.WaitDownloading();
    
    // get all documents from lessons.zennolab.com
    DocumentCollection newDocCol = tab.AllDocuments;
    
    // add elements from second collection to first collection
    docCol.AddRange(newDocCol.Documents);
    
    return 0;
}

public static function Execute($instance, $project)
{
    // clear cookie
    $instance->ClearCookie();
    
    // go to zennolab.com
    $tab = $instance->MainTab;
    if (($tab->IsVoid) || ($tab->IsNull)) return -1;
    if ($tab->IsBusy) $tab->WaitDownloading();
    $tab->Navigate("zennolab.com");
    if ($tab->IsBusy) $tab->WaitDownloading();
    
    // get all documents from zennolab.com
    $docCol = $tab->AllDocuments;
    
    // go to lessons.zennolab.com
    if (($tab->IsVoid) || ($tab->IsNull)) return -1;
    if ($tab->IsBusy) $tab->WaitDownloading();
    $tab->Navigate("lessons.zennolab.com");
    if ($tab->IsBusy) $tab->WaitDownloading();
    
    // get all documents from lessons.zennolab.com
    $newDocCol = $tab->AllDocuments;
    
    // add elements from second collection to first collection
    $docCol->AddRange($newDocCol->Documents);
    
    return 0;
}

Requirements

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

Reference

DocumentCollection Class
DocumentCollection Members
Overload List
Add Method
Insert Method
InsertRange Method
Remove Method