---
title: "Batched Invocation Interceptors"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors
language: csharp
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Batched Invocation Interceptors

Programming language: C#. Other languages: [C++](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/cpp.md), [Java](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/java.md), [Python](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/python.md).

A batch invocation interceptor lets you flush batched requests with your own policy, and handle a failed flush.

You install an interceptor by setting the `batchRequestInterceptor` field of the [InitializationData](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.InitializationData.html) object you use to create your communicator. The communicator invokes the interceptor for each batch request, passing the following arguments:

- `req`: an object representing the batch request being queued
- `count`: the number of requests already in the queue
- `size`: the number of bytes of the queued batch message, including its header

The request represented by `req` is not included in `count` and `size`, and is queued only when the interceptor calls `enqueue` on it.

The following interceptor flushes the queued requests when adding the new request would make the batch message larger than 64 KiB:

```csharp
const int maxBatchSize = 64 * 1024; // in bytes
initData.batchRequestInterceptor = (req, count, size) =>
{
    if (size + req.getSize() > maxBatchSize)
    {
        _ = FlushAsync(req.getProxy());
    }
    req.enqueue();
};

static async Task FlushAsync(Ice.ObjectPrx proxy)
{
    try
    {
        await proxy.ice_flushBatchRequestsAsync();
    }
    catch (Ice.LocalException exception)
    {
        Console.Error.WriteLine($"Failed to flush batch requests: {exception}");
    }
}
```

Installing an interceptor does not turn off [automatic flushing](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocations/csharp.md#automatic-flushing).
