# JobScheduleStoreContract > Tracon documentation. Tracon is a .NET package family that adds a control > plane on Microsoft Agent Framework, published as NuGet packages that run > inside your own ASP.NET Core application. > > Page: https://tracon.dev/api/tracon.testing.contracts.storage.jobschedulestorecontract/ > Summary: JobScheduleStoreContract: Behavior tests for the IJobScheduleStore contract.
Namespace Tracon.Testing.Contracts.Storage ยท Assembly Tracon.Testing.Contracts.Xunit.dll
Behavior tests for the [IJobScheduleStore](/api/tracon.ijobschedulestore/) contract. ```csharp public abstract class JobScheduleStoreContract : TenantIsolationContract, IAsyncLifetime, IAsyncDisposable ```
Inheritance
object โ† StoreCancellationContract<IJobScheduleStore> โ† TenantIsolationContract<IJobScheduleStore> โ† JobScheduleStoreContract
Implements
IAsyncLifetime, IAsyncDisposable
Inherited Members
TenantIsolationContract<IJobScheduleStore>.TenantA, TenantIsolationContract<IJobScheduleStore>.TenantB, TenantIsolationContract<IJobScheduleStore>.UseAmbientTenant(MutableTenantContext), TenantIsolationContract<IJobScheduleStore>.SeedAsync(string, string, CancellationToken), TenantIsolationContract<IJobScheduleStore>.ExistsAsync(string, object), TenantIsolationContract<IJobScheduleStore>.CountAsync(string, CancellationToken), TenantIsolationContract<IJobScheduleStore>.TryDeleteAsync(string, object), TenantIsolationContract<IJobScheduleStore>.TryOverwriteAsync(string, string), TenantIsolationContract<IJobScheduleStore>.CancellableReadAsync(CancellationToken), TenantIsolationContract<IJobScheduleStore>.CancellableWriteAsync(CancellationToken), TenantIsolationContract<IJobScheduleStore>.WroteAnythingAsync(), TenantIsolationContract<IJobScheduleStore>.Tenant_cannot_read_another_tenants_record(), TenantIsolationContract<IJobScheduleStore>.Tenant_reads_its_own_record(), TenantIsolationContract<IJobScheduleStore>.Tenant_does_not_see_another_tenants_record_in_the_list(), TenantIsolationContract<IJobScheduleStore>.Tenant_cannot_delete_another_tenants_record(), TenantIsolationContract<IJobScheduleStore>.Same_name_lives_independently_across_two_tenants(), TenantIsolationContract<IJobScheduleStore>.AmbientTenant, StoreCancellationContract<IJobScheduleStore>.CreateStoreAsync(), StoreCancellationContract<IJobScheduleStore>.InitializeAsync(), StoreCancellationContract<IJobScheduleStore>.DisposeAsync(), StoreCancellationContract<IJobScheduleStore>.OnDisposeAsync(), StoreCancellationContract<IJobScheduleStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<IJobScheduleStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<IJobScheduleStore>.WroteAnythingAsync(), StoreCancellationContract<IJobScheduleStore>.Canceled_token_throws_on_read(), StoreCancellationContract<IJobScheduleStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<IJobScheduleStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<IJobScheduleStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
## Constructors ### JobScheduleStoreContract\(\) ```csharp protected JobScheduleStoreContract() ``` ## Methods ### CountAsync\(string, CancellationToken\) Reports how many records the given tenant sees through the listing endpoint. ```csharp protected override ValueTask CountAsync(string tenantId, CancellationToken cancellationToken) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The reading tenant. `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token every store call inside the hook must be handed; see [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\> The number of records seen. ### DeleteAsync\_removes\_an\_existing\_schedule\(\) ```csharp [Fact] public Task DeleteAsync_removes_an_existing_schedule() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### ExistsAsync\(string, object\) Reports whether the record is visible from the given tenant's viewpoint. ```csharp protected override ValueTask ExistsAsync(string tenantId, object key) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The reading tenant. `key` [object](https://learn.microsoft.com/dotnet/api/system.object) The key returned by [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\> [true](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the record is visible. ### GetAsync\_returns\_null\_for\_another\_tenant\(\) ```csharp [Fact] public Task GetAsync_returns_null_for_another_tenant() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### ListAsync\_returns\_only\_that\_tenant\(\) ```csharp [Fact] public Task ListAsync_returns_only_that_tenant() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### ListDueAsync\_returns\_only\_enabled\_and\_due\_schedules\(\) ```csharp [Fact] public Task ListDueAsync_returns_only_enabled_and_due_schedules() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### SaveAsync\_assigns\_an\_id\_to\_a\_new\_schedule\(\) ```csharp [Fact] public Task SaveAsync_assigns_an_id_to_a_new_schedule() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### SaveAsync\_keeps\_the\_id\_and\_updates\_for\_the\_same\_name\(\) ```csharp [Fact] public Task SaveAsync_keeps_the_id_and_updates_for_the_same_name() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### SaveAsync\_round\_trips\_a\_schedule\_that\_carries\_no\_payload\(\) A schedule saved with no payload round-trips through every provider. ```csharp [Fact] public Task SaveAsync_round_trips_a_schedule_that_carries_no_payload() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) #### Remarks An unset payload used to be written as the literal `null`, which SQL Server's `CHECK (ISJSON(payload) = 1)` rejects, while Postgres and SQLite accepted it - a provider divergence no in-memory test could see. The empty array satisfies all three, and the read-back has to agree with what was written. ### SeedAsync\(string, string, CancellationToken\) Writes a sample record for the given tenant. ```csharp protected override ValueTask SeedAsync(string tenantId, string name, CancellationToken cancellationToken) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The tenant that owns the record. `name` [string](https://learn.microsoft.com/dotnet/api/system.string) The name distinguishing the record. The same name may be used by two tenants. `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token every store call inside the hook must be handed. The cancellation contract calls this hook with a token that is already cancelled, so a hook that drops the token reports a store as sound when it is not. #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[object](https://learn.microsoft.com/dotnet/api/system.object)\> The key to use for reading the record back. ### TryClaimNextRunAsync\_a\_second\_claim\_prevents\_the\_conflict\(\) ```csharp [Fact] public Task TryClaimNextRunAsync_a_second_claim_prevents_the_conflict() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### TryClaimNextRunAsync\_fails\_when\_the\_expected\_value\_does\_not\_match\(\) ```csharp [Fact] public Task TryClaimNextRunAsync_fails_when_the_expected_value_does_not_match() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### TryDeleteAsync\(string, object\) Attempts to delete the record on behalf of the given tenant. ```csharp protected override ValueTask TryDeleteAsync(string tenantId, object key) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The tenant attempting the delete. `key` [object](https://learn.microsoft.com/dotnet/api/system.object) The key returned by [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)?\> [true](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the delete succeeded, [false](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the record was not found; [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) if the store does not offer deletion.