https://docs.dapr.io/developing-applications/sdks/dotnet/dotnet-binarystore/Recent content in Dapr Binary Store .NET SDK on Dapr DocsHugoenhttps://docs.dapr.io/developing-applications/sdks/dotnet/dotnet-binarystore/dotnet-binarystore-howto/Mon, 01 Jan 0001 00:00:00 +0000https://docs.dapr.io/developing-applications/sdks/dotnet/dotnet-binarystore/dotnet-binarystore-howto/<p>Use the <code>Dapr.BinaryStore</code> package to store and retrieve files using a Dapr binary store component. The client streams file content in chunks, so you can work with large files without loading the entire file into memory. In this guide, you will:</p> <ul> <li>Register and configure <code>DaprBinaryStoreClient</code></li> <li>Upload and download files using streams</li> <li>Choose between streaming and in-memory operations</li> <li>Bind a typed client to a store with the source generator</li> </ul> <h2 id="prerequisites">Prerequisites</h2> <ul> <li><a href="https://docs.dapr.io/getting-started/install-dapr-cli/">Dapr CLI</a></li> <li>An initialized <a href="https://docs.dapr.io/getting-started/install-dapr-selfhost/">Dapr environment</a></li> <li><a href="https://dotnet.microsoft.com/download/dotnet/8.0">.NET 8</a>, <a href="https://dotnet.microsoft.com/download/dotnet/9.0">.NET 9</a>, <a href="https://dotnet.microsoft.com/download/dotnet/10.0">.NET 10</a>, or <a href="https://dotnet.microsoft.com/download/dotnet/11.0">.NET 11</a></li> <li>Dapr runtime 1.19 or later</li> <li>The <a href="https://www.nuget.org/packages/Dapr.BinaryStore">Dapr.BinaryStore</a> NuGet package</li> <li>A <a href="https://docs.dapr.io/developing-applications/building-blocks/binarystore/">binary store</a> component configured in Dapr</li> </ul> <div class="alert alert-warning" role="alert"> <h4 class="alert-heading">.NET framework support</h4> Be advised that .NET 8 and .NET 9 reach end of support in November 2026. Support for both will be dropped in Dapr v1.20; only .NET 10 and .NET 11 will be supported through the end of 2027. </div> <p>Install the package in your project:</p>https://docs.dapr.io/developing-applications/sdks/dotnet/dotnet-binarystore/dotnet-binarystore-client-usage/Mon, 01 Jan 0001 00:00:00 +0000https://docs.dapr.io/developing-applications/sdks/dotnet/dotnet-binarystore/dotnet-binarystore-client-usage/<p>The operations on this page target SDK <code>1.19.0</code>. Use that release or later with Dapr runtime 1.19 or later.</p> <h2 id="operation-surface">Operation surface</h2> <table> <thead> <tr> <th>Operation</th> <th>API</th> </tr> </thead> <tbody> <tr> <td>Upload</td> <td><code>SetBinaryFileAsync</code> with a <code>Stream</code> or <code>ReadOnlyMemory&lt;byte&gt;</code>, optionally overwriting an existing file.</td> </tr> <tr> <td>Download</td> <td><code>GetBinaryFileChunksAsync</code>, <code>GetBinaryFileAsync</code> into a destination stream, or <code>GetBinaryFileBytesAsync</code> to buffer the complete file.</td> </tr> <tr> <td>Delete</td> <td><code>DeleteBinaryFileAsync</code>.</td> </tr> <tr> <td>Store-bound access</td> <td><code>[BinaryStore]</code> on a partial <code>IDaprBinaryStoreClient</code> interface and the generated <code>With...</code> DI registration.</td> </tr> </tbody> </table> <p>This SDK release does not expose list-files, file metadata, conditional/ETag writes, or range-read methods. Binary store files are not state entries; state transactions and state query APIs do not apply to them.</p>