Freigeben über


SqlDataSource.CacheKeyDependency Eigenschaft

Definition

Ruft eine benutzerdefinierte Schlüsselabhängigkeit ab, die mit sämtlichen vom Datenquellen-Steuerelement erstellten Datencacheobjekten verknüpft ist, oder legt diese fest. Alle Cacheobjekte laufen explizit ab, wenn der Schlüssel abläuft.

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, set
Public Overridable Property CacheKeyDependency As String

Eigenschaftswert

Ein Schlüssel, der alle von der SqlDataSource erstellten Cacheobjekte angibt.

Hinweise

Das SqlDataSource -Steuerelement unterstützt die Datenzwischenspeicherung. Während daten zwischengespeichert werden, ruft die Select -Methode Daten aus dem Cache und nicht aus der zugrunde liegenden Datenbank ab. Wenn der Cache abläuft, ruft die Select -Methode Daten aus der zugrunde liegenden Datenbank ab und speichert die Daten dann erneut zwischen.

Sie können die CacheKeyDependency -Eigenschaft festlegen, um eine Abhängigkeit zwischen allen Cacheeinträgen zu erstellen, die SqlDataSource vom Steuerelement und dem Schlüssel erstellt werden. Sie können alle Cacheeinträge jederzeit programmgesteuert ablaufen, indem Sie den Schlüssel ablaufen.

Das SqlDataSource Steuerelement kann Daten nur im DataSet Modus zwischenspeichern. Eine NotSupportedException Ausnahme wird von der Select -Methode ausgelöst, wenn das SqlDataSource Steuerelement auf den DataReader Wert festgelegt ist und die Zwischenspeicherung ebenfalls aktiviert ist.

Für jede Kombination der Eigenschaften , ConnectionStringund SelectParameters wird ein eindeutiger SelectCommandCacheeintrag erstellt. Mehrere SqlDataSource Steuerelemente können dieselben Cacheeinträge in Szenarien verwenden, in denen die Steuerelemente dieselben Daten aus derselben zugrunde liegenden Datenbank laden.

Wichtig

Wenn Sie den Clientidentitätswechsel unter der 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 durch einen weiteren Aufruf der Datenbank abgerufen, um den Zugriff des Benutzers auf die Daten zu überprüfen. Wenn Sie erwarten, dass mehr als ein Benutzer auf die Daten zugreifen und jeder Abruf der Daten von den Sicherheitskonfigurationen für die Datenbank überprüft werden soll, verwenden Sie keine Zwischenspeicherung.

Gilt für:

Weitere Informationen