SqlDataSource.CacheKeyDependency 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

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

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回例外狀況。

針對、 ConnectionString和 SelectParameters 屬性的每個組合，都會建立唯一的SelectCommand快取專案。 在控件從相同基礎資料庫載入相同數據的案例中，多個 SqlDataSource 控件可以使用相同的快取專案。

重要

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

另請參閱

• CacheDuration
• 資料來源 Web 伺服器控制項
• SqlDataSource Web Server 控件概觀