This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ObjectDataSource.CacheKeyDependency الخاصية

Visual Studio 2010

تهيئة مثيل جديد من فئة ذات المحدد سلسلة الاتصال وتحديد الأمر.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public virtual string CacheKeyDependency { get; set; }
<asp:ObjectDataSource CacheKeyDependency="String" />

قيمة الخاصية

النوع: System.String
يستخدم استعلام SQL إلى استرداد البيانات من قاعدة بيانات المصدر.ObjectDataSource

The ثانية تعليمات برمجية مثال provides an مثال وسط-tier business كائن that this و many غير ذلك CacheKeyDependency تعليمات برمجية أمثلة استخدم.

The اتصال سلسلة used إلى يعيّن إلى the underlying قاعدة بيانات. ObjectDataSource يعرف اسم الفئة جزئيا أو كلياً مؤهل لكائن العمل مع به خاصية وأسلوب كائن أعمال التي هو تسمى باسترداد بيانات بواسطة به خاصية.

SelectingObjectDataSource Select تلقائياً بتخزين بيانات مؤقتاً عند ObjectDataSourceخاصية هو تعيين إلى ، و خاصية هو تعيين عدد الثواني في ذاكرة تخزين مؤقت بتخزين بيانات قبل ذاكرة تخزين مؤقت هو dهوcarded. يمكنك أيضا تحديد Selectخاصية و اختياري خاصية.

The ObjectDataSource control automatically caches data when the EnableCaching property is set to true and the CacheDuration property is set to a value greater than 0, which indicates the number of seconds that the cache stores data before the cache entry is discarded. كـ مع الجميع بيانات source عناصر التحكم, the عنصر تحكم هو associated مع a بيانات طريقة عرض المصدر فئة.

إذا كان استعلام SQL هو سلسلة SQL لها معلمات، قد تحتاج إلى إضافة CacheKeyDependencyالكائنات إلى ObjectDataSourceمجموعة. تعداد عنصر التحكم من خلال مجموعة التي هو التي يتم إرجاعها بواسطة خاصية و dهوplays بيانات. توفير مثال التعليمة البرمجية التالية كائن الأعمال الطبقة المتوسطة التي مثال ذلك و كثيرة غير ذلك Cache.Removeاستخدم أمثلة تعليمات برمجية.CacheKeyDependency

A unique cache entry is created for every combination of the CacheDuration, CacheExpirationPolicy, TypeName, SelectMethod, and SelectParameters properties. ObjectDataSource للفئات، التي هو فئة طراز الذي يحتوي على الوظيفة أساسى التي هو المطلوبة للتحميل و persهوt بيانات من الطبقة المسؤولة عن بيانات.

Th هو مجموعة من الفئات المثال يعمل مع قاعدة البيانات Northwind Traders، الذي هو المتوفرة مع Microsoft Office 2010 Suite SQL الخادم والوصول Microsoft Office 2010 Suite.

The first example shows a Web page that contains two ObjectDataSource controls, a DropDownList control, and a DetailsView control. This مثال هو designed إلى be simple و easy إلى follow و إلى demonstrate واحد of the most عام ways a business كائن interacts مع an ObjectDataSource عنصر تحكم. DropDownList The second ObjectDataSource control and the DetailsView control are used to retrieve and display the employee record that is selected by the user.

في some أمثلة, إضافى وظائف are تمت الإضافة إلى the ObjectDataSource أو فئات, أو modifications are made إلى this التعيين of فئات إلى demonstrate fundamental concepts. تهيئة مثيل جديد ل فئة ذات المحدد اسم النوع بيانات استرداد الأسلوب اسم. The اسم of the فئة that the CacheKeyDependency works مع. الاسم أسلوب أو دالة التي Buttonاستدعاء لاسترداد البيانات.


