Begins to asynchronously retrieve all of the messages contained in the mailbox.

Syntax

Visual Basic (Declaration)
Public Overloads Function BeginGet( _ ByVal state As Object _ ) As IAsyncResult

Visual Basic (Usage)	Copy Code
Dim instance As Mailbox Dim state As Object Dim value As IAsyncResult value = instance.BeginGet(state)

C#
public IAsyncResult BeginGet( object state )

Managed Extensions for C++
public: IAsyncResult* BeginGet( Object* state )

C++/CLI
public: IAsyncResult^ BeginGet( Object^ state )

Parameters

state: User state information.

Return Value

An IAsyncResult that represents the asynchronous operation, which could still be pending.

Exceptions

Exception	Description
Dart.PowerTCP.Mail.ProtocolException	Bad IMAP protocol response received from server.
System.Net.Sockets.SocketException	The requested address is not valid in its context.
System.InvalidOperationException	BeginXXX method used without providing an EndXXX event handler.
System.ArgumentOutOfRangeException	index was out of range
System.IndexOutOfRangeException	index was outside bounds of array
Dart.PowerTCP.Mail.InvalidParameterTypeException	Collection contains instances of wrong type of object

Remarks

The Mailbox.BeginGet method retrieves in full the messages contained in this mailbox and uses the data to populate the Mailbox.Messages collection and its contents. Upon completion of this operation the Imap.EndGetMessage event is raised

This method uses the IMAP FETCH command to retrieve message content. The command uses the UIDs of the messages (ImapMessage.Uid) to retrieve content.

This method is useful for bulk operations. If you would like to retrieve only a single message, use the ImapMessage.BeginGet method of the ImapMessage object.

Requirements

Target Platforms: Microsoft .NET Framework 2.0