SqlDataSource.SqlCacheDependency Eigenschaft

  • Referenz

Definition

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

Ruft eine durch Semikolons getrennte Zeichenfolge ab, die die für die Microsoft SQL Server-Cacheabhängigkeit zu verwendenden Datenbanken und Tabellen angibt, oder legt diese fest.

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 die für die SQL Server-Cacheabhängigkeit zu verwendenden Datenbanken und Tabellen angibt.

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 dieser Zeit ändern, werden alle Daten, die vom SqlDataSource Steuerelement zwischengespeichert und vom GridView Steuerelement angezeigt werden, aktualisiert SqlDataSource , 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 entsprechend 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 (z "connectionstring1:table1";connectionstring2:table2". B. ) getrennt.

Wichtig

Wenn Sie den Clientwechsel 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 anderen Aufruf der Datenbank tätigen, um den Zugriff des Benutzers auf die Daten zu überprüfen. Wenn Sie erwarten, dass mehrere Benutzer auf die Daten zugreifen, und sie möchten, dass alle Abrufe an die Daten durch die Sicherheitskonfigurationen für die Datenbank überprüft werden, verwenden Sie keine Zwischenspeicherung.

Gilt für

Siehe auch