Freigeben über

SqlDataSource.SqlCacheDependency Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen einer durch Semikolons getrennten Zeichenfolge, die angibt, welche Datenbanken und Tabellen für die Microsoft SQL Server-Cacheabhängigkeit verwendet werden sollen.

public:
 virtual property System::String ^ SqlCacheDependency { System::String ^ get(); void set(System::String ^ value); };
public virtual string SqlCacheDependency { get; set; }
member this.SqlCacheDependency : string with get, set
Public Overridable Property SqlCacheDependency As String

Eigenschaftswert

String

Eine Zeichenfolge, die angibt, welche Datenbanken und Tabellen für die SQL Server-Cacheabhängigkeit verwendet werden sollen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Eine SQL Server-Cacheabhängigkeit erstellt und die SqlCacheDependency Eigenschaft eines SqlDataSource Steuerelements festgelegt wird. In diesem Beispiel wird die Datenbank alle 120 Sekunden abgefragt. Wenn sich die Daten in der Tabelle "Northwind Traders Employees" während dieses Zeitraums ändern, werden alle Daten, die SqlDataSource vom Steuerelement zwischengespeichert und angezeigt werden GridView , vom SqlDataSource Steuerelement aktualisiert, wenn die Datenbank das nächste Mal abgefragt wird.

<%@ Page language="c#" %>

<!--

The page uses an example configuration that includes
connection strings and a defined SqlCacheDependecy.

<?xml version="1.0"?>
<configuration>

  <connectionStrings>
    <add name="MyNorthwind"
         connectionString="Data Source="localhost";Integrated Security="SSPI";Initial Catalog="Northwind""
         providerName="System.Data.SqlClient" />
  </connectionStrings>

  <system.web>
    <caching>
      <sqlCacheDependency enabled="true">
        <databases>
          <add
            name="Northwind"
            connectionStringName="MyNorthwind"
            pollTime="120000" />
        </databases>
      </sqlCacheDependency>
    </caching>

  </system.web>
</configuration>
-->

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="SqlDataSource1" />

        <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT EmployeeID,FirstName,Lastname FROM Employees"
          enablecaching="True"
          cacheduration="300"
          cacheexpirationpolicy="Absolute"
          sqlcachedependency="Northwind:Employees" />

    </form>
  </body>
</html>

<%@ Page language="vb" %>

<!--

The page uses an example configuration that includes
connection strings and a defined SqlCacheDependecy.

<?xml version="1.0"?>
<configuration>

  <connectionStrings>
    <add name="MyNorthwind"
         connectionString="Data Source="localhost";Integrated Security="SSPI";Initial Catalog="Northwind""
         providerName="System.Data.SqlClient" />
  </connectionStrings>

  <system.web>
    <caching>
      <sqlCacheDependency enabled="true">
        <databases>
          <add
            name="Northwind"
            connectionStringName="MyNorthwind"
            pollTime="120000" />
        </databases>
      </sqlCacheDependency>
    </caching>

  </system.web>
</configuration>
-->

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="SqlDataSource1" />

        <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT EmployeeID,FirstName,Lastname FROM Employees"
          enablecaching="True"
          cacheduration="300"
          cacheexpirationpolicy="Absolute"
          sqlcachedependency="Northwind:Employees" />

    </form>
  </body>
</html>

Hinweise

Das SqlDataSource Steuerelement unterstützt eine optionale Ablaufrichtlinie basierend auf dem SqlCacheDependency Objekt für den Datencache (der Dienst muss für den Datenbankserver konfiguriert werden).

Die SqlCacheDependency Zeichenfolge identifiziert Datenbanken und Tabellen gemäß demselben Format, das von der @ Page Direktive verwendet wird, wobei der erste Teil der Zeichenfolge eine Verbindungszeichenfolge mit einer Microsoft SQL Server-Datenbank ist, gefolgt von einem Doppelpunkttrennzeichen und schließlich dem Namen der Datenbanktabelle (z "connectionstring1:table1". B. ). Wenn die SqlCacheDependency Eigenschaft von mehreren Tabellen abhängt, werden die Verbindungszeichenfolgen- und Tabellennamenpaare durch Semikolons getrennt (z. B "connectionstring1:table1";connectionstring2:table2". ).

Von Bedeutung

Wenn Sie den Identitätswechsel des Clients unter Microsoft Windows-Authentifizierung verwenden, werden die Daten zwischengespeichert, wenn der erste Benutzer auf die Daten zugreift. Wenn ein anderer Benutzer dieselben Daten anfordert, werden die Daten aus dem Cache abgerufen. Die Daten werden nicht abgerufen, indem sie einen weiteren Aufruf der Datenbank durchführen, um den Zugriff des Benutzers auf die Daten zu überprüfen. Wenn Sie davon ausgehen, dass mehrere Benutzer auf die Daten zugreifen, und sie möchten, dass jeder Abruf der Daten von den Sicherheitskonfigurationen für die Datenbank überprüft wird, verwenden Sie keine Zwischenspeicherung.

Gilt für:

Weitere Informationen