Add(Stream,ImapFlags,DateTime) メソッド

APPENDを使用して、カスタマイズされた属性を持つ新しいメッセージをメールボックスに追加します。

シンタックス

Visual Basic (宣言)
C#

Public Overloads Sub Add( _
   ByVal encodedMessage As Stream, _
   ByVal flags As ImapFlags, _
   ByVal date As Date _
)

public void Add( 
   Stream encodedMessage,
   ImapFlags flags,
   DateTime date
)

パラメータ

encodedMessage: エンコードされたメッセージを含むStream。
flags: メッセージに設定するImapFlags。
date: メッセージに対して使用する内部日付を表すSystem.DateTime。

戻り値の型

新しく追加されたメッセージを表すImapMessage。

例外

例外	解説
ProtocolException	サーバーから受信したIMAPプロトコル応答が不良です。
System.Net.Sockets.SocketException	通信エラーが発生しました。

解説

このメソッドはAPPENDコマンドをIMAPサーバーに送信し、encodedMessageをSelectedMailboxに追加します。 flagsは、新しいメッセージに設定するフラグを決定します。dateは内部日付（メッセージが届いた日付）を設定します。

使用例

以下のサンプルコードは、Imapコンポーネントを使用してメッセージをメールサーバーにアップロードする方法を示します。

private void uploadMessage(object sender)
{
    // サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = new Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session));
    imap1.Session.Username = myUsername;
    imap1.Session.Password = myPassword;

    // アップロードするメッセージを作成します。
    MailMessage message = new MailMessage();
    message.From = fromAddress;
    message.To = toAddress;
    message.Subject = "This is an uploaded message";
    message.Text = "This is an uploaded message.";

    // 接続してアカウントにログインします。
    imap1.Connect();
    imap1.Authenticate();

    // メッセージのアップロード先のメールボックスを選択します（'Save'メールボックスが存在することを前提とします）。
    imap1.SelectedMailbox = imap1.Mailboxes["Save"];

    // メッセージをアップロードします。
    imap1.SelectedMailbox.Add(message.GetEncodingStream(), ImapFlags.None, DateTime.Now);

    // セッションから適切にログアウトします。
    imap1.Close();
}

Visual Basic

Private Sub uploadMessage(ByVal sender As Object)
    ' サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = New Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session))
    imap1.Session.Username = myUsername
    imap1.Session.Password = myPassword

    ' アップロードするメッセージを作成します。
    Dim message As New MailMessage()
    message.From = fromAddress
    message.To = toAddress
    message.Subject = "This is an uploaded message"
    message.Text = "This is an uploaded message."

    ' 接続してアカウントにログインします。
    imap1.Connect()
    imap1.Authenticate()

    ' メッセージのアップロード先のメールボックスを選択します（'Save'メールボックスが存在することを前提とします）。
    imap1.SelectedMailbox = imap1.Mailboxes("Save")

    ' メッセージをアップロードします。
    imap1.SelectedMailbox.Add(message.GetEncodingStream(), ImapFlags.None, Date.Now)

    ' セッションから適切にログアウトします。
    imap1.Close()
End Sub

参照

Mailbox クラス
 Mailbox メンバ
 オーバーロード一覧