Freigeben über


Message Klasse

Definition

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

public sealed class Message : IDisposable, Microsoft.Azure.Devices.Client.IReadOnlyIndicator
type Message = class
    interface IReadOnlyIndicator
    interface IDisposable
Public NotInheritable Class Message
Implements IDisposable, IReadOnlyIndicator
Vererbung
Message
Implementiert

Konstruktoren

Message()

Standardkonstruktor ohne Textdaten

Message(Byte[])

Konstruktor, der das Eingabebytearray als Text verwendet.

Message(Stream)

Konstruktor, der den Argumentstream als Textdatenstrom verwendet.

Eigenschaften

BodyStream

Der Textdatenstrom der aktuellen Ereignisdaten instance

ComponentName

Der DTDL-Komponentenname, von dem die Telemetrienachricht stammt. Dies ist nur für Plug-and-Play-zertifizierte Geräte relevant.

ConnectionDeviceId

Gibt die Geräte-ID an, von der diese Nachricht gesendet wurde, sofern vorhanden.

ConnectionModuleId

Gibt die Modul-ID an, von der diese Nachricht gesendet wurde, sofern vorhanden.

ContentEncoding

Wird verwendet, um den Inhaltscodierungstyp der Nachricht anzugeben.

ContentType

Wird verwendet, um den Inhaltstyp der Nachricht anzugeben.

CorrelationId

Wird in Nachrichtenantworten und Feedback verwendet

CreationTimeUtc

Benutzerdefinierte Datumseigenschaft, die vom Absender der Nachricht festgelegt wird.

DeliveryCount

Anzahl der Zugestellten der Nachricht

EnqueuedTimeUtc

Datum und Uhrzeit, zu dem die Device-to-Cloud-Nachricht vom Server empfangen wurde.

ExpiryTimeUtc

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

InputName

Gibt den Eingabenamen an, unter dem die Nachricht gesendet wurde, sofern vorhanden.

IsSecurityMessage

True, wenn die Nachricht als Sicherheitsmeldung festgelegt ist

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.

Properties

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

SequenceNumber

[Erforderlich] SequenceNumber der empfangenen Nachricht

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

CloneWithBody(Byte[])

Klont einen vorhandenen Message instance und legt den Inhaltstext fest, der durch definiert wirdbyteArray.

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.

SetAsSecurityMessage()

Legt die Nachricht als Sicherheitsnachricht fest.

Explizite Schnittstellenimplementierungen

IReadOnlyIndicator.IsReadOnly

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

Gilt für: