AggregateCacheDependency Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Combina varias dependencias entre un elemento almacenado en el objeto de Cache una aplicación de ASP.NET y una matriz de CacheDependency objetos. Esta clase no puede heredarse.
public ref class AggregateCacheDependency sealed : System::Web::Caching::CacheDependency
public sealed class AggregateCacheDependency : System.Web.Caching.CacheDependency
type AggregateCacheDependency = class
inherit CacheDependency
Public NotInheritable Class AggregateCacheDependency
Inherits CacheDependency
- Herencia
Ejemplos
En el ejemplo de código siguiente se usa la AggregateCacheDependency clase para agregar un DataSet, denominado XMLDataSet, a la memoria caché que depende de un archivo de texto y de un archivo XML.
' When the page is loaded, use the
' AggregateCacheDependency class to make
' a cached item dependent on two files.
Sub Page_Load(sender As Object, e As EventArgs)
Dim Source As DataView
Source = Cache("XMLDataSet")
If Source Is Nothing
Dim DS As New DataSet
Dim FS As FileStream
Dim Reader As StreamReader
Dim txtDep As CacheDependency
Dim xmlDep As CacheDependency
Dim aggDep As AggregateCacheDependency
FS = New FileStream(Server.MapPath("authors.xml"),FileMode.Open,FileAccess.Read)
Reader = New StreamReader(FS)
DS.ReadXml(Reader)
FS.Close()
Source = new DataView(ds.Tables(0))
' Create two CacheDependency objects, one to a
' text file and the other to an XML file.
' Create a CacheDependency array with these
' two objects as items in the array.
txtDep = New CacheDependency(Server.MapPath("Storage.txt"))
xmlDep = New CacheDependency(Server.MapPath("authors.xml"))
Dim DepArray() As CacheDependency = {txtDep, xmlDep}
' Create an AggregateCacheDependency object and
' use the Add method to add the array to it.
aggDep = New AggregateCacheDependency()
aggDep.Add(DepArray)
' Call the GetUniqueId method to generate
' an ID for each dependency in the array.
msg1.Text = aggDep.GetUniqueId()
' Add the new data set to the cache with
' dependencies on both files in the array.
Cache.Insert("XMLDataSet", Source, aggDep)
If aggDep.HasChanged = True Then
chngMsg.Text = "The dependency changed at: " & DateTime.Now
Else
chngMsg.Text = "The dependency changed last at: " & aggDep.UtcLastModified.ToString()
End If
cacheMsg1.Text = "Dataset created explicitly"
Else
cacheMsg1.Text = "Dataset retrieved from cache"
End If
MyLiteral.Text = Source.Table.TableName
MyDataGrid.DataSource = Source
MyDataGrid.DataBind()
End Sub
Public Sub btn_Click(sender As Object, e As EventArgs )
If (MyTextBox.Text = String.Empty) Then
msg2.Text ="You have not changed the text file."
Else
msg2.Text="You added " & MyTextBox.Text & "."
' Create an instance of the StreamWriter class
' to write text to a file.
Dim sw As StreamWriter
sw = File.CreateText(Server.MapPath("Storage.txt"))
' Add some text to the file.
sw.Write("You entered:")
sw.WriteLine(MyTextBox.Text)
' Write arbitrary objects to the file as needed.
sw.Write("Text added at:")
sw.WriteLine(DateTime.Now)
sw.WriteLine("-------------------")
sw.Close()
End If
End Sub
Comentarios
La AggregateCacheDependency clase supervisa una colección de objetos de dependencia para que cuando cambie alguno de ellos, el elemento almacenado en caché se quita automáticamente. Los objetos de la matriz pueden ser CacheDependency objetos, SqlCacheDependency objetos, objetos personalizados derivados de CacheDependencyo cualquier combinación de estos objetos.
La AggregateCacheDependency clase difiere de la CacheDependency clase en que permite asociar varias dependencias de distintos tipos con un solo elemento almacenado en caché. Por ejemplo, si crea una página que importa datos de una tabla de base de datos de SQL Server y un archivo XML, puede crear un objeto SqlCacheDependency para representar una dependencia de la tabla de base de datos y un CacheDependency para representar la dependencia en el archivo XML. En lugar de realizar una Cache.Insert llamada de método para cada dependencia, puede crear una instancia de la AggregateCacheDependency clase con cada dependencia agregada. A continuación, puede usar una sola Insert llamada para hacer que la página dependa de la AggregateCacheDependency instancia.
Constructores
| Nombre | Description |
|---|---|
| AggregateCacheDependency() |
Inicializa una nueva instancia de la clase AggregateCacheDependency. |
Propiedades
| Nombre | Description |
|---|---|
| HasChanged |
Obtiene un valor que indica si el CacheDependency objeto ha cambiado. (Heredado de CacheDependency) |
| UtcLastModified |
Obtiene la hora en que se cambió por última vez la dependencia. (Heredado de CacheDependency) |
Métodos
| Nombre | Description |
|---|---|
| Add(CacheDependency[]) |
Agrega una matriz de CacheDependency objetos al AggregateCacheDependency objeto . |
| DependencyDispose() |
Libera los recursos usados por la CacheDependency clase y las clases que derivan de CacheDependency. (Heredado de CacheDependency) |
| Dispose() |
Libera los recursos utilizados por el CacheDependency objeto . (Heredado de CacheDependency) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| FinishInit() |
Completa la inicialización del CacheDependency objeto . (Heredado de CacheDependency) |
| GetFileDependencies() |
Obtiene las dependencias de archivo. |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetUniqueID() |
Recupera un identificador único para el AggregateCacheDependency objeto . |
| ItemRemoved() |
Se llama cuando se quita una entrada de caché supervisada. (Heredado de CacheDependency) |
| KeepDependenciesAlive() |
Actualiza la hora de último acceso de cada elemento de caché que depende de este elemento. (Heredado de CacheDependency) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| NotifyDependencyChanged(Object, EventArgs) |
Notifica al objeto base CacheDependency que ha cambiado la dependencia representada por una clase derivada CacheDependency . (Heredado de CacheDependency) |
| SetCacheDependencyChanged(Action<Object,EventArgs>) |
Agrega un método Action para controlar las notificaciones a los interesados en los cambios en esta dependencia. (Heredado de CacheDependency) |
| SetUtcLastModified(DateTime) |
Marca la hora en que una dependencia cambió por última vez. (Heredado de CacheDependency) |
| TakeOwnership() |
Permite al primer usuario declarar la propiedad exclusiva de esta dependencia. (Heredado de CacheDependency) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |