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

String

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

Hinweise

Das Steuerelement unterstützt die SqlDataSource Datenspeicherung. 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 cachet dann die Daten erneut.

Sie können die CacheKeyDependency Eigenschaft so festlegen, dass eine Abhängigkeit zwischen allen Cacheeinträgen erstellt wird, die vom Steuerelement und dem SqlDataSource 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 DataSet im 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.

Ein eindeutiger Cacheeintrag wird für jede Kombination aus den SelectCommand, ConnectionStringund SelectParameters eigenschaften 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 clientwechseln unter Microsoft Windows-Authentifizierung verwenden, werden die Daten zwischengespeichert, wenn der erste Benutzer auf die Daten zugreift. Wenn ein anderer Benutzer dieselben Daten anfordert, wird die Daten aus dem Cache abgerufen. Die Daten werden nicht abgerufen, indem sie einen anderen Aufruf an die Datenbank vornehmen, um den Zugriff des Benutzers auf die Daten zu überprüfen. Wenn Sie erwarten, dass mehr als ein Benutzer auf die Daten zugreifen kann, und sie möchten, dass die Daten von den Sicherheitskonfigurationen für die Datenbank überprüft werden, nicht die Zwischenspeicherung verwenden.

Gilt für

Siehe auch