Message Klasse

  • Referenz

Definition

Namespace:
Microsoft.Azure.Devices
Assembly:
Microsoft.Azure.Devices.dll
Paket:
Microsoft.Azure.Devices v1.38.1
Paket:
Microsoft.Azure.Devices v2.0.0-preview002

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
Object
Message
Implementiert
IDisposable

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: