### Encode and Decode CloudEvent with Protobuf Formatter

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.Protobuf/PACKAGE.md

Demonstrates how to create a CloudEvent, encode it into a Protobuf structured message, and then decode it back. Ensure you have the necessary CloudNative.CloudEvents and CloudNative.CloudEvents.Protobuf packages installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Protobuf;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created",
    Data = "Order created"
};

var formatter = new ProtobufEventFormatter();
var body = formatter.EncodeStructuredModeMessage(cloudEvent, out var contentType);
var decoded = formatter.DecodeStructuredModeMessage(body, contentType, extensionAttributes: null);
```

--------------------------------

### Create and Serialize a CloudEvent to HTTP Content

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents/PACKAGE.md

Demonstrates creating a CloudEvent object and serializing it into HTTP content using a JSON formatter. Ensure you have the necessary formatter package (e.g., CloudNative.CloudEvents.SystemTextJson) installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Http;
using CloudNative.CloudEvents.SystemTextJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created",
    DataContentType = "application/json",
    Data = new { OrderId = 1234 }
};

var formatter = new JsonEventFormatter();
var content = cloudEvent.ToHttpContent(ContentMode.Structured, formatter);
```

--------------------------------

### Create MQTT Message from CloudEvent

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.Mqtt/PACKAGE.md

Use this to convert a CloudEvent into an MQTT application message. Ensure you have the necessary CloudEvents and formatter packages installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Mqtt;
using CloudNative.CloudEvents.SystemTextJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created"
};

var formatter = new JsonEventFormatter();
var message = cloudEvent.ToMqttApplicationMessage(ContentMode.Structured, formatter, "orders/created");
```

--------------------------------

### Encode and Decode CloudEvents with Avro Formatter

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.Avro/PACKAGE.md

Demonstrates how to create an Avro event formatter, encode a CloudEvent into Avro format, and then decode it back. Ensure you have the necessary CloudNative.CloudEvents and CloudNative.CloudEvents.Avro packages installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Avro;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created",
    Data = new byte[] { 1, 2, 3, 4 }
};

var formatter = new AvroEventFormatter();
var body = formatter.EncodeStructuredModeMessage(cloudEvent, out var contentType);
var decoded = formatter.DecodeStructuredModeMessage(body, contentType, extensionAttributes: null);
```

--------------------------------

### Create AMQP Message from CloudEvent

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.Amqp/PACKAGE.md

Use this snippet to convert a CloudEvent object into an AMQP message using a specified formatter and content mode. Ensure you have the necessary CloudNative.CloudEvents and CloudNative.CloudEvents.Amqp packages installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Amqp;
using CloudNative.CloudEvents.SystemTextJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created"
};

var formatter = new JsonEventFormatter();
var message = cloudEvent.ToAmqpMessage(ContentMode.Structured, formatter);
```

--------------------------------

### Create Kafka Message from CloudEvent

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.Kafka/PACKAGE.md

Use this snippet to convert a CloudEvent object into a Kafka message using a specified formatter and content mode. Ensure you have the necessary CloudEvents and formatter packages installed.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.Kafka;
using CloudNative.CloudEvents.SystemTextJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created"
};

var formatter = new JsonEventFormatter();
var message = cloudEvent.ToKafkaMessage(ContentMode.Structured, formatter);
```

--------------------------------

### Encode and Decode CloudEvent with System.Text.Json

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.SystemTextJson/PACKAGE.md

Demonstrates how to create a CloudEvent, encode it into a structured JSON message using JsonEventFormatter, and then decode it back. Ensure CloudNative.CloudEvents and CloudNative.CloudEvents.SystemTextJson are referenced.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.SystemTextJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created",
    DataContentType = "application/json",
    Data = new { OrderId = 1234 }
};

var formatter = new JsonEventFormatter();
var body = formatter.EncodeStructuredModeMessage(cloudEvent, out var contentType);
var decoded = formatter.DecodeStructuredModeMessage(body, contentType, extensionAttributes: null);
```

--------------------------------

### Batch Conversions

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Methods for handling batch conversions of CloudEvents to and from protocol messages.

```APIDOC
## IsCloudEventBatch

### Description
Checks if a protocol message represents a CloudEvent batch.

### Method
`public static bool IsCloudEventBatch(this ProtocolMessage message);
`

### Parameters
- **message** (ProtocolMessage) - The protocol message to check.

### Response
- **bool** - True if the message is a CloudEvent batch, false otherwise.

## ToCloudEventBatch (ProtocolMessage overload)

### Description
Converts a protocol message into a list of CloudEvents.

### Method
`public static IReadOnlyList<CloudEvent> ToCloudEventBatch(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    params CloudEventAtribute[] extensionAttributes);
`

### Parameters
- **message** (ProtocolMessage) - The protocol message to convert.
- **formatter** (CloudEventFormatter) - The formatter to use for deserialization.
- **extensionAttributes** (params CloudEventAtribute[]) - Optional extension attributes.

### Response
- **IReadOnlyList<CloudEvent>** - A list of CloudEvents.

## ToCloudEventBatch (ProtocolMessage overload with IEnumerable)

### Description
Converts a protocol message into a list of CloudEvents using an IEnumerable of extension attributes.

### Method
`public static IReadOnlyList<CloudEvent> ToCloudEventBatch(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    IEnumerable<CloudEventAtribute> extensionAttributes);
`

### Parameters
- **message** (ProtocolMessage) - The protocol message to convert.
- **formatter** (CloudEventFormatter) - The formatter to use for deserialization.
- **extensionAttributes** (IEnumerable<CloudEventAtribute>) - Optional extension attributes.

### Response
- **IReadOnlyList<CloudEvent>** - A list of CloudEvents.

## ToProtocolMessage (Batch)

### Description
Converts a list of CloudEvents into a single protocol message representing a batch.

