Freigeben über


Schritt 4: Implementieren der erweiterten codebasierten Outlook-Lösung

Letzte Änderung: Dienstag, 6. Juli 2010

Gilt für: SharePoint Server 2010

In den folgenden Schritten wird gezeigt, wie Sie eine erweiterte codebasierte Microsoft Outlook-Lösung erstellen, in der Microsoft Business Connectivity Services (BCS) verwendet wird.

Voraussetzungen

  1. Schritt 1: Erstellen des BDC-Modells

  2. Schritt 2: Erstellen eines Cacheabonnements

  3. Schritt 3: Erstellen des Lösungsmanifests

So erstellen Sie das Outlook-Add-In-Projekt

  1. Erstellen Sie in Microsoft Visual Studio 2010 ein C#-Outlook 2010-Add-In-Projekt:

    1. Klicken Sie in Visual Studio 2010 auf Datei, auf Neu und dann auf Projekt.

    2. Erweitern Sie im Dialogfeld Neues Projekt im Bereich Installierte Vorlagen den Eintrag Visual C#, erweitern Sie Office, und wählen Sie dann 2010 aus.

    3. Wählen Sie in der Dropdownliste auf der obersten Leiste im mittleren Bereich den Eintrag .NET Framework 3.5 aus.

    4. Wählen Sie im mittleren Bereich den Eintrag Outlook 2010-Add-In aus.

    5. Der Standardprojektname lautet OutlookAddIn1. Geben Sie einen Namen für das Projekt an, wenn Sie einen anderen Namen verwenden möchten.

      Sie können die Standardwerte für den Speicherort und den Projektmappennamen beibehalten oder die Standardwerte ändern, wenn Sie andere Werte verwenden möchten.

    6. Klicken Sie auf OK, um das Projekt zu erstellen.

  2. Führen Sie die folgenden Schritte aus, um die folgenden Verweise hinzuzufügen:

    • Microsoft.BusinessData

    • Microsoft.Office.BusinessApplications.Runtime

    1. Suchen Sie im Projektmappen-Explorer unter dem Projekt den Knoten Verweise, klicken Sie mit der rechten Maustaste auf diesen Knoten, und wählen Sie dann Verweis hinzufügen aus.

    2. Klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte Durchsuchen, und wechseln Sie dann zur gewünschten Assembly im Office-Installationsordner (normalerweise %ProgramFiles%\Microsoft Office\Office14\).

    3. Doppelklicken Sie auf die Assembly, um diese hinzuzufügen.

    4. Wiederholen Sie diesen Vorgang für jede Assembly.

  3. Fügen Sie die folgenden using-Direktiven am Anfang von ThisAddIn.cs hinzu.

    using BCSRuntime = Microsoft.Office.BusinessApplications.Runtime;
    using System.IO;
    
  4. Fügen Sie die folgende Codezeile am Anfang der ThisAddIn-Klasse hinzu, um die globale Variable für RuntimeClass zu deklarieren.

    public static BCSRuntime.RuntimeClass newRuntime = null;
    
  5. Fügen Sie im Textkörper der ThisAddIn_StartUp-Methode den folgenden Code hinzu.

    Die solutionOIRNamePath-Variable zeigt auf den Zielordner für die Lösungsbereitstellung, der alle anderen Lösungsartefakte (das BDC-Modell und die Cacheabonnements) enthält.

    string solutionOIRNamePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "oir.config");
    newRuntime = new BCSRuntime.RuntimeClass();
    newRuntime.Register(soltionOIRNamePath, new NewRuntimeCallback(), this.Application);
    
  6. Fügen Sie im Textkörper der ThisAddIn_Shutdown-Methode den folgenden Code hinzu.

    newRuntime.Unregister();
    
  7. Fügen Sie eine neue Klasse mit dem Namen ContosoSalesManagerRuntimeCallback hinzu:

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, wählen Sie Hinzufügen und dann Klasse aus.

    2. Geben Sie in das Dialogfeld Neues Element hinzufügen den Klassennamen ContosoSalesManagerRuntimeCallback.cs ein, und klicken Sie dann auf Hinzufügen.

  8. Fügen Sie in ContosoSalesManagerRuntimeCallback.cs am Anfang der Datei die folgenden using-Direktiven hinzu.

    using BCSRuntime = Microsoft.Office.BusinessApplications.Runtime;
    using System.Windows.Forms;
    
  9. Fügen Sie : BCSRuntime.IRuntimeCallback am Ende von class ContosoSalesManagerRuntimeCallback an.

    Dadurch wird sichergestellt, dass die Klasse von der IRuntimeCallback-Schnittstelle erbt.

  10. Fügen Sie im Textkörper der ContosoSalesManagerRuntimeCallback-Klasse den folgenden Code hinzu.

    public ContosoSalesManagerRuntimeCallback()
    {
    }
    
    public void RegistrationComplete(string solutionID, bool success)
    {
        if (null != solutionID && success)
        {
            // Solution registration succeeded.
            // To Do: Trigger any custom events.
            // Example: MessageBox.Show("Solution registration succeeded for solution ID: {0}", solutionID);
        }
        else
        {
            // Solution registration failed.                
            // Example: MessageBox.Show("Solution registration failed for solution ID: {0}", solutionID);                
        }
    }
    
  11. Erstellen Sie die Lösung.

    Dabei wird die Assemblydatei der Lösung (beispielsweise OutlookAddIn1.dll im Ordner bin\debug erstellt, wenn Sie die Debugkonfiguration verwenden).

  12. Zu diesem Zeitpunkt haben Sie die Basisvorlage für eine erweiterte codebasierte -Lösung. Sie können der Lösung eigenen Code hinzufügen, um Anpassungen wie beispielsweise benutzerdefinierte Menübänder, Aufgabenbereiche oder andere Anpassungen der Benutzeroberfläche zu erstellen.

Weitere Schritte

Schritt 5: Packen und Bereitstellen der erweiterten codebasierten Outlook-Lösung