WebLogic Messaging API Class Library |

# IBytesMessage.ReadBytes Method (Byte[], Int32)

Reads a portion of the bytes message stream.

If the length of array `value` is less than the number of bytes remaining to be read from the stream, the array will be filled. A subsequent call reads the next increment, and so on.

If the number of bytes remaining in the stream is less than the length of array `value`, the bytes will be read into the array. The return value of the total number of bytes read will be less than the length of the array, indicating that there are no more bytes left to be read from the stream. The next read of the stream returns -1.

If `length` is negative, or `length` is greater than the length of the array `value`, then an `IndexOutOfBoundsException` is thrown. No bytes will be read from the stream for this exception case.

int ReadBytes(
Byte[] value,
Int32 length
);

#### Parameters

Byte[]
  the buffer into which the data is read
Int32
  the number of bytes to read; must be less than or equal to `value.length`

#### Return Value

the total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached

#### Exceptions

Exception Type | Condition
--- | ---
MessageException | if JMS fails to read the message due to some internal error.
MessageNotReadableException | if the message is in write-only mode.

#### See Also

IBytesMessage Interface | WebLogic.Messaging Namespace | IBytesMessage. Overload List