メール

ExwarpMailKit1.0.438.*以降のライブラリ＋Exwarp.Module.EmojiModuleを利用すると、絵文字を簡単に作成することができます。

最新版をダウンロードしてください。

送信処理中にエラーが発生する場合、Exwarp.Net.Mail.MailMessageのSendResultカスタムプロパティにExwarp.Net.Smtp.SendResult.Failedがセットされ、送信に成功した場合、Exwarp.Net.Smtp.SendResult.Completeがセットされます。
この値をチェックすることで正常にメールが送信されたかどうかを判断できます。

この機能は1.0.339.*以上のライブラリで利用可能です。
また、この機能は実際にメールが受信者まで送信されたかどうかを識別するものではありません。SMTPホストが送信メールを正常に受け付けたかどうかを判断するだけですので、QUITコマンドが送信される前に接続が切断された場合などは、SendResultカスタムプロパティの値に関係なく、メールの送信が行われない場合もありますのでご注意ください。

HMAC-MD5（鍵付きMD5やKeyed-MD5などとも表現される）は、SMTP認証などに使用される暗号化プロセスです。

Exwarp MailKitを利用すると、HMAC-MD5も簡単に実行できます。

HMAC-MD5を実行するために、Exwarp.Security.EncryptTransform.HMACMD5Transformのインスタンスを生成します。このクラスのコンストラクタには、暗号化に使用するキーを表す文字列をセットします。

Encode()メソッドを使用して、暗号化を実行します。パラメータは暗号化されるバイト列をセットします。
このメソッドは暗号化されたバイト列を戻り値として返します。

SMTPホストによっては、送信前にPOP3サーバーへの認証を完了させておかなければメールの送信が行えないことがあります。こうした認証をPopBeforeSmtpと言います。Exwarp.Net.Pop3.Pop3Clientを使うと簡単にPopBeforeSmtp認証が行えます。

POP3_HOSTはPOP3ホストのホスト名、
SMTP_HOSTはSMTPホストのホスト名を表す文字列、
USERはPOP3ホストのユーザー名、
PASSWORDはPOP3ホストのパスワードを表す文字列、
MAILは送信メールを表すExwarp.Net.Mail.MailMessageの初期化済みインスタンスです。

PopBeforeSmtp認証を実行するために、Exwarp.Net.Pop3.Pop3ClientのPopBeforeSmtpカスタムオペレーションを実行します。このカスタムオペレーションはPOP3ホストへの認証処理のみ実行します。事前にユーザー名とパスワードをPop3Clientインスタンスに設定しておく方法と、PopBeforeSmtpカスタムオペレーションのパラメータとして、ユーザー名とパスワードを設定する二つの方法があります。（サンプルコードにてコメントアウトしている方法が後者です。）
PopBeforeSmtpカスタムオペレーションはカスタムオペレーション内で、ホストへの接続、切断処理を行いますので、Connect()、Close()メソッドを呼び出す必要はありません。（仮にこれらのメソッドをコールしても無視されます。）

PopBeforeSmtp認証が完了すると、メールの送信が通常どおり行えます。

SmtpClientのLocalHostプロパティを使用すると、SMTPのHELO/EHLOコマンド送信時に、メール送信ホスト名を通知することができます。

clientはExwarp.Net.Smtp.SmtpClientのインスタンスを表します。
MAILは初期化済みのExwarp.Net.Mail.MailMessageクラスのインスタンスを表します。

送信前に、SmtpClientのLocalHostプロパティにメール送信ホスト名を設定します。
このプロパティに値が設定されると、SmtpClientは、HELO/EHLOコマンド送信時に、メール送信ホスト名を通知します。

このプロパティの値が未設定の場合、SmtpClientは、HELO/EHLOコマンド送信時にメール送信ホスト名を通知しません。たいていの場合、メール送信ホスト名は省略できますので、このプロパティを設定する必要はありません。

この機能は、 1.0.311.*以上のバージョンで使用できます。

Exwarp.Net.Smtp.SmtpClientを使用すると、複数のメールメッセージを一度の接続で送信することができます。1メッセージごとに接続する場合に比べてパフォーマンスが格段に向上します。

clientは、Exwarp.Net.Smtp.SmtpClientのインスタンスを表します。
MAIL1,MAIL2はExwarp.Net.Mail.MailMessageの初期化済みインスタンスを表します。

一度の接続で送信したいメールメッセージをコレクションに追加します。System.Collections.ArrayListだけでなく、System.Collections.IEnumerableインターフェースを実装したクラスのインスタンスなら何でも構いません。

