Occurs when data is received from the connected socket.

Event Data

The event handler receives an argument of type DataTransferEventArgs containing data related to this event. The following DataTransferEventArgs properties provide information specific to this event.

Remarks

If the transmission channel is encrypted, this event will be raised when any encrypted chunk of data is received. Thus, this event can be used to record the data which is actually received from the network.

The typical use of this property is to calculate the network traffic produced during the IMAP4 session. SSL encryption increases the length of the transmitted data blocks, thus it's more accurate to calculate traffic by counting the length of data actually transmitted over the network.

If the transmission channel is not encrypted or otherwise scrambled, this property is equivalent to DataReceived.

Example

This sample calculates all incoming traffic from the server during the IMAP4 session, and prints the result into console.

[C#]
using System;
using MailBee;
using MailBee.ImapMail;
using MailBee.Mime;

class Sample
{
    // Total bytes received counter.
    private static int _totalBytes = 0;

    // LowLevelDataReceived event handler.
    private static void OnLowLevelDataReceived(object sender, DataTransferEventArgs e)
    {
        // Increment the counter.
        _totalBytes += e.Data.Length;
    }

    // The actual code.
    static void Main(string[] args)
    {
        Imap imp = new Imap();

        // Subscribe to the LowLevelDataReceived event.
        imp.LowLevelDataReceived += new DataTransferEventHandler(OnLowLevelDataReceived);

        // Do something which would produce some network traffic.
        imp.Connect("mail.domain.com");
        imp.Login("jdoe", "secret");
        imp.SelectFolder("Inbox");
        MailMessageCollection msgs = imp.DownloadMessageHeaders(Imap.AllMessages, false);
        imp.Disconnect();

        // Print the total number of bytes previously received from the server.
        Console.WriteLine(_totalBytes + " bytes received in all");
    }
}

[Visual Basic]
Imports System
Imports MailBee
Imports MailBee.ImapMail
Imports MailBee.Mime

Module Sample
    ' Total bytes received counter.
    Dim _totalBytes As Integer = 0

    ' LowLevelDataReceived event handler.
    Private Sub OnLowLevelDataReceived(ByVal sender As Object, ByVal e As DataTransferEventArgs)
        ' Increment the counter.
        _totalBytes += e.Data.Length
    End Sub

    ' The actual code.
    Sub Main(ByVal args As String())
        Dim imp As New Imap

        ' Subscribe to the LowLevelDataReceived event.
        AddHandler imp.LowLevelDataReceived, AddressOf OnLowLevelDataReceived

        ' Do something which would produce some network traffic.
        imp.Connect("mail.domain.com")
        imp.Login("jdoe", "secret")
        imp.SelectFolder("Inbox")
        Dim msgs As MailMessageCollection = imp.DownloadMessageHeaders(Imap.AllMessages, False)
        imp.Disconnect()

        ' Print the total number of bytes previously received from the server.
        Console.WriteLine(_totalBytes & " bytes received in all")
    End Sub
End Module

See Also

Imap Class | MailBee.ImapMail Namespace | DataReceived

---