[Canonical page](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/profile-tasks/>)
[Full documentation index](<https://docs.dhtmlx.com/planning-engine/llms.txt>)


# ProfileTasks

Selects which buckets of a load profile list the tasks booked in them. Set it through [`ProfileQuery.Tasks`](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/profile-query.md>); the lists land in [`LoadBucket.Tasks`](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/load-profile.md#loadbucket>). The default is `None`.

## Declaration

```csharp
namespace Plen;

public enum ProfileTasks
{
    None,
    Over,
    All,
}
```

## Variants

| Variant | Description |
|---|---|
| `None` | Default. No bucket lists tasks: [`LoadBucket.Tasks`](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/load-profile.md#loadbucket>) is `null` in every bucket. |
| `Over` | Buckets where `Load > Capacity` list their booked tasks. Every other bucket gets an empty list. |
| `All` | Every bucket lists the tasks booked in it. A bucket with no load gets an empty list. |

Task ids appear in input order.

`ProfileTasks` is a plain enum with no parse or spelling helpers. The `Plen.Wire` package handles the JSON spellings `"none"`, `"overallocated"` (for `Over`) and `"all"`.

## Example

```csharp
using Plen;

var from = Moment.FromYmdHm(2026, 8, 10, 0, 0) ?? throw new InvalidOperationException("invalid date");
var to = Moment.FromYmdHm(2026, 8, 14, 0, 0) ?? throw new InvalidOperationException("invalid date");

// List the contending tasks only in overloaded buckets.
var query = new ProfileQuery(from, to) { Tasks = ProfileTasks.Over };
```

## Related

- [`ProfileQuery`](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/profile-query.md>) - the query that carries it
- [`LoadProfile`](<https://docs.dhtmlx.com/planning-engine/net/api/core/resources/load-profile.md#loadbucket>) - the buckets that hold the task lists
- [Resource load](<https://docs.dhtmlx.com/planning-engine/net/resources-and-assignment/resource-load.md#task-lists-per-bucket>) - task lists per bucket