Benutzerdefinierte SendMail-Aktivität

Das SendMail-Beispiel veranschaulicht, wie eine benutzerdefinierte Aktivität erstellt wird, die von der Übermittlung von E-Mails mithilfe von AsyncCodeActivity SMTP für die Verwendung in einer Workflowanwendung abgeleitet wird. Die benutzerdefinierte Aktivität verwendet die Funktionen von SmtpClient zum asynchronen Senden von E-Mails und zum Senden von E-Mails mit Authentifizierung. Außerdem werden Endbenutzerfunktionen wie Testmodus, Tokenersetzung, Dateivorlagen und Testablagepfad bereitgestellt.

In der folgenden Tabelle werden die Argumente für die SendMail Aktivität beschrieben.

Lösungsinhalte

Die Lösung enthält zwei Projekte.

Weitere Konfiguration der SendMail-Aktivität

Obwohl im Beispiel nicht gezeigt, können Benutzer die Zusatzkonfiguration der SendMail-Aktivität ausführen. In den nächsten drei Abschnitten wird gezeigt, wie dies geschieht.

Senden einer E-Mail mithilfe von im Text angegebenen Token

Dieser Codeausschnitt veranschaulicht, wie Sie E-Mails mit Token im Textkörper senden können. Die Token werden in der body-Eigenschaft bereitgestellt. Die Werte für die Token werden in der Tokeneigenschaft bereitgestellt.

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)
};

Senden einer E-Mail mithilfe einer Vorlage

Mit diesem Codeausschnitt wird veranschaulicht, wie Sie eine E-Mail-Nachricht mit Vorlagentoken im Text senden können. Beachten Sie, dass beim Festlegen der BodyTemplateFilePath-Eigenschaft kein Wert für die Text-Eigenschaft angegeben werden muss (der Inhalt der Vorlagendatei wird in den Text kopiert).

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",
};

Senden von E-Mails im Testmodus

Mit diesem Codeausschnitt wird das Festlegen der beiden Testeigenschaften veranschaulicht: Durch Festlegen von TestMailTo für alle Nachrichten werden diese (ohne Beachtung der Werte von To, Cc und Bcc) an john.doe@contoso.con gesendet. Durch Festlegen von TestDropPath werden alle ausgehenden E-Mails auch im angegebenen Pfad aufgezeichnet. Diese Eigenschaften können unabhängig voneinander festgelegt werden (sie sind nicht verknüpft).

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\",
};

Setupanweisungen

Für dieses Beispiel ist der Zugriff auf einen SMTP-Server erforderlich.

Weitere Informationen zum Einrichten eines SMTP-Servers finden Sie unter den folgenden Links.

• Konfigurieren des SMTP-Diensts (IIS 6.0)

• IIS 7.0: Konfigurieren von SMTP-E-Mail

• So installieren Sie den SMTP-Dienst

SMTP-Emulatoren, die von Drittanbietern bereitgestellt werden, stehen zum Download zur Verfügung.

So führen Sie dieses Beispiel aus

1. Öffnen Sie mit Visual Studio die SendMail.sln Projektmappendatei.

2. Stellen Sie sicher, dass Sie Zugriff auf einen gültigen SMTP-Server haben. Weitere Informationen finden Sie in den Einrichtungsanweisungen.

3. Konfigurieren Sie das Programm mit Ihrer Serveradresse sowie den Absender- und Empfänger-E-Mail-Adressen.

   Um dieses Beispiel ordnungsgemäß auszuführen, müssen Sie möglicherweise den Wert von von und zu E-Mail-Adressen und die Adresse des SMTP-Servers in Program.cs und in Sequence.xaml konfigurieren. Sie müssen die Adresse an beiden Speicherorten ändern, da das Programm E-Mails auf zwei verschiedene Arten sendet.

4. Drücken Sie STRG+UMSCHALT+B, um die Solution zu erstellen.

5. Drücken Sie STRG+F5, um die Lösung auszuführen.