# TenantProviderBindingStoreContract > 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.tenantproviderbindingstorecontract/ > Summary: TenantProviderBindingStoreContract: Behavior tests for the ITenantProviderBindingStore contract.

Namespace Tracon.Testing.Contracts.Storage · Assembly Tracon.Testing.Contracts.Xunit.dll

Behavior tests for the [ITenantProviderBindingStore](/api/tracon.itenantproviderbindingstore/) contract. ```csharp public abstract class TenantProviderBindingStoreContract : TenantIsolationContract, IAsyncLifetime, IAsyncDisposable ```

Inheritance: object ← StoreCancellationContract<ITenantProviderBindingStore> ← TenantIsolationContract<ITenantProviderBindingStore> ← TenantProviderBindingStoreContract
Implements: IAsyncLifetime, IAsyncDisposable
Inherited Members: TenantIsolationContract<ITenantProviderBindingStore>.TenantA, TenantIsolationContract<ITenantProviderBindingStore>.TenantB, TenantIsolationContract<ITenantProviderBindingStore>.UseAmbientTenant(MutableTenantContext), TenantIsolationContract<ITenantProviderBindingStore>.SeedAsync(string, string, CancellationToken), TenantIsolationContract<ITenantProviderBindingStore>.ExistsAsync(string, object), TenantIsolationContract<ITenantProviderBindingStore>.CountAsync(string, CancellationToken), TenantIsolationContract<ITenantProviderBindingStore>.TryDeleteAsync(string, object), TenantIsolationContract<ITenantProviderBindingStore>.TryOverwriteAsync(string, string), TenantIsolationContract<ITenantProviderBindingStore>.CancellableReadAsync(CancellationToken), TenantIsolationContract<ITenantProviderBindingStore>.CancellableWriteAsync(CancellationToken), TenantIsolationContract<ITenantProviderBindingStore>.WroteAnythingAsync(), TenantIsolationContract<ITenantProviderBindingStore>.Tenant_cannot_read_another_tenants_record(), TenantIsolationContract<ITenantProviderBindingStore>.Tenant_reads_its_own_record(), TenantIsolationContract<ITenantProviderBindingStore>.Tenant_does_not_see_another_tenants_record_in_the_list(), TenantIsolationContract<ITenantProviderBindingStore>.Tenant_cannot_delete_another_tenants_record(), TenantIsolationContract<ITenantProviderBindingStore>.Same_name_lives_independently_across_two_tenants(), TenantIsolationContract<ITenantProviderBindingStore>.AmbientTenant, StoreCancellationContract<ITenantProviderBindingStore>.CreateStoreAsync(), StoreCancellationContract<ITenantProviderBindingStore>.InitializeAsync(), StoreCancellationContract<ITenantProviderBindingStore>.DisposeAsync(), StoreCancellationContract<ITenantProviderBindingStore>.OnDisposeAsync(), StoreCancellationContract<ITenantProviderBindingStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<ITenantProviderBindingStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<ITenantProviderBindingStore>.WroteAnythingAsync(), StoreCancellationContract<ITenantProviderBindingStore>.Canceled_token_throws_on_read(), StoreCancellationContract<ITenantProviderBindingStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<ITenantProviderBindingStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<ITenantProviderBindingStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

## Remarks This contract never asserts a secret value: the store carries only the configuration key's NAME. It exists to prove tenant isolation and round-tripping of that name plus the optional endpoint. ## Constructors ### TenantProviderBindingStoreContract\(\) ```csharp protected TenantProviderBindingStoreContract() ``` ## Methods ### A\_binding\_is\_deleted\_whatever\_case\_the\_caller\_uses\(\) ```csharp [Fact] public Task A_binding_is_deleted_whatever_case_the_caller_uses() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### A\_binding\_saved\_under\_a\_different\_case\_replaces\_the\_existing\_one\(\) ```csharp [Fact] public Task A_binding_saved_under_a_different_case_replaces_the_existing_one() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### A\_provider\_name\_is\_matched\_case\_insensitively\(string, string\) ```csharp [Theory] [InlineData(new object?[] { "OpenAI", "openai" })] [InlineData(new object?[] { "openai", "OpenAI" })] [InlineData(new object?[] { "OPENAI", "openai" })] public Task A_provider_name_is_matched_case_insensitively(string savedAs, string requestedAs) ``` #### Parameters `savedAs` [string](https://learn.microsoft.com/dotnet/api/system.string) `requestedAs` [string](https://learn.microsoft.com/dotnet/api/system.string) #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### A\_tenant\_is\_matched\_case\_insensitively\(string, string\) ```csharp [Theory] [InlineData(new object?[] { "acme", "Acme" })] [InlineData(new object?[] { "Acme", "acme" })] [InlineData(new object?[] { "ACME", "acme" })] public Task A_tenant_is_matched_case_insensitively(string savedAs, string requestedAs) ``` #### Parameters `savedAs` [string](https://learn.microsoft.com/dotnet/api/system.string) `requestedAs` [string](https://learn.microsoft.com/dotnet/api/system.string) #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### 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. ### Endpoint\_is\_optional\(\) ```csharp [Fact] public Task Endpoint_is_optional() ``` #### 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. ### Listing\_returns\_every\_provider\_binding\_of\_the\_tenant\(\) ```csharp [Fact] public Task Listing_returns_every_provider_binding_of_the_tenant() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Missing\_binding\_returns\_null\(\) ```csharp [Fact] public Task Missing_binding_returns_null() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Saved\_binding\_is\_read\_back\(\) ```csharp [Fact] public Task Saved_binding_is_read_back() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### SeedAsync\(string, string, CancellationToken\) Writes a sample record for the given tenant. ```csharp protected override ValueTask