Freigeben über

Erste Schritte mit einem Windows Server AppFabric-Cacheclient (XML)

  • Artikel

Windows Server AppFabric bietet die Möglichkeit, den Cacheclient programmgesteuert oder mithilfe einer Anwendungskonfigurationsdatei zu konfigurieren. Die Vorgehensweisen in diesem Thema beschreiben, wie ein Cacheclient für eine Anwendung mithilfe einer XML-basierten Anwendungskonfigurationsdatei konfiguriert wird. Informationen zur programmgesteuerten Konfiguration finden Sie unter Erste Schritte mit einem Windows Server AppFabric-Cacheclient.

Weitere Informationen zu den Anwendungskonfigurationseinstellungen finden Sie unter Anwendungskonfigurationseinstellungen (Windows Server AppFabric-Cache).

Für diese Vorgehensweise wird angenommen, dass die Entwicklungsumgebung bereits vorbereitet wurde, die Verweise auf die AppFabric-Cacheassemblys festgelegt wurden usw. Weitere Informationen finden Sie unter Vorbereiten der Cacheclient-Entwicklungsumgebung (Windows Server AppFabric-Cache).

So konfigurieren Sie einen Cacheclient mithilfe einer Anwendungskonfigurationsdatei

  1. Wählen Sie in Visual Studio im Menü Projekt den Befehl Neues Element hinzufügen aus.

  2. Wählen Sie Anwendungskonfigurationsdatei aus, benennen Sie die Datei App.config, und klicken Sie dann auf Hinzufügen.

  3. Fügen Sie das XML-Beispiel im folgenden Abschnitt in die <configuration>-Tags der Datei App.config ein. Ihre Anwendung kann die Anwendungskonfigurationsdatei für andere Zwecke verwenden, achten Sie jedoch in jedem Fall darauf, dass das Element configSections immer das erste Element unter dem Tag configuration bleibt.

  4. Aktualisieren Sie host-Elemente für die Cachehosts, oder fügen Sie diese hinzu, je nach den Gegebenheiten Ihrer Umgebung. Für jeden Eintrag:

    • Verwenden Sie das name-Attribut, um den Computernamen des Cachehosts anzugeben.

    • Verwenden Sie das cachePort-Attribut, um die Cacheportnummer des Hosts anzugeben.

  5. Erstellen Sie im Code ein DataCacheFactory-Objekt unter Verwendung des Standardkonstrukts. Wenn keine Konfigurationsparameter an das DataCacheFactory-Objekt übergeben werden, verwendet die Anwendung die Konfigurationseinstellungen in der App.config-Datei.

  6. Verwenden Sie die GetCache-Methode zum Erstellen eines DataCache-Objekts, um mit der Verwendung eines Cacheclients zu beginnen.

Beispiel

Dieses Beispiel für eine Anwendungskonfigurationsdatei ist so konfiguriert, dass sie auf zwei Server, CacheServer1 und CacheServer2, verweist. Ersetzen Sie die Servernamen in diesem Beispiel durch die Namen Ihrer Cacheserver. Fügen Sie je nach den Anforderungen Ihrer Umgebung Hosttags hinzu, oder entfernen Sie sie.

Geben Sie idealerweise die Cachehosts an, die als führende Hosts festgelegt wurden. Als führende Hosts fungieren in der Regel die ersten Cacheserver, die im Cluster installiert wurden. Weitere Informationen zu führenden Hosts finden Sie unter Diagramm der physischen Windows Server AppFabric-Cachearchitektur.

Mit dem Windows PowerShell-Verwaltungstool können Sie festlegen, welche Hosts als führende Hosts fungieren sollen. Weitere Informationen zu Windows PowerShell finden Sie unter Verwenden von Windows PowerShell zum Verwalten von Windows Server AppFabric-Cachefeatures.

Hinweis

Möglicherweise fügt Visual Basic Ihrer Anwendungskonfigurationsdatei zunächst automatisch Elemente hinzu. Diese zusätzlichen Elemente werden von den Cachefeatures von AppFabric nicht benötigt und können gelöscht werden, wenn sie nicht für andere Anwendungsfunktionen erforderlich sind.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
   <configSections>
      <!-- required to read the <dataCacheClient> element -->
      <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
         allowLocation="true"
         allowDefinition="Everywhere"/>
   </configSections>

   <dataCacheClient>
      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Nach dem Festlegen der Cacheclient-Konfigurationseinstellungen in der Anwendungskonfigurationsdatei können Sie mit der Programmierung Ihrer cacheaktivierten Anwendung beginnen. In diesem Beispiel wird ein DataCacheFactory-Objekt mit dem Namen CacheFactory1 mithilfe des Standardkonstruktors erstellt. Da die Cacheclient-Konfigurationseinstellungen nicht an den ersten Parameter des DataCacheFactory-Konstruktors übergeben werden, wird der Cacheclient auf der Grundlage der in der Anwendungskonfigurationsdatei angegebenen Einstellungen konfiguriert.

Hinweis

Aus Leistungsgründen wird empfohlen, die Anzahl der DataCacheFactory-Objekte, die in einer cacheaktivierten Anwendung erstellt werden, möglichst gering zu halten. Speichern Sie das DataCacheFactory-Objekt in einer Variablen, die für alle Teile der Anwendung, die einen Cacheclient verwenden, zugänglich ist.

Im nächsten Schritt wird die GetCache-Methode verwendet, um ein DataCache-Objekt mit dem Namen myCache1 zu erstellen. Anschließend wird die Add-Methode aufgerufen, um dem Cache ein Objekt hinzuzufügen.

' Use configuration from the application configuration file.
Dim CacheFactory1 As DataCacheFactory = New DataCacheFactory()

' Get cache client for cache "NamedCache1".
Dim myCache1 As DataCache = CacheFactory1.GetCache("NamedCache1")

' Add an object to the cache.
myCache1.Add("helloKey", "hello world")

// Use configuration from the application configuration file.
DataCacheFactory CacheFactory1 = new DataCacheFactory();

// Get cache client for cache "NamedCache1".
DataCache myCache1 = CacheFactory1.GetCache("NamedCache1");

// Add an object to the cache.
myCache1.Add("helloKey", "hello world");

Siehe auch

Konzepte

Erste Schritte mit einem Windows Server AppFabric-Cacheclient (XML)
Aktivieren des lokalen Caches in Windows Server AppFabric (XML)
Konfigurieren eines ASP.NET-Sitzungsstatusanbieters (Windows Server AppFabric-Cache)
Cacheclients und lokaler Cache (Windows Server AppFabric-Cache)
Verwenden von Konfigurationsmethoden (Windows Server AppFabric-Cache)
Windows Server AppFabric-Cachekonzepte
Entwickeln eines Cacheclients (Windows Server AppFabric-Cache)

  2011-12-05