Soenneker.Blob.Delete
11.0.3197
Prefix Reserved
dotnet add package Soenneker.Blob.Delete --version 11.0.3197
NuGet\Install-Package Soenneker.Blob.Delete -Version 11.0.3197
<PackageReference Include="Soenneker.Blob.Delete" Version="11.0.3197" />
<PackageVersion Include="Soenneker.Blob.Delete" Version="11.0.3197" />
<PackageReference Include="Soenneker.Blob.Delete" />
paket add Soenneker.Blob.Delete --version 11.0.3197
#r "nuget: Soenneker.Blob.Delete, 11.0.3197"
#:package Soenneker.Blob.Delete@11.0.3197
#addin nuget:?package=Soenneker.Blob.Delete&version=11.0.3197
#tool nuget:?package=Soenneker.Blob.Delete&version=11.0.3197
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.2283)
- Soenneker.Blob.Fetch (>= 11.0.2461)
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.3197 | 45 | 11/21/2026 |
| 11.0.3196 | 53 | 11/21/2026 |
| 11.0.3195 | 129 | 11/19/2026 |
| 11.0.3194 | 74 | 11/19/2026 |
| 11.0.3192 | 91 | 11/18/2026 |
| 11.0.3191 | 66 | 11/18/2026 |
| 11.0.3190 | 93 | 11/18/2026 |
| 11.0.3187 | 87 | 11/18/2026 |
| 11.0.3186 | 78 | 11/18/2026 |
| 11.0.3185 | 250 | 11/16/2026 |
| 11.0.3184 | 94 | 11/16/2026 |
| 11.0.3183 | 127 | 11/15/2026 |
| 11.0.3182 | 130 | 11/11/2026 |
| 11.0.3181 | 101 | 11/11/2026 |
| 11.0.3179 | 115 | 11/11/2026 |
| 11.0.3178 | 98 | 11/11/2026 |
| 11.0.3175 | 133 | 11/11/2026 |
| 11.0.3174 | 101 | 11/11/2026 |
| 11.0.3173 | 91 | 11/11/2026 |
| 11.0.3172 | 176 | 11/3/2026 |
Update dependency Soenneker.Blob.Client to 11.0.2283 (#4010)