<form id="form1" runat="server">
<div>
<asp:objectdatasource
      ID="ObjectDataSource1"
      runat="server"
      SelectMethod="GetFullNamesAndIDs"
      TypeName="Samples.AspNet.CS.EmployeeLogic" />

    <p>
    <asp:dropdownlist
      ID="DropDownList1"
      runat="server" 
      DataSourceID="ObjectDataSource1"
      DataTextField="FullName"
      DataValueField="EmployeeID" 
      AutoPostBack="True" 
      AppendDataBoundItems="true">
        <asp:ListItem Text="Select One" Value=""></asp:ListItem>
    </asp:dropdownlist>
    </p>

 <asp:objectdatasource
      ID="ObjectDataSource2"
      runat="server"
      SelectMethod="GetEmployee"
      TypeName="Samples.AspNet.CS.EmployeeLogic" 
      EnableCaching="true"
      CacheKeyDependency="EmployeeDetails" >
      <SelectParameters>
        <asp:ControlParameter ControlID="DropDownList1" DefaultValue="-1" Name="empID" />
      </SelectParameters>
    </asp:objectdatasource>

    <asp:DetailsView
        ID="DetailsView1"
        runat="server"
        DataSourceID="ObjectDataSource2" 
        AutoGenerateRows="false">  
        <Fields>
            <asp:BoundField HeaderText="Address" DataField="Address" />
            <asp:BoundField HeaderText="City" DataField="City" />
            <asp:BoundField HeaderText="Postal Code" DataField="PostalCode" />
        </Fields>  
    </asp:DetailsView>

    <asp:Button 
    ID="Button1" 
    runat="server" 
    Text="Check for latest data" 
    OnClick="Button1_Click" />

</div>
</form>


The second example shows a handler for the Load event and a handler for the Click event of the Button control. الحصول أو تعيين الطول الفترة الزمنية، بالثواني، وعنصر تحكم مصدر البيانات تقوم بتخزين البيانات التي هو التي تم استردادها بواسطة Loadخاصية.CacheKeyDependency The رقم of ثواني that the Click caches the نتائج of a CacheKeyDependency خاصية invocation. While بيانات هو cached, calls إلى the أسلوب retrieve بيانات من the ذاكرة تخزين مؤقت rather than من the business كائن that the works مع.


protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        Cache[ObjectDataSource2.CacheKeyDependency] = "CacheExample";
    }
}
protected void Button1_Click(object sender, EventArgs e)
{
    Cache.Remove(ObjectDataSource2.CacheKeyDependency);
    Cache[ObjectDataSource2.CacheKeyDependency] = "CacheExample";
    DetailsView1.DataBind();
}


When the ذاكرة تخزين مؤقت expires, the أسلوب retrieves بيانات من the business كائن, و then caches the بيانات again. The ذاكرة تخزين مؤقت هو regulated بواسطة a combination of the مدة و the إعداد. If the خاصية هو التعيين إلى the القيمة, the caches بيانات تشغيل the أول يتصل إلى the أسلوب و holds it في ذاكرة for, على الأكثر, the المقدار of الوقت that هو specified بواسطة the خاصية. لمزيد من المعلومات، راجع كيفية: إنشاء LINQ إلى فئات SQL في تطبيق ويب.


public class EmployeeLogic
{
    public static Array GetFullNamesAndIDs()
    {
        NorthwindDataContext ndc = new NorthwindDataContext();

        var employeeQuery =
            from e in ndc.Employees
            orderby e.LastName
            select new { FullName = e.FirstName + " " + e.LastName, EmployeeID = e.EmployeeID };

        return employeeQuery.ToArray();
    }

    public static Employee GetEmployee(int empID)
    {
        if (empID < 0)
        {
            return null;
        }
        else
        {
            NorthwindDataContext ndc = new NorthwindDataContext();
            var employeeQuery =
                from e in ndc.Employees
                where e.EmployeeID == empID
                select e;

            return employeeQuery.Single();
        }
    }

    public static void UpdateEmployeeAddress(Employee originalEmployee, string address, string city, string postalcode)
    {
        NorthwindDataContext ndc = new NorthwindDataContext();
        ndc.Employees.Attach(originalEmployee, false);
        originalEmployee.Address = address;
        originalEmployee.City = city;
        originalEmployee.PostalCode = postalcode;
        ndc.SubmitChanges();
    }
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: