QABinaryMessage 接口

QABinaryMessage 对象用于发送包含未解释字节流的消息。

Visual Basic 语法

Public Interface QABinaryMessage Inherits QAMessage

C# 语法

public interface QABinaryMessage : QAMessage

基类

成员

QABinaryMessage 接口的所有成员，包括所有继承的成员。

名称	说明
ClearBody 方法	清除消息的主体。
ClearProperties 方法	清除消息的所有属性。
GetBooleanProperty 方法	获取布尔型消息属性。
GetByteProperty 方法	获取字节消息属性。
GetDoubleProperty 方法	获取双精度型消息属性。
GetFloatProperty 方法	获取浮点型消息属性。
GetIntProperty 方法	获取整型消息属性。
GetLongProperty 方法	获取长整型消息属性。
GetProperty 方法	获取消息属性。
GetPropertyNames 方法	获取消息属性名称的枚举器。
GetPropertyType 方法	返回给定属性的属性类型。
GetSbyteProperty 方法	获取有符号字节型消息属性。
GetShortProperty 方法	获取短整型消息属性。
GetStringProperty 方法	获取字符串型消息属性。
PropertyExists 方法	指示是否已为此消息设置了给定属性。
ReadBinary 方法	从 QABinaryMessage 实例主体的未读部分开始读取最大数量的字节并将其存储到数组目标中。
ReadBoolean 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取布尔值。
ReadChar 方法	从 QABinaryMessage 消息主体的未读部分开始读取字符值。
ReadDouble 方法	从 QABinaryMessage 消息主体的未读部分开始读取双精度值。
ReadFloat 方法	从 QABinaryMessage 消息主体的未读部分开始读取浮点值。
ReadInt 方法	从 QABinaryMessage 消息主体的未读部分开始读取整数值。
ReadLong 方法	从 QABinaryMessage 消息主体的未读部分开始读取长整型值。
ReadSbyte 方法	从 QABinaryMessage 消息主体的未读部分开始读取有符号字节值。
ReadShort 方法	从 QABinaryMessage 消息主体的未读部分开始读取短整型值。
ReadString 方法	从 QABinaryMessage 消息主体的未读部分开始读取字符串值。
Reset 方法	重置消息以便从消息主体的开头开始读取值。
SetBooleanProperty 方法	设置布尔型属性。
SetByteProperty 方法	设置字节型属性。
SetDoubleProperty 方法	设置双精度型属性。
SetFloatProperty 方法	设置浮点型属性。
SetIntProperty 方法	设置整型属性。
SetLongProperty 方法	设置长整型属性。
SetProperty 方法	设置属性。
SetSbyteProperty 方法	设置有符号字节型属性。
SetShortProperty 方法	设置短整型属性。
SetStringProperty 方法	设置字符串型属性。
WriteBinary 方法	以给定偏移为起点将字节数组的长度字节附加到 QABinaryMessage 实例的消息主体中。
WriteBoolean 方法	将布尔值附加到 QABinaryMessage 实例的消息主体中。
WriteChar 方法	将字符值附加到 QABinaryMessage 实例的消息主体中。
WriteDouble 方法	将双精度值附加到 QABinaryMessage 实例的消息主体中。
WriteFloat 方法	将浮点值附加到 QABinaryMessage 实例的消息主体中。
WriteInt 方法	将整数值附加到 QABinaryMessage 实例的消息主体中。
WriteLong 方法	将长整型值附加到 QABinaryMessage 实例的消息主体中。
WriteSbyte 方法	将有符号字节值附加到 QABinaryMessage 实例的消息主体中。
WriteShort 方法	将短整型值附加到 QABinaryMessage 实例的消息主体中。
WriteString 方法	将字符串值附加到 QABinaryMessage 实例的消息主体中。
Address 属性	QAMessage 实例的目标地址。
BodyLength 属性	返回消息主体的大小（以字节为单位）。
Expiration 属性	获取消息的有效期值。
InReplyToID 属性	此消息所回复的消息的消息 ID。
MessageID 属性	消息的全局唯一消息 ID。
Priority 属性	消息的优先级（从 0 到 9）。
Redelivered 属性	指示消息是否以前已接收但尚未确认。
ReplyToAddress 属性	此消息的回复地址。
Timestamp 属性	消息时间戳。

注释

它继承自类 QAMessage，并添加了字节消息主体。QABinaryMessage 提供了读取和写入字节消息主体的各种函数。

首次创建消息时，消息的主体处于只写模式。消息发送后，发送消息的客户端可保留和修改该消息，而不会影响已发送的消息。可以多次发送同一消息对象。

接收到消息时，提供程序已调用 QABinaryMessage.Reset()，因此消息主体处于只读模式并且从消息主体的开头开始读取值。

示例

以下示例使用 QABinaryMessage writeString 函数将其后是字符串 "Anywhere" 的字符串 "Q" 写入 QABinaryMessage 实例的消息主体。

// 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();
	}

由 QAnywhere 代理发送消息。在接收端，第一次 QABinaryMessage.ReadString 调用返回 "Q"，而下一次 QABinaryMessage.ReadString 调用则返回 "Anywhere"。

有关详细信息，请参见确定在客户端进行消息传输的时间和编写 QAnywhere 客户端应用程序。

ReadBinary 方法
 ReadBoolean 方法
 ReadChar 方法
 ReadDouble 方法
 ReadFloat 方法
 ReadInt 方法
 ReadLong 方法
 ReadSbyte 方法
 ReadShort 方法
 ReadString 方法
 Reset 方法
 WriteBinary 方法
 WriteBoolean 方法
 WriteChar 方法
 WriteDouble 方法
 WriteFloat 方法
 WriteInt 方法
 WriteLong 方法
 WriteSbyte 方法
 WriteShort 方法
 WriteString 方法
 BodyLength 属性

使用DocCommentXchange 讨论此页。