Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Overloads Function Copy( _ ByVal first As ImapMessage, _ ByVal last As ImapMessage, _ ByVal destination As Mailbox _ ) As ImapResponse | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
Dim instance As Mailbox Dim first As ImapMessage Dim last As ImapMessage Dim destination As Mailbox Dim value As ImapResponse value = instance.Copy(first, last, destination) | |
| C# | |
|---|---|
public ImapResponse Copy( ImapMessage first, ImapMessage last, Mailbox destination ) | |
| Managed Extensions for C++ | |
|---|---|
public: ImapResponse* Copy( ImapMessage* first, ImapMessage* last, Mailbox* destination ) | |
| C++/CLI | |
|---|---|
public: ImapResponse^ Copy( ImapMessage^ first, ImapMessage^ last, Mailbox^ destination ) | |
Parameters
- first
- An ImapMessage object representing the first message in the range to copy.
- last
- An ImapMessage object representing the last message in the range to copy.
- destination
- The name of the destination mailbox.
Return Value
An ImapResponse object encapsulating the response from the server.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.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.Copy method copies the messages contained within the range specified by first and last. This command results in an IMAP COPY command being issued to the server. The command uses the UIDs of the messages to perform the copy operation. The ImapMessages in messages must be in this mailbox.
This method is useful for bulk operations. If you would like to copy a single message, use the ImapMessage.CopyTo method of the ImapMessage object.
Requirements
Target Platforms: Microsoft .NET Framework 2.0