Message Klasse

  • Referenz

Definition

Namespace:
Microsoft.Azure.Devices.Client
Assemblys:
Microsoft.Azure.Devices.Client.dll, Microsoft.Azure.Devices.Client.PCL.dll
Assembly:
Microsoft.Azure.Devices.Client.dll
Pakete:
Microsoft.Azure.Devices.Client v1.41.2, Microsoft.Azure.Devices.Client.PCL v1.0.16
Paket:
Microsoft.Azure.Devices.Client v1.36.6

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

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: