Share via


CloudEvent Class

Definition

Represents a CloudEvent conforming to the 1.0 schema. This type has built-in serialization using System.Text.Json.

[System.Text.Json.Serialization.JsonConverter(typeof(Azure.Messaging.CloudEventConverter))]
public class CloudEvent
Inheritance
CloudEvent
Attributes

Constructors

CloudEvent(String, String, BinaryData, String, CloudEventDataFormat)

Initializes a new instance of the CloudEvent class using binary event data.

CloudEvent(String, String, Object, Type)

Initializes a new instance of the CloudEvent class.

Properties

Data

Gets or sets the event data as BinaryData. Using BinaryData, one can deserialize the payload into rich data, or access the raw JSON data using ToString().

DataContentType

Gets or sets the content type of the data.

DataSchema

Gets or sets the schema that the data adheres to.

ExtensionAttributes

Gets extension attributes that can be additionally added to the CloudEvent envelope.

Id

Gets or sets an identifier for the event. The combination of Id and Source must be unique for each distinct event. If not explicitly set, this will default to a Guid.

Source

Gets or sets the context in which an event happened. The combination of Id and Source must be unique for each distinct event.

Subject

Gets or sets the subject of the event in the context of the event producer (identified by source).

Time

Gets or sets the time (in UTC) the event was generated, in RFC3339 format. If not explicitly set, this will default to the time that the event is constructed.

Type

Gets or sets the type of event related to the originating occurrence.

Methods

Parse(BinaryData, Boolean)

Given a single JSON-encoded event, parses the event envelope and returns a CloudEvent. If the specified event is not valid JSON an exception is thrown. By default, if the event is missing required properties, an exception is thrown though this can be relaxed by setting the skipValidation parameter.

ParseMany(BinaryData, Boolean)

Given JSON-encoded events, parses the event envelope and returns an array of CloudEvents. If the specified event is not valid JSON an exception is thrown. By default, if the event is missing required properties, an exception is thrown though this can be relaxed by setting the skipValidation parameter.

Extension Methods

TryGetSystemEventData(CloudEvent, Object)

Gets whether or not the event is a System defined event and returns the deserialized system event data via out parameter.

Applies to

Product Versions
Azure SDK for .NET Latest