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.

Substitution الفئة

Visual Studio 2010

يلي تعليمات برمجية مثال يوضح كيفية اشتقاق فئة من الفئة لإنشاء مخصص ربط بيانات عنصر التحكم. Substitution عنصر تحكم يعرض مقطع HTML باستخدام شجرة نص للبيانات التي تم استردادها من مصدر بيانات مقترن عنصر تحكم.

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

public class Substitution : Control
<asp:Substitution />

في هذا الموضوع:

مقدمة

يوضح المثال تعليمات برمجية التالي كيفية استخدام Substitutionعنصر تحكم معرفة في المثال السابق وربطه عنصر تحكم. الوصول إلى الملف geneology.xml تعليمات برمجية المثال يحتوي على بيانات التالية.Substitution يسترد Substitutionالكائن الذي ربط بيانات عنصر تحكم يستخدم لتنفيذ عمليات بيانات. مسار التسلسل الهرمي لطريقة العرض إلى استرداد. الكائن الذي ربط بيانات عنصر تحكم يستخدم لتنفيذ عمليات بيانات. تعذر استرداد للمحدد . AdRotator أسلوب استرداد الكائن من مصدر بيانات المقترن عنصر تحكم عن طريق استدعاء الأسلوب. يوضح مثال التعليمة البرمجية التالية كيف أسلوب هو تسمى لاسترداد الكائن من عنصر تحكم مصدر بيانات المقترن وكيف أسلوب هو تسمى لاسترداد بيانات. يسترد التحكم ربط البيانات هو المقترنة، أن وجد. AdRotator المثيل الذي يمثل بيانات المصدر المعرف من قبل خاصية.

ملاحظةملاحظة

مصدر بيانات عنصر تحكم المعرف بواسطة Substitutionخاصية غير موجودة في الحاوية الحالي. مصدر بيانات عنصر تحكم المعرف بواسطة Substitutionلا تطبق هذه خاصية الواجهة.

Substitution لاستدعاءات الأسلوب أسلوب داخليا. تسمى عند إحدى خصائص تعريف مصدر البيانات الأساسي هو تغييرها إلى re-ييربط التحكم بيانات منضم للبيانات الخاصة به.Substitution The MethodName أسلوب هو called when the Substitution أو هو تم تغييره أي وقت بعد the الصفحة's حدث. يوضح المثال تعليمات برمجية التالي كيفية ربط البيانات عنصر تحكم يمكن استدعاء Substitutionالأسلوب في حالة تغيير خاصية تقوم بتعريف مصدر بيانات بعد ربط البيانات عنصر تحكم تمت تهيئته. Called when the HttpResponseSubstitutionCallback مثيل that the بيانات-تحكم محدود works مع raises the HttpContext حدث.

To manipulate the output cache for a page, you can use the @ OutputCache directive, the HttpCachePolicy class, or the Cache property. An التخزين المؤقت صفحات ASP.NET كائن that يحتوي على حدث بيانات. التخزين المؤقت أقسام لصفحة ASP.NET

Substitution فئة مقابض HttpResponseSubstitutionCallbackحدث لتعيين خاصية إلى . يعالج AdRotatorحدث. لمزيد من المعلومات، راجع تحديث أجزاء من الصفحة المخزنة مؤقتاً بشكل حيوي.

بناء جملة مصرحة

<asp:Substitution
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    MethodName="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Visible="True|False"
/>

Substitution معالجة حدث تحميل لتعيين خاصية إلى إذا طلب HTTP هو لا إعادة النشر. عند تجاوز في فئة مشتقة، يتم ربط بيانات من مصدر بيانات عنصر تحكم. قم بتطبيق هذا الأسلوب بدلاً من الأسلوب عند الحصول على ربط بيانات عنصر تحكم من فئة. وضع ربط بيانات منطق عنصر تحكم Substitutionيحافظ GetCurrentDateTimeو الأحداث من يتم مرفوع في ترتيب غير صحيح. بينما الأساسية GetCurrentDateTimeتوفر فئة التطبيق المعين ليس لترتيب هو الأسلوب، أسلوب هو استدعاؤها بواسطة طريقة لضم قيم من أي عناصر واجهة مستخدم إلى البيانات التي هو استردادها بواسطة الأسلوب. يلي تعليمات برمجية مثال يوضح كيفية تنفيذ أسلوب في فئة مشتقة من .


<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">  

  void Page_Load(object sender, System.EventArgs e)
  {
    // Display the current date and time in the label.
    // Output caching applies to this section of the page.
    CachedDateLabel.Text = DateTime.Now.ToString();    
  }

  // The Substitution control calls this method to retrieve
  // the current date and time. This section of the page
  // is exempt from output caching. 
  public static string GetCurrentDateTime (HttpContext context)
  {
    return DateTime.Now.ToString ();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Substitution Class Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <h3>Substitution Class Example</h3>  

    <p>This section of the page is not cached:</p>

    <asp:substitution id="Substitution1"
      methodname="GetCurrentDateTime"
      runat="Server">
    </asp:substitution>

    <br />

    <p>This section of the page is cached:</p>

    <asp:label id="CachedDateLabel"
      runat="Server">
    </asp:label>

    <br /><br />

    <asp:button id="RefreshButton"
      text="Refresh Page"
      runat="Server">
    </asp:button>     

  </form>
</body>
</html>


System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.Substitution

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: