Pop3BeginConnect Method

Note: This API is now obsolete.

Begins an asynchronous request for a connecting to a POP3 server.

Namespace: MailBee.Pop3Mail
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.5.0 build 687 for .NET 4.5
Syntax
[ObsoleteAttribute("This method is obsolete in .NET 4.5+. Use ConnectAsync instead.")]
public IAsyncResult BeginConnect(
	string serverName,
	int port,
	bool pipelining,
	AsyncCallback callback,
	Object state
)

Parameters

serverName
Type: SystemString
The name or IP address of the POP3 server.
port
Type: SystemInt32
The port on which to communicate with the server. The standard POP3 port is 110.
pipelining
Type: SystemBoolean
Specifies whether to use commands pipelining if it's supported by the server.
callback
Type: SystemAsyncCallback
The AsyncCallback delegate. You can leave it a null reference (Nothing in Visual Basic) if you do not use callbacks.
state
Type: SystemObject
An object that contains state information for this request. You can leave it a null reference (Nothing in Visual Basic).

Return Value

Type: IAsyncResult
An IAsyncResult that references the asynchronous connection.
Exceptions
ExceptionCondition
MailBeeInvalidStateExceptionThere is already an operation in progress.
Remarks

This method is an asynchronous version of Connect(String, Int32, Boolean).

A reference to the state object will be available in the events raised by this method through the State property value. This is also valid for the rest of asynchronous methods in MailBee.

Examples
Asynchronous connecting to a POP3 server in WinForms application. This sample also handles Connected event. Wait method is used to wait for the asynchronous method completion, since .NET's standard WaitOne(Int32, Boolean) cannot process events.
// To use the code below, import MailBee namespaces at the top of your code
using MailBee;
using MailBee.Pop3Mail;

// Put the code below inside your class

// "Connected" event handler
private void OnConnected(object sender, ConnectedEventArgs e)
{
    MessageBox.Show("Connected to the server");
}

// The actual code
private void Form1_Load(object sender, System.EventArgs e)
{
    Pop3 pop = new Pop3();

    // Let MailBee process events
    pop.RaiseEventsViaMessageLoop = false;

    pop.Connected += new ConnectedEventHandler(OnConnected);

    // Initiate an asynchronous connection
    pop.BeginConnect("pop.somehost.com", 110, true, null, null);

    // Simulate some lengthy work here...
    for (int i = 0; i < 100; i++)
    {
        // Make a portion of the work
        System.Threading.Thread.Sleep(10);

        // Process events which were raised during execution of the work above
        pop.Wait(0);
    }

    // If the connection was not established during execution of the lengthy 
    // work, wait until it's established
    pop.Wait();

    // End the connection request
    pop.EndConnect();

    // Connected to the server!

    // Disconnect from the server
    pop.Disconnect();
}
Examples
Asynchronous connecting to a POP3 server in non-WinForms application. Applications which do not have message loop (such as console or web applications) can raise events on any thread and do not require any special events processing.
using System;
using MailBee;
using MailBee.Pop3Mail;
using MailBee.Mime;

class Sample
{
    // "Connected" event handler
    private static void OnConnected(object sender, ConnectedEventArgs e)
    {
        Console.WriteLine("Connected to the server");
    }

    // The actual code
    static void Main(string[] args)
    {
        Pop3 pop = new Pop3();

        pop.Connected += new ConnectedEventHandler(OnConnected);

        // Initiate an asynchronous connection
        pop.BeginConnect("pop.somehost.com", 110, true, null, null);

        // Simulate some lengthy work here...
        System.Threading.Thread.Sleep(1000);

        // If the connection was not established during execution of the lengthy work,
        // wait until it's established, and end the connection request
        pop.EndConnect();

        // Connected to the server!

        // Disconnect from the server
        pop.Disconnect();
    }
}
See Also