メールを追加したコレクションをSmtpClientのSendReceive()メソッドにパラメータとして渡すと、SmtpClientは一度の接続で、コレクションに含まれるすべてのメッセージを送信します。

この機能は1.0.311.*以上のバージョンで利用できます。Tryoutバージョンでは、一度に連続送信できるメッセージの数は3件に制限されます。コレクションに4件以上追加しても最初の3件しか送信されませんのでご注意ください。

Exwarp MailKitの最新バージョン1.0.311.*をリリースしました。

主な変更点は以下のとおりです。

• Pop3Client.SendReceive()メソッドで複数のメールメッセージを指定できるように仕様変更しました。
  一度の接続で複数のメールメッセージを連続して送信できます。
• SmtpClientにLocalHostプロパティを追加しました。
  HELO/EHLO
コマンド送信時にメール送信ホスト名を指定できます。
このプロパティに値を設定しない場合、送信ホスト名は省略されます。
• mailboxにメールアドレス（addr-spec）が含まれない場合でも、ヘッダーが正しく表示されるように仕様変更しました。
  この変更により、display-nameのみのFromヘッダーなども解析できます。

ESMTPでは、SMTPサーバーへの認証手続きが可能になっています。SMTP認証を使用したログイン処理を行うためには、Exwarp.Net.Smtp.SmtpClient.UseESMTPプロパティを使用します。

HOST_NAMEはSMTPホスト名、
USERはユーザー名、
PASSはパスワードを表す文字列です。
MAILは送信するメールメッセージを表すExwarp.Net.Mail.MailMessageのインスタンスです。

Exwarp.Net.Smtp.SmtpClientのインスタンスを生成します。

SMTP-AUTHに使用するユーザー名とパスワードを設定します。

SmtpClientのUseESMTPプロパティをtrueに設定すると、SMTPクライアントはESMTPモードで動作します。SMTP-AUTHの認証方法を切り替えたい場合、SmtpClientのAuthTypeプロパティに使用したい認証方法を表すExwarp.Net.Smtp.SmtpAuthTypeのいずれかの値を設定します。

ホストに接続し、SendReceive()メソッドを使用して、メールメッセージを送信します。

この機能は、1.0.308.*以上のバージョンで使用することができます。

ESMTP（SMTP-AUTH）用のインターフェースを追加した1.0.308.1を公開いたしました。

ESMTPモードに切り替えるUseESMTPプロパティが追加されています。このプロパティをtrueに設定すると、SMTPクライアントはセッション開始時に、EHLOコマンドを送信します。ホストが250 AUTH応答を返す場合、SMTPクライアントはSMTP-AUTHを使用してログイン処理を行います。250 AUTH応答が含まれない場合、ログイン処理は行われません。

同時に複数の宛先にメールを送信する際、Toの値を全て同じにしたい場合があります。
例えば、AさんとBさんにメールを送りますが、AさんとBさんが受け取ったメールのToメールヘッダーには"<customers@myhost.com>"などとしたい場合です｡

このようにダミーの宛先を設定する場合、SetProperty("_To",***)を使用します｡

Toヘッダーにダミーの宛先を設定します。

実際の送信先は、文字列型の配列に格納し、MailMessageのSetProperty()メソッドを使用して_Toカスタムプロパティに設定します。_Toカスタムプロパティがメールメッセージに設定されている場合、SMTPクライアントはこの値をメールの送信先と認識します。

同じ原理で_Cc、_Bccカスタムプロパティも使用できます。

この機能の実行には、Exwarp MailKit バージョン1.0.307.*以上が必要です｡

SMTP-AUTHやRFC2231などに対応したExwarp MailKit 1.0 Beta1 rc2を公開しました。

以前のバージョンとの大きな違いは次のとおりです。

• SMTP-AUTHに対応（PLAIN、LOGIN、CRAM-MD5に対応）
• HMACMD5Transformクラスの追加
• ByteBufferクラスのストリーム対応
• RFC2231形式のヘッダーフィールドパラメータに対応（RFC2231形式での書き出しには非対応）
• メール本文でBare LF/Bare CR（LF及びCR単体での使用）をCR/LFに自動変換機能の追加
• text/htmlメディアタイプのcharsetパラメータ自動付加を抑止
• Exwarp.Net.Mail.MailContext.MyMailAddressプロパティをExwarp.Net.Mail.MailContext.SenderAddressに変更（互換性維持のため、Obsoleteとなります。）
• Exwarp.Net.Mail.MailContext.GetMyAddress()メソッドをExwarp.Net.Mail.MailContext.GetSenderAddress()に変更（互換性維持のため、Obsoleteとなります。）
• その他の微細な仕様変更を追加

