Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse

Sie können angeben, mit welchen Elementen von Microsoft Office Outlook ein Formularbereich angezeigt wird, indem Sie den Formularbereich der Nachrichtenklasse jedes Elements zuordnen.Wenn Sie beispielsweise einen Formularbereich an den unteren Rand eines E-Mail-Elements anhängen möchten, kann der Formularbereich der IPM.Note-Nachrichtenklasse zugeordnet werden.

Soll ein Formularbereich einer Nachrichtenklasse zugeordnet werden, geben Sie den Namen der Nachrichtenklasse im Assistenten Neuer Outlook-Formularbereich an, oder übernehmen Sie ein Attribut für die Factoryklasse des Formularbereichs.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für Outlook 2013 und Outlook 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Grundlegendes zu den Outlook-Nachrichtenklassen

Eine Outlook-Nachrichtenklasse kennzeichnet ein Outlook-Element.In der folgenden Tabelle sind die acht Standardtypen der Elemente und deren Nachrichtenklassennamen aufgeführt.

Sie können auch die Namen von benutzerdefinierten Nachrichtenklassen angeben.Durch benutzerdefinierte Nachrichtenklassen werden in Outlook definierte benutzerdefinierte Formulare identifiziert.

Hinweis

Bei den Formularbereichen Ersetzung und Alle ersetzen kann ein neuer benutzerdefinierter Nachrichtenklassenname angegeben werden.Die Verwendung des Nachrichtenklassennamens eines vorhandenen benutzerdefinierten Formulars ist nicht erforderlich.Der Name der benutzerdefinierten Nachrichtenklasse muss eindeutig sein.Eine Methode zur Sicherstellung der Eindeutigkeit des Namens besteht in der Verwendung einer Namenskonvention, die ungefähr der folgenden Konvention entspricht: <Standard-Nachrichtenklassenname>.<Unternehmen>.<Nachrichtenklassenname> (beispielsweise: IPM.Note.Contoso.MyMessageClass).

Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse

Für die Zuordnung eines Formularbereichs zu einer Nachrichtenklasse stehen zwei Methoden zur Verfügung:

• Verwenden des Assistenten Neuer Outlook-Formularbereich.

• Übernehmen von Klassenattributen

Verwenden des Assistenten Neuer Outlook-Formularbereich

Auf der letzten Seite des Assistenten Neuer Outlook-Formularbereich können standardmäßige Nachrichtenklassen ausgewählt und die Namen von benutzerdefinierten Nachrichtenklassen eingegeben werden, die dem Formularbereich zugeordnet werden sollen.

Die standardmäßigen Nachrichtenklassen sind nicht verfügbar, falls durch den Formularbereich das gesamte Formular oder die Standardseite eines Formulars ersetzt werden soll.Sie können standardmäßige Nachrichtenklassennamen nur für Formulare angeben, mit denen einem Formular eine neue Seite hinzugefügt wird oder die an den unteren Rand eines Formulars angefügt werden.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt.

Wenn Sie benutzerdefinierte Nachrichtenklassen einfügen möchten, geben Sie deren Namen in das Feld Welche benutzerdefinierten Meldungsklassen sollen in diesem Formularbereich angezeigt werden? ein.

Die eingegebenen Namen müssen den folgenden Richtlinien entsprechen:

• Der vollqualifizierte Nachrichtenklassenname muss verwendet werden (beispielsweise: "IPM.Note.Contoso").

• Zum Trennen der Nachrichtenklassennamen müssen Semikola verwendet werden.

• Standardmäßige Outlook-Nachrichtenklassen wie "IPM.Note" oder "IPM.Contact" dürfen nicht einbezogen werden.Es dürfen nur benutzerdefinierte Nachrichtenklassen wie "IPM.Note.Contoso" einbezogen werden.

• Die Basisnachrichtenklasse darf nicht allein angegeben werden (beispielsweise: "IPM").

• Die Länge jedes Nachrichtenklassennamens darf 256 Zeichen nicht überschreiten.

