# MessagingOptions Properties

[Type overview](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/)

## CancelRequestOnTimeout {#cancelrequestontimeout-7ff42a35}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/cancelrequestontimeout-7ff42a35/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public bool CancelRequestOnTimeout
```

Whether request cancellation should be attempted when a request times out.

## CancelUnknownRequestOnStatusUpdate {#cancelunknownrequestonstatusupdate-41a017b7}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/cancelunknownrequestonstatusupdate-41a017b7/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public bool CancelUnknownRequestOnStatusUpdate
```

Whether request cancellation should be attempted when a status update is received for an unknown request.

## DropExpiredMessages {#dropexpiredmessages-01539356}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/dropexpiredmessages-01539356/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public bool DropExpiredMessages
```

Gets or sets a value indicating whether messages should be dropped once they expire, that is if it was not delivered to the destination before it has timed out on the sender.

### Value

Messages are dropped once they expire, by default.

## MaxMessageBodySize {#maxmessagebodysize-dc86a729}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/maxmessagebodysize-dc86a729/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public int MaxMessageBodySize
```

The maximum size, in bytes, of the body for a message. The runtime will forcibly close the connection if the body size is greater than this value.

### Value

The maximum message body size is 100 MB by default.

## MaxMessageHeaderSize {#maxmessageheadersize-ddfbdad8}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/maxmessageheadersize-ddfbdad8/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public int MaxMessageHeaderSize
```

The maximum size, in bytes, of the header for a message. The runtime will forcibly close the connection if the header size is greater than this value.

### Value

The maximum message header size is 10 MB by default.

## ResponseTimeout {#responsetimeout-b00326f9}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/responsetimeout-b00326f9/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public TimeSpan ResponseTimeout
```

Gets or sets the default timeout before a request is assumed to have failed.

### Value

Requests will timeout after 30 seconds by default.

## ResponseTimeoutWithDebugger {#responsetimeoutwithdebugger-ccefd8a6}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/responsetimeoutwithdebugger-ccefd8a6/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public TimeSpan ResponseTimeoutWithDebugger
```

Gets or sets the effective [MessagingOptions](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/) value to use when a debugger is attached.

### Value

Requests will timeout after 30 minutes when a debugger is attached, by default.

## WaitForCancellationAcknowledgement {#waitforcancellationacknowledgement-1ad18559}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.core/orleans.configuration.messagingoptions/properties/waitforcancellationacknowledgement-1ad18559/)

[Source](https://github.com/dotnet/orleans/blob/e4e752cedecc2976811db49802c7a999b1f1c704/src/Orleans.Core/Configuration/Options/MessagingOptions.cs)

```csharp
public bool WaitForCancellationAcknowledgement
```

Whether local calls should be cancelled immediately when cancellation is signaled (`false`) rather than waiting for callees to acknowledge cancellation before a call is considered cancelled (`true`).