本バージョンの公開は短期間で終了いたします。その後製品版の公開となり、無料バージョンは機能制限のついたトライアル版へ移行いたします。

次期バージョンにてExwarp.Net.Smtp.SmtpClientにSMTP-AUTH機能を実装します。対応するのは、PLAIN、LOGIN、Cram-MD5の3つの認証方式です。

本機能の実装に伴い、Exwarp.Transform.HMACMD5Transformクラスが追加されています。このクラスはキー付きのMD5ダイジェスト生成をサポートします。

これらの機能は、1.0.300.*より後のバージョンで提供されます。

1.0.300.*は最終ベータの予定でしたが、リリース後多くの機能が追加されたため、再度最終ベータExwarp MailKit 1.0 Beta rc2をリリースする予定です。

Exwarpでは、メール送信のほとんどの処理をカスタムオペレーションで自動化していますが、SMTPコマンドを直接操作することもできます。SMTPコマンドの操作にはExwarp.Net.Smtp.SmtpClient,Exwarp.Net.Smtp.SmtpRequest及びExwarp.Net.Smtp.SmtpResponseを使用します。

SMTPコマンドを操作するためにExwarp.Net.Smtp.SmtpClientのインスタンスを生成します。コンストラクタにホスト名を表す文字列を受け取ります。

Connect()メソッドでSMTPホストに接続します。

SendReceive()メソッドを使用してSMTPコマンドを送信します。送信するSMTPコマンドはExwarp.Net.Smtp.SmtpRequestオブジェクトがカプセル化します。コンストラクタに送信したいSMTPコマンドを表す文字列を設定します。この際必ず末尾にCR/LFを付加します。

SendReceive()メソッドはExwarp.Net.RFC.IResponseMessage（インターフェース）型の戻り値を返します。このオブジェクトはホストからの応答をカプセル化しています。厳密にはExwarp.Net.Smtp.SmtpResponse型のオブジェクトが返されますので,キャストしてSMTP応答の詳細な情報が取得できます。

SmtpResponseオブジェクトのStatusプロパティからSMTPホストの応答メッセージ（ステータスライン）を表す文字列が取得できます。拡張SMTPの複数行応答にも対応していますので、HELOコマンドの代わりにEHLOコマンドを使うこともできます。この場合ホストは挨拶メッセージに加えてホストがサポートしている拡張SMTPメソッドの一覧を返します。

Exwarpを使ってメールを送信するプログラムを紹介します。

SMTPプロトコルでのメール送信には、Exwarp.Net.Smtp.SmtpClientを使用します。

HOST_NAME はホスト名を表す文字列です。

exwarpでメールを送信するためには、Exwarp.Net.Smtp.SmtpClientを使用します。

送信したいメールはExwarp.Net.Mail.MailMessageがカプセル化します。

まず、MailMessageインスタンスを初期化します。コンストラクタは、メールメッセージに適用される文字セットを指定します。日本語で広く使われるのはiso-2022-jpという文字セットです。System.Text.EncodingオブジェクトのGetEncoding()メソッドを使用して文字セット設定します。

MailMessageに登録されているAddToカスタムオペレーションを実行します。これはToヘッダーフィールドに指定された表示名とアドレスで構成される送信先情報を追加するカスタムオペレーションです。表示名が必要ない場合、nullを指定できます。

Subjectプロパティに件名を設定します。任意の文字列が使用できますが改行は含められません。Subjectヘッダーの内容は自動的にMIMEエンコードされます。

Fromプロパティに送信者を指定します。プロパティに直接文字列を指定する方法とAddMailBoxカスタムオペレーションを使用する方法があります。カスタムオペレーションを使用した場合

次にメールメッセージボディ（本文）を設定します。MailMessageのBodyプロパティに文字列を代入するだけで本文を更新できます。メッセージボディの内容はコンストラクタで設定した文字セットで自動的にエンコードされます。

メールの送信にはExwarp.Net.Smtp.SmtpClientを使います。コンストラクタにはSMTPサーバーのホスト名を表す文字列を設定します。

Connect()メソッドでホストに接続します。

SendReceive()メソッドでメールを実際にホストに送信します。パラメータにはメールメッセージをカプセル化するMailMessageのインスタンス（この場合mail）をセットします。

SendReceive()メソッドは実際には、SendMessageカスタムオペレーションのラッパーですからカスタムオペレーションを直接呼び出してメールを送信することもできます。その場合

最後にClose()メソッドで接続を切断します。