Soenneker.Blob.Delete
11.0.3195
Prefix Reserved
dotnet add package Soenneker.Blob.Delete --version 11.0.3195
NuGet\Install-Package Soenneker.Blob.Delete -Version 11.0.3195
<PackageReference Include="Soenneker.Blob.Delete" Version="11.0.3195" />
<PackageVersion Include="Soenneker.Blob.Delete" Version="11.0.3195" />
<PackageReference Include="Soenneker.Blob.Delete" />
paket add Soenneker.Blob.Delete --version 11.0.3195
#r "nuget: Soenneker.Blob.Delete, 11.0.3195"
#:package Soenneker.Blob.Delete@11.0.3195
#addin nuget:?package=Soenneker.Blob.Delete&version=11.0.3195
#tool nuget:?package=Soenneker.Blob.Delete&version=11.0.3195
Soenneker.Blob.Delete
Deletes individual Azure blobs, entire containers, or every blob under a virtual-directory prefix.
Install
dotnet add package Soenneker.Blob.Delete
Register the utility in Program.cs:
using Soenneker.Blob.Delete.Registrars;
builder.Services.AddBlobDeleteUtilAsSingleton();
Scoped registration is also available.
The underlying Blob packages require Azure:Storage:Blob:ConnectionString in configuration. Store that value in a secret provider.
Delete one blob
Response<bool> response = await blobDelete.Delete(
"invoices",
"2026/obsolete.pdf",
cancellationToken);
bool deleted = response.Value;
false means the blob did not exist. Azure authorization, lease, snapshot, and service failures throw RequestFailedException. The default Azure delete behavior does not include snapshots, so a blob with snapshots may require explicit snapshot cleanup before this method can delete it.
Delete a virtual directory
Azure Blob Storage has blob-name prefixes rather than physical directories. This method lists the supplied prefix and deletes each returned blob sequentially:
bool allDeleted = await blobDelete.DeleteDirectory(
"exports",
"temporary/2026/",
cancellationToken);
The result is true when every listed blob was deleted or no blobs matched. It is false if a listed blob disappeared before its delete completed. Azure request failures are not converted to false; they stop the operation and propagate.
Prefix matching can include more blobs than intended when the trailing delimiter is omitted. Use temporary/2026/, not temporary/2026, when only that virtual directory should be removed.
Delete a container
bool deleted = await blobDelete.DeleteContainer(
"temporary-exports",
cancellationToken);
Container deletion removes all blobs, versions, and snapshots in that container. Treat the container name as trusted application configuration, not direct user input.
Important behavior
The shared client/container utilities normalize container names to lowercase.
Those utilities ensure the target container exists while resolving clients. As a result, deleting a missing blob or container can briefly create the missing container before deletion. Avoid using these methods as existence probes.
Directory deletion is not transactional. Cancellation or a failure can leave a partially deleted prefix.
Soft delete, versioning, immutability policies, legal holds, and leases can change whether data is recoverable or whether deletion is allowed.
Cancellation stops pending work; it does not undo work that has already completed.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- Soenneker.Blob.Client (>= 11.0.2282)
- Soenneker.Blob.Fetch (>= 11.0.2460)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Soenneker.Blob.Delete:
| Package | Downloads |
|---|---|
|
Soenneker.Blob.Suite
A concoction of Azure Blob Storage utilities and libraries |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.0.3195 | 103 | 11/19/2026 |
| 11.0.3194 | 73 | 11/19/2026 |
| 11.0.3192 | 86 | 11/18/2026 |
| 11.0.3191 | 65 | 11/18/2026 |
| 11.0.3190 | 89 | 11/18/2026 |
| 11.0.3187 | 82 | 11/18/2026 |
| 11.0.3186 | 76 | 11/18/2026 |
| 11.0.3185 | 244 | 11/16/2026 |
| 11.0.3184 | 92 | 11/16/2026 |
| 11.0.3183 | 123 | 11/15/2026 |
| 11.0.3182 | 128 | 11/11/2026 |
| 11.0.3181 | 99 | 11/11/2026 |
| 11.0.3179 | 115 | 11/11/2026 |
| 11.0.3178 | 97 | 11/11/2026 |
| 11.0.3175 | 133 | 11/11/2026 |
| 11.0.3174 | 100 | 11/11/2026 |
| 11.0.3173 | 90 | 11/11/2026 |
| 11.0.3172 | 176 | 11/3/2026 |
| 11.0.3171 | 101 | 11/3/2026 |
| 11.0.3170 | 97 | 11/3/2026 |
Updated Soenneker.Blob.Client to 11.0.2282