### Method
`public static ProtocolMessage ToProtocolMessage(
    this IReadOnlyList<CloudEvent> cloudEvents,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvents** (IReadOnlyList<CloudEvent>) - The list of CloudEvents to convert.
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.

### Response
- **ProtocolMessage** - The resulting protocol message representing the batch.

## CopyToProtocolMessage (Batch)

### Description
Populates an existing protocol message with a batch of CloudEvents.

### Method
`public static void CopyToProtocolMessage(
    this IReadOnlyList<CloudEvent> cloudEvents,
    ProtocolMessage destination,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvents** (IReadOnlyList<CloudEvent>) - The list of CloudEvents to convert.
- **destination** (ProtocolMessage) - The existing protocol message to populate.
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.
```

--------------------------------

### Use NewtonsoftJson CloudEvent Formatter

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.NewtonsoftJson/PACKAGE.md

Create a CloudEvent, encode it using the JsonEventFormatter, and then decode it. Ensure you have the necessary using statements for CloudNative.CloudEvents and CloudNative.CloudEvents.NewtonsoftJson.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.NewtonsoftJson;

var cloudEvent = new CloudEvent
{
    Id = Guid.NewGuid().ToString(),
    Source = new Uri("https://example.com/orders"),
    Type = "com.example.order.created",
    DataContentType = "application/json",
    Data = new { OrderId = 1234 }
};

var formatter = new JsonEventFormatter();
var body = formatter.EncodeStructuredModeMessage(cloudEvent, out var contentType);
var decoded = formatter.DecodeStructuredModeMessage(body, contentType, extensionAttributes: null);
```

--------------------------------

### Serialize GameResult to CloudEvent for HTTP

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Creates a CloudEvent with a GameResult object as data and prepares it for an HTTP POST request using JsonEventFormatter.

```csharp
var result = new GameResult
{
    PlayerId = "player1",
    GameId = "game1",
    Score = 200
};
var cloudEvent = new CloudEvent
{
    Id = "result-1",
    Type = "game.played.v1",
    Source = new Uri("/game", UriKind.Relative),
    Time = DateTimeOffset.UtcNow,
    DataContentType = "application/json",
    Data = result
};
var formatter = new JsonEventFormatter();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    Content = cloudEvent.ToHttpContent(ContentMode.Binary, formatter)
};
```

--------------------------------

### Populate HttpRequestMessage with CloudEvent

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Use this snippet to create a CloudEvent and serialize it into an HttpRequestMessage for sending with HttpClient. Requires the CloudNative.CloudEvents.Http using directive.

```csharp
CloudEvent cloudEvent = new CloudEvent
{
    Id = "event-id",
    Type = "event-type",
    Source = new Uri("https://cloudevents.io/"),
    Time = DateTimeOffset.UtcNow,
    DataContentType = "text/plain",
    Data = "This is CloudEvent data"
};

CloudEventFormatter formatter = new JsonEventFormatter();
HttpRequestMessage request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    Content = cloudEvent.ToHttpContent(ContentMode.Structured, formatter)
};
```

--------------------------------

### Convert Protocol Message to CloudEvent Batch (with attributes)

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Converts a protocol message into a read-only list of CloudEvents. Supports specifying extension attributes.

```csharp
public static IReadOnlyList<CloudEvent> ToCloudEventBatch(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    params CloudEventAtribute[] extensionAttributes);
```

```csharp
public static IReadOnlyList<CloudEvent> ToCloudEventBatch(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    IEnumerable<CloudEventAtribute> extensionAttributes);
```

--------------------------------

### Define GameResult Class

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Defines a sample C# class to represent game result data, intended for use with CloudEvents.

```csharp
public class GameResult
{
    [JsonProperty("playerId")]
    public string PlayerId { get; set; }
    
    [JsonProperty("gameId")]
    public string GameId { get; set; }
    
    [JsonProperty("score")]
    public int Score { get; set; }
}
```

--------------------------------

### Copy CloudEvent to Protocol Message

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Use this method to populate an existing protocol message instance with data from a CloudEvent. Requires specifying the content mode and a formatter.

```csharp
public static void CopyToProtocolMessage(
    this CloudEvent cloudEvent,
    ProtocolMessage destination,
    ContentMode contentMode,
    CloudEventFormatter formatter);
```

--------------------------------

### Copy CloudEvents to Protocol Message

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Populates an existing protocol message with a read-only list of CloudEvents. Requires a CloudEvent formatter.

```csharp
public static void CopyToProtocolMessage(
    this IReadOnlyList<CloudEvent> cloudEvents,
    ProtocolMessage destination,
    CloudEventFormatter formatter);
```

--------------------------------

### CloudEvent Conversion Extension Methods

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Provides extension methods for protocol messages to check if they represent a CloudEvent and to convert them into a CloudEvent object. Overloads are provided for convenience with extension attributes.

```csharp
public static bool IsCloudEvent(this ProtocolMessage message);

public static CloudEvent ToCloudEvent(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    params CloudEventAtribute[] extensionAttributes);

public static CloudEvent ToCloudEvent(
    this ProtocolMessage message,
    CloudEventFormatter formatter,
    IEnumerable<CloudEventAtribute> extensionAttributes);
```

--------------------------------

### Convert CloudEvent to Protocol Message

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Use this method to construct a new protocol message instance from a CloudEvent. Requires specifying the content mode and a formatter.

```csharp
public static ProtocolMessage ToProtocolMessage(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
```

--------------------------------

### Convert CloudEvent to AmqpMessage

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Converts a CloudEvent to an AmqpMessage instance. The method name is qualified to clarify the target message type when using a generic name like 'Message'.

```csharp
// Message is ambiguous, so clarify it in the method name.
public static Message ToAmqpMessage(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
```

--------------------------------

### Convert CloudEvent to HttpContent

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Converts a CloudEvent to an HttpContent instance. This is a specific implementation for HTTP protocols where HttpContent is unambiguous.

```csharp
// HttpContent is already unambiguous.
public static HttpContent ToHttpContent(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
```

--------------------------------

### Convert CloudEvents to Protocol Message

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Converts a read-only list of CloudEvents into a single protocol message. Requires a CloudEvent formatter.

```csharp
public static ProtocolMessage ToProtocolMessage(
    this IReadOnlyList<CloudEvent> cloudEvents,
    CloudEventFormatter formatter);
```

--------------------------------

### Handle CloudEvents in ASP.NET Core Endpoint

Source: https://github.com/cloudevents/sdk-csharp/blob/main/src/CloudNative.CloudEvents.AspNetCore/PACKAGE.md

Use this snippet within an ASP.NET Core endpoint to deserialize a CloudEvent from an incoming HTTP request and serialize a new CloudEvent to the outgoing HTTP response. Requires CloudNative.CloudEvents and a formatter like JsonEventFormatter.

```csharp
using CloudNative.CloudEvents;
using CloudNative.CloudEvents.AspNetCore;
using CloudNative.CloudEvents.SystemTextJson;
using Microsoft.AspNetCore.Http;

app.MapPost("/events", async (HttpRequest request, HttpResponse response) =>
{
    var formatter = new JsonEventFormatter();
    var cloudEvent = await request.ToCloudEventAsync(formatter);

    var result = new CloudEvent
    {
        Id = Guid.NewGuid().ToString(),
        Source = new Uri("https://example.com/processed"),
        Type = "com.example.event.processed",
        DataContentType = "application/json",
        Data = new { OriginalId = cloudEvent.Id }
    };

    await result.CopyToHttpResponseAsync(response, ContentMode.Structured, formatter);
});
```

--------------------------------

### Deserialize CloudEvent Data as JObject

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Deserializes an incoming HTTP request into a CloudEvent and then manually converts the generic data (JObject) into a specific GameResult type.

```csharp
CloudEventFormatter formatter = new JsonEventFormatter();
CloudEvent cloudEvent = await request.ToCloudEventAsync(formatter);
JObject dataAsJObject = (JObject) cloudEvent.Data;
GameResult result = dataAsJObject.ToObject<GameResult>();
```

--------------------------------

### Conversions from CloudEvent to Protocol Message

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

These methods convert a CloudEvent object into a protocol-specific message. They support different content modes and allow for either creating a new message or populating an existing one.

```APIDOC
## ToProtocolMessage

### Description
Converts a CloudEvent to a new protocol message instance.

### Method
`public static ProtocolMessage ToProtocolMessage(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvent** (CloudEvent) - The CloudEvent to convert.
- **contentMode** (ContentMode) - The mode for encoding the CloudEvent (structured or binary).
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.

### Response
- **ProtocolMessage** - The resulting protocol message.

## CopyToProtocolMessage

### Description
Populates an existing protocol message with the CloudEvent data.

### Method
`public static void CopyToProtocolMessage(
    this CloudEvent cloudEvent,
    ProtocolMessage destination,
    ContentMode contentMode,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvent** (CloudEvent) - The CloudEvent to convert.
- **destination** (ProtocolMessage) - The existing protocol message to populate.
- **contentMode** (ContentMode) - The mode for encoding the CloudEvent (structured or binary).
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.

## ToHttpContent

### Description
Converts a CloudEvent to an `HttpContent` object.

### Method
`public static HttpContent ToHttpContent(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvent** (CloudEvent) - The CloudEvent to convert.
- **contentMode** (ContentMode) - The mode for encoding the CloudEvent (structured or binary).
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.

### Response
- **HttpContent** - The resulting HttpContent object.

## ToAmqpMessage

### Description
Converts a CloudEvent to an AMQP `Message` object.

### Method
`public static Message ToAmqpMessage(
    this CloudEvent cloudEvent,
    ContentMode contentMode,
    CloudEventFormatter formatter);
`

### Parameters
- **cloudEvent** (CloudEvent) - The CloudEvent to convert.
- **contentMode** (ContentMode) - The mode for encoding the CloudEvent (structured or binary).
- **formatter** (CloudEventFormatter) - The formatter to use for encoding.

### Response
- **Message** - The resulting AMQP Message object.
```

--------------------------------

### Parse CloudEvent from ASP.NET Core HttpRequest

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Use this snippet to deserialize a CloudEvent from an incoming ASP.NET Core HttpRequest. Requires the CloudNative.CloudEvents.AspNetCore using directive.

```csharp
CloudEventFormatter formatter = new JsonEventFormatter();
CloudEvent cloudEvent = await request.ToCloudEventAsync(formatter);
```

--------------------------------

### Deserialize CloudEvent Data with Single-Type Formatter

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/guide.md

Deserializes an incoming HTTP request into a CloudEvent using a specialized JsonEventFormatter<GameResult> for direct type casting.

```csharp
CloudEventFormatter formatter = new JsonEventFormatter<GameResult>();
CloudEvent cloudEvent = await request.ToCloudEventAsync(formatter);
GameResult result = (GameResult) cloudEvent.Data;
```

--------------------------------

### Check if Protocol Message is CloudEvent Batch

Source: https://github.com/cloudevents/sdk-csharp/blob/main/docs/bindings.md

Determines if a given protocol message represents a batch of CloudEvents.

```csharp
public static bool IsCloudEventBatch(this ProtocolMessage message);
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.