/// <summary>
/// Retrieve entries from the zipfile by specified criteria.
/// </summary>
///
/// <remarks>
/// <para>
/// This method allows callers to retrieve the collection of entries from the zipfile
/// that fit the specified criteria. The criteria are described in a string format, and
/// can include patterns for the filename; constraints on the size of the entry;
/// constraints on the last modified, created, or last accessed time for the file
/// described by the entry; or the attributes of the entry.
/// </para>
///
/// <para>
/// For details on the syntax for the selectionCriteria parameter, see <see
/// cref="AddSelectedFiles(String)"/>.
/// </para>
///
/// <para>
/// This method is intended for use with a ZipFile that has been read from storage.
/// When creating a new ZipFile, this method will work only after the ZipArchive has
/// been Saved to the disk (the ZipFile class subsequently and implicitly reads the Zip
/// archive from storage.) Calling SelectEntries on a ZipFile that has not yet been
/// saved will deliver undefined results.
/// </para>
/// </remarks>
///
/// <exception cref="System.Exception">
/// Thrown if selectionCriteria has an invalid syntax.
/// </exception>
///
/// <example>
/// <code>
/// using (ZipFile zip1 = ZipFile.Read(ZipFileName))
/// {
/// var UpdatedPhotoShopFiles = zip1.SelectEntries("*.psd", "UpdatedFiles");
/// foreach (ZipEntry e in UpdatedPhotoShopFiles)
/// {
/// // prompt for extract here
/// if (WantExtract(e.FileName))
/// e.Extract();
/// }
/// }
/// </code>
/// <code lang="VB">
/// Using zip1 As ZipFile = ZipFile.Read(ZipFileName)
/// Dim UpdatedPhotoShopFiles As ICollection(Of ZipEntry) = zip1.SelectEntries("*.psd", "UpdatedFiles")
/// Dim e As ZipEntry
/// For Each e In UpdatedPhotoShopFiles
/// ' prompt for extract here
/// If Me.WantExtract(e.FileName) Then
/// e.Extract
/// End If
/// Next
/// End Using
/// </code>
/// </example>
/// <param name="selectionCriteria">the string that specifies which entries to select</param>
///
/// <param name="directoryPathInArchive">
/// the directory in the archive from which to select entries. If null, then
/// all directories in the archive are used.
/// </param>
///
/// <returns>a collection of ZipEntry objects that conform to the inclusion spec</returns>
public ICollection<ZipEntry> SelectEntries(String selectionCriteria, string directoryPathInArchive)
{
Alienlab.FileSelector ff = new Alienlab.FileSelector(selectionCriteria,
AddDirectoryWillTraverseReparsePoints);
return ff.SelectEntries(this, directoryPathInArchive);
}
