Methodeneinfügung
Einfügen(String, Objekt)
Fügt ein Element (Objekt) in den Cache ein.
Erklärung
CacheItemVersion Insert(string key, object value)
Parameter
Typ | Name und Vorname | Beschreibung |
---|---|---|
System.String | Schlüssel | Eindeutiger Schlüssel zur Identifizierung des Cache-Elements. |
System.Objekt | Wert | Das Element (Objekt), das in den Cache eingefügt werden soll. |
Rücksendungen
Typ | Beschreibung |
---|---|
CacheItemVersion | Stellt die Version jedes Cache-Elements dar. |
Bemerkungen
Wenn der Schlüssel bereits vorhanden ist, überschreibt diese Überladung die Werte des vorhandenen Schlüssels ICache Artikel. Wenn der Schlüssel nicht vorhanden ist, wird das Element dem Cache hinzugefügt.
Beispiele
Das folgende Beispiel zeigt, wie ein Element (Objekt) in den Cache eingefügt wird.
Cache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
string key = "Product0";
cache.Insert(key,product);
Einfügen(String, CacheItem, LockHandle, Boolean)
Fügt ein CacheItem in den Cache.
Erklärung
CacheItemVersion Insert(string key, CacheItem item, LockHandle lockHandle, bool releaseLock)
Parameter
Typ | Name und Vorname | Beschreibung |
---|---|---|
System.String | Schlüssel | Eindeutiger Schlüssel zur Identifizierung des Cache-Elements. |
CacheItem | Artikel | Das CacheItem, das in den Cache eingefügt werden soll. |
LockHandle | lockHandle | Eine Instanz von LockHandle die die Sperrinformationen enthält. Wenn das Element gesperrt ist, kann es nur aktualisiert werden, wenn das richtige lockHandle angegeben ist. |
System.Boolean | releaseLock | Ein Flag, um zu bestimmen, ob die Sperre aufgehoben werden soll, nachdem der Vorgang ausgeführt wurde. |
Rücksendungen
Typ | Beschreibung |
---|---|
CacheItemVersion | Stellt die Version jedes Cache-Elements dar. |
Bemerkungen
Wenn der Schlüssel bereits vorhanden ist, überschreibt diese Überladung die Werte des vorhandenen Schlüssels ICache Artikel. Wenn der Schlüssel nicht vorhanden ist, wird das Element dem Cache hinzugefügt. Wenn CacheItem ungültige Werte enthält, wird die entsprechende Ausnahme ausgelöst. Sehen CacheItem für ungültige Eigenschaftswerte und zugehörige Ausnahmen.
Beispiele
Das folgende Beispiel zeigt, wie ein Element mit einem gleitenden Ablauf von 5 Minuten und einer Priorität von in den Cache eingefügt wird hoch.
ICache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
CacheItem item = new CacheItem(product);
item.Priority = CacheItemPriority.Low;
string key = "Product0";
cache.Add(key, item);
LockHandle lockHandle = new LockHandle();
CacheItem cachedItem = cache.Get<CacheItem>("cachedItemKey", true, new TimeSpan(0, 5, 0), ref lockHandle);
if (cachedItem != null)
{
try
{
cachedItem.Priority = CacheItemPriority.High;
cachedItem.Expiration = new Expiration(ExpirationType.Sliding, new TimeSpan(0, 2, 0));
cache.Insert(key, cachedItem, lockHandle, true);
}
catch (OperationFailedException ex)
{
...
}
}
Insert(String, CacheItem, WriteThruOptions, LockHandle, Boolesch)
Fügt ein CacheItem in den Cache, zusammen mit der Möglichkeit, die WriteThruOptions anzugeben.
Erklärung
CacheItemVersion Insert(string key, CacheItem item, WriteThruOptions writeThruOptions = null, LockHandle lockHandle = null, bool releaseLock = false)
Parameter
Typ | Name und Vorname | Beschreibung |
---|---|---|
System.String | Schlüssel | Eindeutiger Schlüssel zur Identifizierung des CacheItem. |
CacheItem | Artikel | Das CacheItem, das in den Cache eingefügt werden soll. |
WriteThruOptions | WriteThruOptions | WriteThruOptions bezüglich der Aktualisierung der Datenquelle. Dies kann entweder „WriteThru“, „WriteBehind“ oder „Keine“ sein. |
LockHandle | lockHandle | Eine Instanz von LockHandle die die Sperrinformationen enthält. Wenn das Element gesperrt ist, kann es nur aktualisiert werden, wenn das richtige lockHandle angegeben ist. |
System.Boolean | releaseLock | Ein Flag, um zu bestimmen, ob die Sperre aufgehoben werden soll, nachdem der Vorgang ausgeführt wurde. |
Rücksendungen
Typ | Beschreibung |
---|---|
CacheItemVersion | Stellt die Version jedes Cache-Elements dar. |
Bemerkungen
Wenn der Schlüssel bereits vorhanden ist, überschreibt diese Überladung die Werte des vorhandenen Schlüssels ICache Artikel. Wenn der Schlüssel nicht vorhanden ist, wird das Element dem Cache hinzugefügt. Wenn CacheItem ungültige Werte enthält, wird die entsprechende Ausnahme ausgelöst. Die Funktionalität von Lockhandle mit WriteThru wird nicht unterstützt. Sehen CacheItem für ungültige Eigenschaftswerte und zugehörige Ausnahmen.
Beispiele
Das folgende Beispiel zeigt, wie ein Element mit einem gleitenden Ablauf von 5 Minuten und einer hohen Priorität in den Cache eingefügt wird.
ICache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
CacheItem item = new CacheItem(product);
item.Priority = CacheItemPriority.Low;
string key = "Product0";
cache.Add(key, item);
LockHandle lockHandle = new LockHandle();
CacheItem cachedItem = cache.Get<CacheItem>("cachedItemKey", true, new TimeSpan(0, 5, 0), ref lockHandle);
if (cachedItem != null)
{
try
{
cachedItem.Priority = CacheItemPriority.High;
cachedItem.Expiration = new Expiration(ExpirationType.Sliding, new TimeSpan(0, 2, 0));
WriteThruOptions writeThruOptions = new WriteThruOptions(WriteMode.WriteThru, "ProdDataSource1");
cache.Insert(key, cachedItem, writeThruOptions, lockHandle, true);
}
catch (OperationFailedException ex)
{
...
}
}