Der Assistent Neuer Outlook-Formularbereich prüft beim Klicken auf Fertig stellen das Format der Eingabe.

Hinweis
Der Assistent Neuer Outlook-Formularbereich überprüft nicht, ob die bereitgestellten Nachrichtenklassennamen korrekt oder gültig sind.

Bei Fertigstellung des Assistenten übernimmt der Assistent Neuer Outlook-Formularbereich Attribute für die Formularbereichsklasse, die die angegebenen Nachrichtenklassennamen beinhalten.Diese Attribute können auch manuell übernommen werden.

Übernehmen von Klassenattributen

Nach der Fertigstellung des Assistenten Neuer Outlook-Formularbereich kann ein Formularbereich einer Outlook-Nachrichtenklasse zugeordnet werden.Übernehmen Sie dazu Attribute für die Factoryklasse des Formularbereichs.

Im folgenden Beispiel werden zwei FormRegionMessageClassAttribute-Attribute gezeigt, die für die Factoryklasse eines Formularbereichs mit der Bezeichnung myFormRegion übernommen wurden.Mit dem ersten Attribut wird der Formularbereich einer Standardnachrichtenklasse für ein E-Mail-Nachrichtenformular zugeordnet.Mit dem zweiten Attribut wird der Formularbereich einer benutzerdefinierten Nachrichtenklasse mit der Bezeichnung IPM.Task.Contoso zugeordnet.

<Microsoft.Office.Tools.Outlook.FormRegionMessageClass(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass("IPM.Task.Contoso")> _
<Microsoft.Office.Tools.Outlook.FormRegionName("Trin_Outlook_FR_Attributes.FormRegion1")> _
Partial Public Class FormRegion1Factory

' Occurs before the form region is initialized.
' To prevent the form region from appearing, set e.Cancel to true.
' Use e.OutlookItem to get a reference to the current Outlook item.
    Private Sub FormRegion1Factory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

End Sub

[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    (Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)]
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    ("IPM.Task.Contoso")]
[Microsoft.Office.Tools.Outlook.FormRegionName
    ("Trin_Outlook_FR_Attributes.FormRegion1")]
public partial class FormRegion1Factory
{
    // Occurs before the form region is initialized.
    // To prevent the form region from appearing, set e.Cancel to true.
    // Use e.OutlookItem to get a reference to the current Outlook item.
    private void FormRegion1Factory_FormRegionInitializing(object sender, 
        Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
    {
    }
}

Attribute müssen den folgenden Richtlinien entsprechen:

• Verwenden Sie für benutzerdefinierte Nachrichtenklassen den vollqualifizierten Nachrichtenklassennamen (beispielsweise: "IPM.Note.Contoso").

• Die Basisnachrichtenklasse darf nicht allein angegeben werden (beispielsweise: "IPM").

• Die Länge jedes Nachrichtenklassennamens darf 256 Zeichen nicht überschreiten.

• Schließen Sie die Namen der Standardnachrichtenklassen nicht ein, falls durch den Formularbereich das gesamte Formular oder die Standardseite eines Formulars ersetzt wird.Sie können standardmäßige Nachrichtenklassennamen nur für Formulare angeben, mit denen einem Formular eine neue Seite hinzugefügt wird oder die an den unteren Rand eines Formulars angefügt werden.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt.

Visual Studio prüft beim Erstellen des Projekts das Format der Nachrichtenklassennamen.

Hinweis
Visual Studio überprüft nicht, ob die angegebenen Nachrichtenklassennamen korrekt oder gültig sind.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Entwerfen eines Outlook-Formularbereichs

Referenz

Neben den Formularnamen und -Nachrichtenklasse

Wie sich Outlook bildet und Elemente arbeiten zusammen

Konzepte

Zugreifen auf einen Formularbereich zur Laufzeit

Richtlinien zum Erstellen von Outlook-Formularbereichen

Weitere Ressourcen

Erstellen von Outlook-Formularbereichen