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.

ImageButton الفئة

Visual Studio 2010

تتوفر قيمة الإرجاع ومعلمات الإخراج ومعالجة خصائص ‏‏ استثناء من الكائن الذي هو المقترن بحدث.

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

public class ImageButton : Image, 
	IPostBackDataHandler, IPostBackEventHandler, IButtonControl
<asp:ImageButton />

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

مقدمة

المعلمات المتوفرة ImageButtonمجموعة التي هو الوصول إليها من قبل خاصية، التي هو كشف عن طريق الكائن.

Both the Click and Command events are raised when the ImageButton control is clicked.

معالجة OnCommandالحدث إلى فحص قيم لقيمة الإرجاع ومعلمات الإخراج أو إلى لتحديد ما إذا كان تم طرح استثناء بعد ImageButtonاكتمال تشغيل. يحدث قبل على CommandNameتشغيل. The أول تعليمات برمجية مثال demonstrates how إلى استخدم an ImageButton عنصر تحكم مع a business كائن و a عنصر تحكم إلى إدراج بيانات. في this تعليمات برمجية مثال, the CommandName أسلوب هو used إلى perform an إدراج; however it يتطلب a OnCommand معلمة إلى إدراج the بيانات. ImageButton Because the CommandArgument أسلوب يتطلب a كائن كـ a معلمة, واحد هو تاريخ الإنشاء using the مجموعة of سلاسل, و then تمت الإضافة إلى the مجموعة using a اسم المعامل () that the أسلوب expects.

The ImageButton فئة, which هو a عديم الحالة فئة that encapsulates business logic. Button لمزيد من المعلومات، راجع نظرة عامة حول عناصر التحكم ملقم ويب زر. Button أسلوب هو تنفيذ غير كامل، لذلك سوف لا إدراج بيانات في قاعدة البيانات Northwind Traders عندما اختبر th هو المثال.

يحدث قبل تشغيل.

Occurs بعد the OnClick كائن creates an مثيل of the نوع that هو identified بواسطة the خاصية. معالجة حدث استدعاء الأساليب الأخرى على كائن الأعمال، إعداد الخصائص، أو القيام بتهيئة الأخرى الخاصة بكائن الأعمال قبل التحكم في المكالمات أساليب لكائن الأعمال. A مرجع إلى the كائن هو accessed بواسطة the خاصية, which هو exposed بواسطة the كائن.

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

If the أسلوب that هو identified إلى perform the بيانات تشغيل هو ImageButton ( في Visual أساسى), the و أحداث are ‏‏مطلقاً مرفوع. التحقق من صفحة تحديد ما إذا كان s عنصر تحكم إدخال المقترنة التحقق من صحة عنصر تحكم تشغيل الصفحة تمرير الجميع قواعد التحقق من الصحة المحدد مع التحقق من الصحة عنصر تحكم. Occurs قبل the CausesValidation كائن creates an مثيل of the نوع that هو identified بواسطة the false خاصية.

‏إمكانية وصول ذوي الاحتياجات الخاصة

للحصول على المعلومات حول كيفية تكوين هذا عنصر تحكم حيث أنه يقوم بإنشاء ترميز التي تتوافق مع معايير إمكانية الوصول، راجع دعم الوصول في ASP.NETو عناصر تحكم ASP.NET و إمكانية التشغيل.

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

<asp:ImageButton
    AccessKey="string"
    AlternateText="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    DescriptionUrl="uri"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
        AbsBottom|AbsMiddle|TextTop"
    ImageUrl="uri"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

The ImageButton عنصر تحكم automatically calls the الافتراضي الدالة الإنشائية of a business كائن إلى إنشاء و مثيل of it using انعكاس.

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

نموذج تعليمات برمجية التالي يستخدم طراز تعليمات برمجية أحادية و قد لا تعمل بشكل صحيح في حالة نسخ مباشرة في التعليمات برمجية-خلف ملف. يجب أن يتم نسخ نموذج تعليمات برمجية هذه في ملف نصي فارغ له ملحق.aspx. لمزيد من المعلومات حول نموذج تعليمات برمجية "نماذج ويب"، راجع طراز رمز صفحة ASP.NET على ويب.


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />

      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>



يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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, 1.1, 1.0
إظهار: