Codeausschnitt: Aktualisieren von Eigenschaften eines BCS-Cacheabonnements

Artikel
09/18/2014

Letzte Änderung: Montag, 7. Juni 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Beschreibung
Voraussetzungen
So verwenden Sie dieses Beispiel

Beschreibung

Im folgenden Beispiel wird gezeigt, wie Sie die Eigenschaften eines Cacheabonnements sowie von Abfragen und Zuordnungsabonnements auf dem Client aktualisieren.

Voraussetzungen

Installation von Microsoft SharePoint Server 2010 oder Microsoft SharePoint Foundation 2010 auf dem Server
Installation von Microsoft Office Professional Plus 2010 und Microsoft .NET Framework 3.5 auf dem Clientcomputer
Microsoft Visual Studio
Mindestens ein Abonnement im Clientcache von Business-Konnektivitätsdienste (Business Connectivity Services)

So verwenden Sie dieses Beispiel

Starten Sie Visual Studio auf dem Clientcomputer, und erstellen Sie dann ein neues C#-Microsoft Office-Anwendungs-Add-In-Projekt. Wählen Sie beim Erstellen des Projekts .NET Framework 3.5 aus.
Wählen Sie im Menü Ansicht den Befehl Eigenschaftenseiten aus, um die Projekteigenschaften aufzurufen.
Wählen Sie auf der Registerkarte Build unter Zielplattform die Option Beliebige CPU aus.
Schließen Sie das Fenster mit den Projekteigenschaften.
Entfernen Sie im Projektmappen-Explorer unter Verweise sämtliche Projektverweise bis auf System und System.Core.
Fügen Sie dem Projekt die folgenden Verweise hinzu:
1. Microsoft.Office.BusinessApplications.Runtime
2. Microsoft.BusinessData
3. Die Interopassemblys für die Office-Anwendung

Ersetzen Sie die vorhandenen using-Anweisungen durch folgende Anweisungen:

using System;
using Microsoft.BusinessData.Offlining;
using Microsoft.Office.BusinessData.Offlining;

Ersetzen Sie den Code im Startereignis des Add-Ins durch den Code am Ende dieses Verfahrens.
Ersetzen Sie die Platzhalterwerte von <entityNamespace>, <entityName>, <viewName> und <subscriptionName> durch gültige Werte.
Speichern Sie das Projekt.
Kompilieren Sie das Projekt, und führen Sie es aus.

Dadurch wird die Office-Anwendung geöffnet, und die vom Code ausgegebenen Meldungen werden angezeigt.

RemoteOfflineRuntime remoteOfflineRuntime = new RemoteOfflineRuntime();

// Read the subscription.
ISubscription sub = 
    remoteOfflineRuntime.GetSubscriptionManager().GetSubscription(
    "<entityNamespace>", "<entityName>", "<viewName>", "<subscriptionName>");

// Updating the Subscription Refresh Interval.
sub.ExpireAfter = new TimeSpan(0, 30, 0);
sub.Update();

// Enumerate through the queries of the subscription, change their refresh
// interval, and enable them.
// If the properties are going to be changed for a particular query, we 
// could check the name of the subscription query to determine whether 
// the properties are to be changed.
foreach (ISubscriptionQuery query in sub.Queries)
{
    // If the subscription query is disabled, enable it.
    if (query.Enabled == false)
    {
        query.Enabled = true;
    }
    // Set the refresh interval of the query.
    query.ExpireAfter = TimeSpan.FromMinutes(10);
    // Update the properties of the subscription query.
    query.Update();
}

// Enumerate through the Associations of the subscription, change 
// their refresh interval, and enable them.
// If the properties are going to be changed for a particular Association
// we could check the name of the subscription Association to determine
// whether the properties are to be changed.
foreach (ISubscriptionAssociation association in sub.Associations)
{
    // If the subscription association is disabled, enable it.
    if (association.Enabled == false)
    {
        association.Enabled = true;
    }
    // Set the refresh interval of the association.
    association.ExpireAfter = TimeSpan.FromMinutes(10);
    // Update the properties of the subscription association.
    association.Update();
}