Freigeben über


Message Klasse

Definition

Die Datenstruktur stellt die Nachricht dar, die für die Interaktion mit IoT Hub verwendet wird.

public sealed class Message : IDisposable
public sealed class Message
type Message = class
    interface IDisposable
type Message = class
Public NotInheritable Class Message
Implements IDisposable
Public NotInheritable Class Message
Vererbung
Message
Implementiert

Konstruktoren

Message()

Standardkonstruktor ohne Textdaten.

Message(Byte[])

Erstellt eine Telemetriemeldung mit der angegebenen Nutzlast.

Message(Stream)

Konstruktor, der den Argumentstream als Textdatenstrom verwendet.

Eigenschaften

Ack

Wird in Cloud-zu-Gerät-Nachrichten verwendet, um IoT Hub anzufordern, Feedbackmeldungen aufgrund der Nutzung der Nachricht durch das Gerät zu generieren.

ContentEncoding

Wird verwendet, um den Inhaltscodierungstyp der Nachricht anzugeben.

ContentType

Wird verwendet, um den Inhaltstyp der Nachricht anzugeben.

CorrelationId

Eine Zeichenfolgeneigenschaft in einer Antwortnachricht, die normalerweise die Nachrichten-ID der Anforderung im Anforderung-Antwort-Muster enthält.

CreatedOnUtc

Benutzerdefinierte Datumseigenschaft, die vom Absender der Nachricht festgelegt wird.

CreationTimeUtc

Benutzerdefinierte Datumseigenschaft, die vom Absender der Nachricht festgelegt wird.

ExpiresOnUtc

[Optional] Der Zeitpunkt, zu dem diese Nachricht als abgelaufen gilt.

ExpiryTimeUtc

[Optional] Der Zeitpunkt, zu dem diese Nachricht als abgelaufen gilt.

HasPayload

Gibt an, ob die Nachricht über eine Nutzlast verfügt.

LockToken

[Erforderlich] LockToken der empfangenen Nachricht.

MessageId

[Erforderlich für Bidirektionale Anforderungen] Wird verwendet, um bidirektionale Kommunikation zu korrelieren. Format: Eine Zeichenfolge mit 128 Zeichen (bis zu 128 Zeichen lang) von alphanumerischen ASCII-Zeichen mit 7 Bit

  • {'-', ':', '/', '', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', '''}. Nicht alphanumerische Zeichen stammen aus URN RFC.
MessageSchema

Wird verwendet, um das Schema des Nachrichteninhalts anzugeben.

Payload

Die Nachrichtennutzlast

Properties

Ruft das Wörterbuch der Benutzereigenschaften ab, die beim Senden der Daten durch den Benutzer festgelegt werden.

To

[Erforderlich] Ziel der Nachricht.

UserId

[In Feedbacknachrichten erforderlich] Wird verwendet, um den Ursprung der vom Gerätehub generierten Nachrichten anzugeben. Möglicher Wert: "{Hubname}/"

Methoden

Clone()

Erstellt einen Klon der aktuellen Ereignisdaten instance.

Dispose()

Entsorgen der aktuellen Ereignisdaten instance

GetBodyStream()

Zurückgeben des Textdatenstroms der aktuellen Ereignisdaten instance

GetBytes()

Diese Methoden geben den Textdatenstrom als Bytearray zurück.

Gilt für: