# AttachmentStoreContract > 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.attachmentstorecontract/ > Summary: AttachmentStoreContract: Behavior tests for the IAttachmentStore contract.
Namespace Tracon.Testing.Contracts.Storage ยท Assembly Tracon.Testing.Contracts.Xunit.dll
Behavior tests for the [IAttachmentStore](/api/tracon.iattachmentstore/) contract. ```csharp public abstract class AttachmentStoreContract : TenantIsolationContract, IAsyncLifetime, IAsyncDisposable ```
Inheritance
object โ† StoreCancellationContract<IAttachmentStore> โ† TenantIsolationContract<IAttachmentStore> โ† AttachmentStoreContract
Implements
IAsyncLifetime, IAsyncDisposable
Inherited Members
TenantIsolationContract<IAttachmentStore>.TenantA, TenantIsolationContract<IAttachmentStore>.TenantB, TenantIsolationContract<IAttachmentStore>.UseAmbientTenant(MutableTenantContext), TenantIsolationContract<IAttachmentStore>.SeedAsync(string, string, CancellationToken), TenantIsolationContract<IAttachmentStore>.ExistsAsync(string, object), TenantIsolationContract<IAttachmentStore>.CountAsync(string, CancellationToken), TenantIsolationContract<IAttachmentStore>.TryDeleteAsync(string, object), TenantIsolationContract<IAttachmentStore>.TryOverwriteAsync(string, string), TenantIsolationContract<IAttachmentStore>.CancellableReadAsync(CancellationToken), TenantIsolationContract<IAttachmentStore>.CancellableWriteAsync(CancellationToken), TenantIsolationContract<IAttachmentStore>.WroteAnythingAsync(), TenantIsolationContract<IAttachmentStore>.Tenant_cannot_read_another_tenants_record(), TenantIsolationContract<IAttachmentStore>.Tenant_reads_its_own_record(), TenantIsolationContract<IAttachmentStore>.Tenant_does_not_see_another_tenants_record_in_the_list(), TenantIsolationContract<IAttachmentStore>.Tenant_cannot_delete_another_tenants_record(), TenantIsolationContract<IAttachmentStore>.Same_name_lives_independently_across_two_tenants(), TenantIsolationContract<IAttachmentStore>.AmbientTenant, StoreCancellationContract<IAttachmentStore>.CreateStoreAsync(), StoreCancellationContract<IAttachmentStore>.InitializeAsync(), StoreCancellationContract<IAttachmentStore>.DisposeAsync(), StoreCancellationContract<IAttachmentStore>.OnDisposeAsync(), StoreCancellationContract<IAttachmentStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<IAttachmentStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<IAttachmentStore>.WroteAnythingAsync(), StoreCancellationContract<IAttachmentStore>.Canceled_token_throws_on_read(), StoreCancellationContract<IAttachmentStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<IAttachmentStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<IAttachmentStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
## Remarks Every implementation must pass the same scenarios; in particular, tenant isolation and attachments being removed when a session is deleted must behave identically. ## Constructors ### AttachmentStoreContract\(\) ```csharp protected AttachmentStoreContract() ``` ## Methods ### Another\_tenants\_attachment\_is\_not\_visible\(\) ```csharp [Fact] public Task Another_tenants_attachment_is_not_visible() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Bulk\_delete\_by\_session\_removes\_only\_matches\(\) ```csharp [Fact] public Task Bulk_delete_by_session_removes_only_matches() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Content\_is\_read\_back\_as\_is\(\) ```csharp [Fact] public Task Content_is_read_back_as_is() ``` #### 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. ### Delete\_succeeds\_once\_and\_returns\_false\_the\_second\_time\(\) ```csharp [Fact] public Task Delete_succeeds_once_and_returns_false_the_second_time() ``` #### 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\_filters\_by\_session\(\) ```csharp [Fact] public Task Listing_filters_by_session() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Record\_metadata\_is\_stored\_correctly\(\) ```csharp [Fact] public Task Record_metadata_is_stored_correctly() ``` #### 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 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. ### Session\_based\_delete\_does\_not\_delete\_the\_others\_attachments\(\) ```csharp [Fact] public Task Session_based_delete_does_not_delete_the_others_attachments() ``` #### 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.