ObjectDataSource.CacheKeyDependency Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define uma dependência de chave definida pelo usuário que é vinculada a todos os objetos de cache de dados que são criados pelo controle de fonte de dados.
public:
virtual property System::String ^ CacheKeyDependency { System::String ^ get(); void set(System::String ^ value); };public virtual string CacheKeyDependency { get; set; }member this.CacheKeyDependency : string with get, setPublic Overridable Property CacheKeyDependency As StringValor da propriedade
Uma chave que identifica todos os objetos de cache criados pelo ObjectDataSource.
Exemplos
Os três exemplos a seguir mostram uma página da Web, uma classe de página code-behind e uma classe de acesso a dados que recuperam registros da tabela Employees no banco de dados Northwind.
O primeiro exemplo mostra uma página da Web que contém dois ObjectDataSource controles, um DropDownList controle e um DetailsView controle. O primeiro ObjectDataSource controle e o DropDownList controle são usados para recuperar e exibir nomes de funcionários do banco de dados. O segundo ObjectDataSource controle e o DetailsView controle são usados para recuperar e exibir o registro do funcionário selecionado pelo usuário.
O cache está habilitado para o ObjectDataSource controle . Portanto, cada registro é recuperado apenas uma vez do banco de dados. A CacheKeyDependency propriedade é definida como "EmployeeDetails", mas qualquer valor de cadeia de caracteres pode funcionar como a chave. A página da Web também inclui um Button controle que o usuário pode clicar para expirar os dados armazenados em cache.
<form id="form1" runat="server">
<div>
<asp:objectdatasource
ID="ObjectDataSource1"
runat="server"
SelectMethod="GetFullNamesAndIDs"
TypeName="Samples.AspNet.CS.EmployeeLogic" />
<p>
<asp:dropdownlist
ID="DropDownList1"
runat="server"
DataSourceID="ObjectDataSource1"
DataTextField="FullName"
DataValueField="EmployeeID"
AutoPostBack="True"
AppendDataBoundItems="true">
<asp:ListItem Text="Select One" Value=""></asp:ListItem>
</asp:dropdownlist>
</p>
<asp:objectdatasource
ID="ObjectDataSource2"
runat="server"
SelectMethod="GetEmployee"
TypeName="Samples.AspNet.CS.EmployeeLogic"
EnableCaching="true"
CacheKeyDependency="EmployeeDetails" >
<SelectParameters>
<asp:ControlParameter ControlID="DropDownList1" DefaultValue="-1" Name="empID" />
</SelectParameters>
</asp:objectdatasource>
<asp:DetailsView
ID="DetailsView1"
runat="server"
DataSourceID="ObjectDataSource2"
AutoGenerateRows="false">
<Fields>
<asp:BoundField HeaderText="Address" DataField="Address" />
<asp:BoundField HeaderText="City" DataField="City" />
<asp:BoundField HeaderText="Postal Code" DataField="PostalCode" />
</Fields>
</asp:DetailsView>
<asp:Button
ID="Button1"
runat="server"
Text="Check for latest data"
OnClick="Button1_Click" />
</div>
</form>
<form id="form1" runat="server">
<div>
<asp:objectdatasource
ID="ObjectDataSource1"
runat="server"
SelectMethod="GetFullNamesAndIDs"
TypeName="Samples.AspNet.CS.EmployeeLogic" />
<p>
<asp:dropdownlist
ID="DropDownList1"
runat="server"
DataSourceID="ObjectDataSource1"
DataTextField="FullName"
DataValueField="EmployeeID"
AutoPostBack="True"
AppendDataBoundItems="true">
<asp:ListItem Text="Select One" Value=""></asp:ListItem>
</asp:dropdownlist>
</p>
<asp:objectdatasource
ID="ObjectDataSource2"
runat="server"
SelectMethod="GetEmployee"
TypeName="Samples.AspNet.CS.EmployeeLogic"
EnableCaching="true"
CacheKeyDependency="EmployeeDetails" >
<SelectParameters>
<asp:ControlParameter ControlID="DropDownList1" DefaultValue="-1" Name="empID" />
</SelectParameters>
</asp:objectdatasource>
<asp:DetailsView
ID="DetailsView1"
runat="server"
DataSourceID="ObjectDataSource2"
AutoGenerateRows="false">
<Fields>
<asp:BoundField HeaderText="Address" DataField="Address" />
<asp:BoundField HeaderText="City" DataField="City" />
<asp:BoundField HeaderText="Postal Code" DataField="PostalCode" />
</Fields>
</asp:DetailsView>
<asp:Button
ID="Button1"
runat="server"
Text="Check for latest data"
OnClick="Button1_Click" />
</div>
</form>
O segundo exemplo mostra um manipulador para o Load evento e um manipulador para o Click evento do Button controle. O Load manipulador de eventos cria um item de cache com uma chave definida como o CacheKeyDependency valor. O Click manipulador de eventos remove o item de cache cuja chave é igual ao CacheKeyDependency valor . Quando o item de cache é removido, todos os dados armazenados em cache que dependem da chave expiram.
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
Cache[ObjectDataSource2.CacheKeyDependency] = "CacheExample";
}
}
protected void Button1_Click(object sender, EventArgs e)
{
Cache.Remove(ObjectDataSource2.CacheKeyDependency);
Cache[ObjectDataSource2.CacheKeyDependency] = "CacheExample";
DetailsView1.DataBind();
}
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
If Not (IsPostBack) Then
Cache(ObjectDataSource2.CacheKeyDependency) = "CacheExample"
End If
End Sub
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
Cache.Remove(ObjectDataSource2.CacheKeyDependency)
Cache(ObjectDataSource2.CacheKeyDependency) = "CacheExample"
DetailsView1.DataBind()
End Sub
O terceiro exemplo mostra a classe de acesso a dados que interage com o banco de dados Northwind. A classe usa LINQ para consultar a tabela Funcionários. O exemplo requer uma classe LINQ to SQL que representa o banco de dados Northwind e a tabela Employees. Para obter mais informações, consulte Como criar classes LINQ to SQL em um projeto Web.
public class EmployeeLogic
{
public static Array GetFullNamesAndIDs()
{
NorthwindDataContext ndc = new NorthwindDataContext();
var employeeQuery =
from e in ndc.Employees
orderby e.LastName
select new { FullName = e.FirstName + " " + e.LastName, EmployeeID = e.EmployeeID };
return employeeQuery.ToArray();
}
public static Employee GetEmployee(int empID)
{
if (empID < 0)
{
return null;
}
else
{
NorthwindDataContext ndc = new NorthwindDataContext();
var employeeQuery =
from e in ndc.Employees
where e.EmployeeID == empID
select e;
return employeeQuery.Single();
}
}
public static void UpdateEmployeeAddress(Employee originalEmployee, string address, string city, string postalcode)
{
NorthwindDataContext ndc = new NorthwindDataContext();
ndc.Employees.Attach(originalEmployee, false);
originalEmployee.Address = address;
originalEmployee.City = city;
originalEmployee.PostalCode = postalcode;
ndc.SubmitChanges();
}
}
Public Class EmployeeLogic
Public Shared Function GetFullNamesAndIDs() As Array
Dim ndc As New NorthwindDataContext()
Dim employeeQuery = _
From e In ndc.Employees _
Order By e.LastName _
Select FullName = e.FirstName + " " + e.LastName, EmployeeID = e.EmployeeID
Return employeeQuery.ToArray()
End Function
Public Shared Function GetEmployee(ByVal empID As Integer) As Employee
If (empID < 0) Then
Return Nothing
Else
Dim ndc As New NorthwindDataContext()
Dim employeeQuery = _
From e In ndc.Employees _
Where e.EmployeeID = empID _
Select e
Return employeeQuery.Single()
End If
End Function
Public Shared Sub UpdateEmployeeAddress(ByVal originalEmployee As Employee, ByVal address As String, ByVal city As String, ByVal postalcode As String)
Dim ndc As New NorthwindDataContext()
ndc.Employees.Attach(originalEmployee, False)
originalEmployee.Address = address
originalEmployee.City = city
originalEmployee.PostalCode = postalcode
ndc.SubmitChanges()
End Sub
End Class
Comentários
A CacheKeyDependency propriedade pode ser definida como qualquer valor de cadeia de caracteres arbitrária.
Todos os objetos de cache expiram explicitamente quando a chave expira. Isso permite que você invalide as entradas de cache criadas pelo ObjectDataSource código de página por meio de seu próprio código de página programaticamente.
O controle dá suporte ao ObjectDataSource cache de dados. Enquanto os dados são armazenados em cache, as chamadas para o Select método recuperam dados do cache em vez do objeto de negócios com o qual o ObjectDataSource funciona. Quando o cache expira, o Select método recupera dados do objeto de negócios e armazena os dados em cache novamente.
O ObjectDataSource controle armazena automaticamente em cache os dados quando a EnableCaching propriedade é definida true como e a CacheDuration propriedade é definida como um valor maior que 0, o que indica o número de segundos que o cache armazena dados antes que a entrada de cache seja descartada. Um valor 0 indica um cache infinitamente longo.
Você pode definir a CacheKeyDependency propriedade para criar uma dependência entre todas as entradas de cache criadas pelo ObjectDataSource controle e pela chave. Você pode expirar todas as entradas de cache programaticamente a qualquer momento expirando a chave. Expire a chave usando o Cache.Remove método com o valor atual CacheKeyDependency como o parâmetro .
Uma entrada de cache exclusiva é criada para cada combinação das CacheDurationpropriedades , CacheExpirationPolicy, TypeName, SelectMethode SelectParameters . Vários ObjectDataSource controles podem usar as mesmas entradas de cache em cenários em que carregam dados usando o mesmo tipo, método e parâmetros.
