Skip to content

TaskFolder.EnumerateFolders has no recursion option #1009

Closed

Description

@CatBraaain

documentation bug

In the documentation for the TaskFolder.EnumerateFolders method, the following description is provided:
Returns an enumerable collection of folders that matches a specified filter and recursion option.

However, the actual method signature is:

public IEnumerable<TaskFolder> EnumerateFolders(
    Predicate<TaskFolder> filter = null
)

There is no recurse or similar boolean parameter in the method definition, unlike EnumerateTasks, which does include a recursion option:

public IEnumerable<Task> EnumerateTasks(
    Predicate<Task> filter = null,
    bool recurse = false
)

This inconsistency may mislead developers into expecting a recursive folder enumeration capability which does not exist in the method signature.

Expected:

The method should include a bool recurse parameter, as the description implies, or the documentation should be corrected to reflect that recursion is not currently supported by EnumerateFolders.

references

https://dahall.github.io/TaskScheduler/html/M_Microsoft_Win32_TaskScheduler_TaskFolder_EnumerateFolders.htm
https://dahall.github.io/TaskScheduler/html/M_Microsoft_Win32_TaskScheduler_TaskFolder_EnumerateTasks.htm

Thank you for maintaining this library.

Activity

  1. dahall commented on Jul 8, 2025

    @dahall
    Owner

    Thank you for bringing this omission to my attention. I have added that parameter and functionality in release 2.12.2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      ⌂ 换网址