QABinaryMessage-Schnittstelle

Ein QABinaryMessage-Objekt wird verwendet, um eine Nachricht zu versenden, die einen Datenstrom von nicht-interpretierten Bytes enthält.

Visual Basic-Syntax

Public Interface QABinaryMessage Inherits QAMessage

C#-Syntax

public interface QABinaryMessage : QAMessage

Mitglieder

Alle Mitglieder der QABinaryMessage-Schnittstelle, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
ClearBody-Methode	Löscht den Nachrichtenhauptteil.
ClearProperties-Methode	Löscht alle Eigenschaften der Nachricht.
GetBooleanProperty-Methode	Ruft eine boolesche Nachrichteneigenschaft ab.
GetByteProperty-Methode	Ruft eine Byte-Nachrichteneigenschaft ab.
GetDoubleProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ double ab.
GetFloatProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ float ab.
GetIntProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ int ab.
GetLongProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ long ab.
GetProperty-Methode	Ruft eine Nachrichteneigenschaft ab.
GetPropertyNames-Methode	Ruft einen Enumerator über die Eigenschaftsnamen der Nachricht ab.
GetPropertyType-Methode	Gibt den Eigenschaftstyp der angegebenen Eigenschaft zurück.
GetSbyteProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ byte (mit Vorzeichen) ab.
GetShortProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ short ab.
GetStringProperty-Methode	Ruft eine Zeichenfolgen-Nachrichteneigenschaft ab.
PropertyExists-Methode	Gibt an, ob die angegebene Eigenschaft für diese Nachricht definiert wurde.
ReadBinary-Methode	Liest die angegebene Anzahl von Byte ab dem ungelesenen Abschnitt eines QABinaryMessage-Instanzenhauptteils und speichert sie im dest-Array.
ReadBoolean-Methode	Liest einen Wert vom Typ boolean beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
ReadChar-Methode	Liest einen Zeichenwert beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadDouble-Methode	Liest einen double-Wert beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadFloat-Methode	Liest einen Wert vom Typ float beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadInt-Methode	Liest einen Wert vom Typ int beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadLong-Methode	Liest einen Wert vom Typ long beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadSbyte-Methode	Liest einen Wert vom Typ byte beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadShort-Methode	Liest einen Wert vom Typ short beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
ReadString-Methode	Liest einen Wert vom Typ String beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein.
Reset-Methode	Setzt eine Nachricht zurück, sodass das Lesen der Werte am Beginn des Nachrichtenhauptteils beginnt.
SetBooleanProperty-Methode	Legt einen Eigenschaftswert vom Typ boolean fest.
SetByteProperty-Methode	Legt eine Byte-Eigenschaft fest.
SetDoubleProperty-Methode	Legt einen Eigenschaftswert vom Typ double fest.
SetFloatProperty-Methode	Legt einen Eigenschaftswert vom Typ float fest.
SetIntProperty-Methode	Legt einen Eigenschaftswert vom Typ int fest.
SetLongProperty-Methode	Legt einen Eigenschaftswert vom Typ long fest.
SetProperty-Methode	Legt eine Eigenschaft fest.
SetSbyteProperty-Methode	Legt einen Eigenschaftswert vom Typ byte (mit Vorzeichen) fest.
SetShortProperty-Methode	Legt einen Eigenschaftswert vom Typ short fest.
SetStringProperty-Methode	Legt einen Eigenschaftswert vom Typ String fest.
WriteBinary-Methode	Hängt die angegebene Anzahl von Bytes aus einem Byte-Array, beginnend am angegebenen Offset, an den Nachrichtenhauptteil der QABinaryMessage-Instanz an.
WriteBoolean-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen Wert vom Typ boolean an.
WriteChar-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen char-Wert an.
WriteDouble-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen double-Wert an.
WriteFloat-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen float-Wert an.
WriteInt-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen int-Wert an.
WriteLong-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen long-Wert an.
WriteSbyte-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen Wert vom Typ byte an.
WriteShort-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen short-Wert an.
WriteString-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen String-Wert an.
Address-Eigenschaft	Die Zieladresse für die QAMessage-Instanz.
BodyLength-Eigenschaft	Gibt die Größe des Nachrichtenhauptteils in Byte zurück.
Expiration-Eigenschaft	Ruft den Ablaufwert der Nachricht ab.
InReplyToID-Eigenschaft	Die Nachricht-ID der Nachricht, für die diese Nachricht als Antwort gesendet wird.
MessageID-Eigenschaft	Die global eindeutige Nachricht-ID der Nachricht.
Priority-Eigenschaft	Die Priorität der Nachricht (von 0 bis 9).
Redelivered-Eigenschaft	Gibt an, ob die Nachricht vorher empfangen, aber nicht quittiert wurde.
ReplyToAddress-Eigenschaft	Die Rückantwortadresse dieser Nachricht.
Timestamp-Eigenschaft	Der Nachrichtenzeitstempel.

QABinaryMessage erbt von der QAMessage-Klasse und fügt einen Byte-Nachrichtenhauptteil hinzu. QABinaryMessage bietet eine Reihe von Funktionen für das Lesen und Schreiben im Byte-Nachrichtenhauptteil.

Wenn eine Nachricht erstmals erstellt wird, ist der Hauptteil der Nachricht im Nur-Schreiben-Modus. Nachdem eine Nachricht gesendet wurde, kann sie der absendende Client einbehalten und ändern, ohne dass die gesendete Nachricht davon betroffen ist. Dasselbe Nachrichtenobjekt kann mehrfach gesendet werden.

Wenn eine Nachricht empfangen wird, hat der Provider QABinaryMessage.Reset() aufgerufen, damit der Nachrichtenhauptteil in den schreibgeschützten Modus gesetzt wird und das Lesen der Werte ab Beginn des Nachrichtenhauptteils beginnt.

Beispiel

Im folgenden Beispiel werden mithilfe der writeString-Funktion für QABinaryMessage die Zeichenfolgen "Q" und "Anywhere" in den Nachrichtenhauptteil einer QABinaryMessage-Instanz geschrieben.

// create a binary message instance
QABinaryMessage binary_message;
binary_message = qa_manager.CreateBinaryMessage();

// set optional message properties ...
binary_message.ReplyToAddress = "my-queue-name";

// write to the message body
binary_message->WriteString("Q");
binary_messge->WriteString("Anywhere");

// put the message in the local database, ready for sending
if(!qa_manager->putMessage( "store-id\\queue-name", msg )) {
	    handleError();
	}

Die Nachricht wird vom QAnywhere Agent gesendet. Auf der Empfängerseite gibt der erste Aufruf von QABinaryMessage.ReadString "Q" zurück, der nächste Aufruf von QABinaryMessage.ReadString gibt "Anywhere" zurück.

Weitere Hinweise finden Sie unter Zeitpunkt der Nachrichtenübermittlung auf dem Client festlegen und Schreiben von QAnywhere-Clientanwendungen.

ReadBinary-Methode
ReadBoolean-Methode
ReadChar-Methode
ReadDouble-Methode
ReadFloat-Methode
ReadInt-Methode
ReadLong-Methode
ReadSbyte-Methode
ReadShort-Methode
ReadString-Methode
Reset-Methode
WriteBinary-Methode
WriteBoolean-Methode
WriteChar-Methode
WriteDouble-Methode
WriteFloat-Methode
WriteInt-Methode
WriteLong-Methode
WriteSbyte-Methode
WriteShort-Methode
WriteString-Methode
BodyLength-Eigenschaft

Kommentieren Sie diese Seite in DocCommentXchange.