# Envelope

Package: [Microsoft.Orleans.Durable](/orleans/docs/api/csharp/microsoft.orleans.durable/) 10.0.0-alpha.1

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Envelope.cs#L15)

```csharp
[Orleans.GenerateSerializer]
[Orleans.Alias(Orleans.Durable.Messaging.Envelope)]
public readonly struct Envelope
```

Contains a command identity, payload, subject, optional application headers, and an optional delivery time.

## Remarks

Message identity and payload are required; an empty payload is valid. Raw protocols can omit subject and headers. Prepare the payload and headers before publishing a message and keep them unchanged afterward. Struct assignment shares these objects; ordinary Orleans deep copying and deserialization produce independent payload arrays, header dictionaries, and header value arrays.

## Properties

- [DeliverAt](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.envelope/properties/deliverat-94557507/)
- [Headers](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.envelope/properties/headers-7555ec74/)
- [MessageId](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.envelope/properties/messageid-7b139572/)
- [Payload](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.envelope/properties/payload-abb78966/)
- [Subject](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.envelope/properties/subject-3aaed8f8/)
