CloudEvent Class

Definition

Namespace:

Azure.Messaging

Assembly:

Azure.Core.dll

Package:

Azure.Core v1.38.0

Source:

CloudEvent.cs

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

[<System.Text.Json.Serialization.JsonConverter(typeof(Azure.Messaging.CloudEventConverter))>]
type CloudEvent = class

Public Class CloudEvent

Inheritance

Object

CloudEvent

Attributes

JsonConverterAttribute

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.