MailEnvelope Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine benutzerdefinierte E-Mail-Nachricht zum Senden des aktuellen Formulars als Anlage dar.

public ref class MailEnvelope abstract

public abstract class MailEnvelope

type MailEnvelope = class

Public MustInherit Class MailEnvelope

Vererbung: Object
MailEnvelope

Beispiele

Im folgenden Beispiel wird die EmailSubmitConnection -Eigenschaft der Window -Klasse verwendet, um einen Verweis auf das MailEnvelope-Objekt für das aktuelle Formular festzulegen. Die Available -Eigenschaft wird verwendet, um zu bestimmen, ob das Formular in Microsoft Office Outlook 2007 geöffnet wird. In diesem Fall gibt die Available-Eigenschaft false zurück, und der folgende Code wird nicht ausgeführt. Wenn die Available-Eigenschaft true zurückgibt, ist das Formular in InfoPath geöffnet, und die Anfangswerte für Adresse, Betreff und Einleitung werden angegeben. Anschließend wird die EmailAttachmentType -Eigenschaft der MailEnvelope-Klasse verwendet, um die Nachricht so zu konfigurieren, dass sie sowohl die Formulardaten als auch die Formularvorlage enthält. Schließlich wird die Visible-Eigenschaft der MailEnvelope-Klasse auf true festgelegt, um dem Benutzer die E-Mail-Nachrichtenfelder, die Symbolleiste "Senden" und den Aufgabenbereich "E-Mail-Optionen" zum Senden der E-Mail-Nachricht aus InfoPath anzuzeigen.

// Set a reference to MailEnvelope object.
MailEnvelope myEnvelope = this.Application.ActiveWindow.MailEnvelope;

// Check to see if form is open in Outlook.
if (myEnvelope.Available)
{
   // Specify addresses, subject, and introduction.
   myEnvelope.To = "someone@example.com";
   myEnvelope.CC = "someone@example.com";
   myEnvelope.BCC = "someone@example.com";
   myEnvelope.Subject = "Open this form";
   myEnvelope.Introduction = "InfoPath is required to edit this form.";

   // Include form template with form.
   myEnvelope.EmailAttachmentType = EmailAttachmentType.XmlXsn;

   // Display form with e-mail envelope.
   myEnvelope.Visible = true;
}
else
{
   // The form is open in Outlook, and code will not run.
   MessageBox.Show("This form is open in Outlook.");
}

' Set a reference to MailEnvelope object.
Dim myEnvelope As MailEnvelope  = _
   Me.Application.ActiveWindow.MailEnvelope

' Check to see if form is open in Outlook.
If (myEnvelope.Available) Then
   ' Specify addresses, subject, and introduction.
   myEnvelope.To = "someone@example.com"
   myEnvelope.CC = "someone@example.com"
   myEnvelope.BCC = "someone@example.com"
   myEnvelope.Subject = "Open this form"
   myEnvelope.Introduction = "InfoPath is required to edit this form."

   ' Include form template with form.
   myEnvelope.EmailAttachmentType = EmailAttachmentType.XmlXsn

   ' Display form with e-mail envelope.
   myEnvelope.Visible = True
Else
   ' The form is open in Outlook, and code will not run.
   MessageBox.Show("This form is open in Outlook.")
End If

Hinweise

Die MailEnvelope-Klasse stellt Eigenschaften bereit, die für die programmgesteuerte Erstellung einer benutzerdefinierten E-Mail-Nachricht zum Anfügen und Senden des zurzeit geöffneten InfoPath-Formulars verwendet werden können. Nachdem E-Mail-Adressen und andere Eigenschaften angegeben wurden, werden beim Festlegen der Visible Eigenschaft der MailEnvelope-Klasse auf true die E-Mail-Nachrichtenfelder, die Symbolleiste "Senden" und der Aufgabenbereich "E-Mail-Optionen" zusammen mit dem Formular angezeigt, sodass Benutzer die E-Mail-Nachricht überprüfen und vor dem Senden änderungen oder Ergänzungen vornehmen können. Das Schreiben von Code für die Arbeit mit einem MailEnvelope-Objekt entspricht der Verwendung des Befehls An E-Mail-Empfänger senden im Menü Datei beim Bearbeiten eines Formulars in InfoPath.

Hinweis: Die MailEnvelope-Klasse kann nicht zum Senden der von ihr erstellten E-Mail-Nachrichten verwendet werden. Benutzer müssen die E-Mail-Nachrichten manuell senden, indem sie in InfoPath auf die Schaltfläche Senden klicken.

Alternativ können Sie die ShowMailItem(String, String, String, String, String) -Methode der View -Klasse verwenden, um programmgesteuert eine E-Mail-Nachricht mit einem angefügten Formular zu erstellen. Wenn die Formularvorlage so konfiguriert wurde, dass sie als E-Mail-Nachricht gesendet wird, können Sie die Eigenschaften und Methoden der EmailSubmitConnection -Klasse verwenden, um das Formular programmgesteuert als E-Mail-Anlage zu erstellen und zu senden.

Konstruktoren

MailEnvelope()

Stellt eine benutzerdefinierte E-Mail-Nachricht zum Senden des aktuellen Formulars als Anlage dar.

Eigenschaften

Available	Ruft ab, ob die anderen Eigenschaften der MailEnvelope -Klasse für Code verfügbar sind, der im Formular ausgeführt wird.
Bcc	Ruft die Bcc-Adressen (Blind Carbon Copy, Blindkopie) der E-Mail-Nachricht ab oder legt sie fest.
CC	Ruft die Cc-Adressen der E-Mail-Nachricht ab oder legt sie fest.
EmailAttachmentType	Ruft den Dateityp ab, der an die E-Mail-Nachricht angefügt werden soll.
Introduction	Ruft die Einführung im Textkörper der E-Mail-Nachricht ab oder legt sie fest.
Subject	Ruft den Betreff der E-Mail-Nachricht ab oder legt ihn fest.
To	Ruft die Adressen der Empfänger der E-Mail-Nachricht ab oder legt diese fest.
Visible	Ruft die Sichtbarkeit der E-Mail-Nachrichtenfelder, der Symbolleiste Senden und des Aufgabenbereichs E-Mail-Optionen ab oder legt sie fest.

Gilt für:

Freigeben über