CloudEvent Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
-
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 |
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 |
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. |