SendMail カスタム アクティビティ

SendMail サンプルでは、ワークフロー アプリケーション内で使用するために SMTP を使用してメールを送信するAsyncCodeActivityから派生するカスタム アクティビティを作成する方法を示します。 カスタム アクティビティでは、 SmtpClient の機能を使用して、電子メールを非同期的に送信し、認証を使用してメールを送信します。 また、テスト モード、トークン置換、ファイル テンプレート、テスト ドロップ パスなど、いくつかのエンドユーザー機能も提供します。

次の表では、 SendMail アクティビティの引数について詳しく説明します。

ソリューションの内容

ソリューションには 2 つのプロジェクトが含まれています。

SendMail アクティビティの追加の構成

サンプルには示されていませんが、ユーザーは SendMail アクティビティの追加構成を実行できます。 次の 3 つのセクションでは、これを行う方法を示します。

本文で指定されたトークンを使用して電子メールを送信する

このコード スニペットは、本文にトークンを含む電子メールを送信する方法を示しています。 body プロパティでトークンがどのように提供されるかに注目してください。 これらのトークンの値は、tokens プロパティに提供されます。

IDictionary<string, string> tokens = new Dictionary<string, string>();
tokens.Add("@name", "John Doe");
tokens.Add("@date", DateTime.Now.ToString());
tokens.Add("@server", "localhost");

new SendMail
{
    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
    To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
    Subject = "Test email",
    Body = "Hello @name. This is a test email sent from @server. Current date is @date",
    Host = "localhost",
    Port = 25,
    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens)
};

テンプレートを使用して電子メールを送信する

このスニペットは、本文のテンプレート トークンを使用して電子メールを送信する方法を示しています。 BodyTemplateFilePath プロパティを設定するときに、Body プロパティの値を指定する必要はありません (テンプレート ファイルの内容が本文にコピーされます)。

new SendMail
{
    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
    To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
    Subject = "Test email",
    Host = "localhost",
    Port = 25,
    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),
    BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",
};

テスト モードでのメールの送信

このコード スニペットは、2 つのテスト プロパティを設定する方法を示しています。すべてのメッセージに TestMailTo を設定すると、(To、Cc、Bcc の値に関係なく) john.doe@contoso.con に送信されます。 TestDropPath を設定すると、すべての送信メールも指定されたパスに記録されます。 これらのプロパティは個別に設定できます (関連はありません)。

new SendMail
{
   From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
   To = new LambdaValue<MailAddressCollection>(
                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),
   Subject = "Test email",
   Host = "localhost",
   Port = 25,
   Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),
   BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",
   TestMailTo= new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),
   TestDropPath = @"c:\Samples\SendMail\TestDropPath\",
};

セットアップ手順

このサンプルでは、SMTP サーバーへのアクセスが必要です。

SMTP サーバーの設定の詳細については、次のリンクを参照してください。

• SMTP サービスの構成 (IIS 6.0)

• IIS 7.0: SMTP 電子メールを構成する

• SMTP サービスをインストールする方法

サード パーティが提供する SMTP エミュレーターをダウンロードできます。

このサンプルを実行するには

1. Visual Studio を使用して、SendMail.sln ソリューション ファイルを開きます。

2. 有効な SMTP サーバーにアクセスできることを確認します。 セットアップ手順を参照してください。

3. サーバー アドレスと From および To メール アドレスを使用してプログラムを構成します。

   このサンプルを正しく実行するには、Program.csと Sequence.xaml で、From と To の電子メール アドレスと SMTP サーバーのアドレスの値を構成する必要がある場合があります。 プログラムが 2 つの異なる方法でメールを送信するため、両方の場所のアドレスを変更する必要があります

4. ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。

5. ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。