Share via


SqlDataSource.CacheKeyDependency 屬性

定義

取得或設定使用者定義的索引鍵相依性,連結至資料來源控制項所建立的所有資料快取物件。 當索引鍵過期時,所有快取的物件也會明確過期。

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

屬性值

String

索引鍵,識別 SqlDataSource 建立的所有快取物件。

備註

控制項 SqlDataSource 支援資料快取。 快取資料時, Select 方法會從快取擷取資料,而不是從基礎資料庫擷取資料。 當快取過期時, Select 方法會從基礎資料庫擷取資料,然後再次快取資料。

您可以設定 CacheKeyDependency 屬性,在控制項和索引鍵所 SqlDataSource 建立的所有快取專案之間建立相依性。 您可以隨時透過過期金鑰,以程式設計方式將所有快取專案到期。

SqlDataSource只有在模式中 DataSet 時,控制項才能快取資料。 NotSupportedException如果 SqlDataSource 控制項設定為 DataReader 值,而且也會啟用快取,則方法會擲 Select 回例外狀況。

針對 、 ConnectionStringSelectParameters 屬性的每個組合,都會建立唯一的 SelectCommand 快取專案。 在控制項從相同基礎資料庫載入相同資料的案例中,多個 SqlDataSource 控制項可以使用相同的快取專案。

重要

當您在 Microsoft Windows 驗證下使用用戶端模擬時,當第一位使用者存取資料時,就會快取資料。 如果其他使用者要求相同的資料,則會從快取擷取資料。 不會透過對資料庫進行另一個呼叫來擷取資料,以驗證使用者對資料的存取權。 如果您預期有多個使用者存取資料,而且您希望每個擷取到資料庫的安全性組態驗證資料,請勿使用快取。

適用於

另請參閱