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.EnableCaching الخاصية

Visual Studio 2010

ObjectDataSource المفوضون أسلوب أسلوب الكائن الذي هو المقترنة عنصر التحكم.

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

public virtual bool EnableCaching { get; set; }
<asp:ObjectDataSource EnableCaching="True|False" />

قيمة الخاصية

النوع: System.Boolean
إلى تنفيذ تشغيل، trueبناء falseالكائن باستخدام نص وأية المقترنة قيم، ومن ثم تنفيذ مقابل قاعدة بيانات المصدر. يكون الإعداد الافتراضي هو false.

استثناء:شرط
NotSupportedException

The EnableCaching property is set to true when the method specified by the SelectMethod property returns a DbDataReader.

SelectingObjectDataSource على سبيل المثال، إذا كان Selectعنصر التحكم هو مرتبط ObjectDataSourceعنصر التحكم الذي يحتوي على أعمدة ، معلمات ل و تتم إضافتها إلى المجموعة. يمكنك أيضا تحديد 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 بيانات طريقة عرض المصدر فئة.

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
إظهار: