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

Visual Studio 2010

InsertMethod يعتمد عنصر تحكم بيانات التصفية فقط عند إرجاع الأسلوب أو كائن.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection InsertParameters { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.ParameterCollection
بناء الجملة التي هو المستخدمة ل ParameterCollectionخاصية هو تعبير تنسيق سلسلة–النمط.InsertMethod

بناء جملة تعبير عامل تصفية هو نفس بناء الجملة التي تم قبولها بواسطة InsertParametersخاصية.InsertMethod إذا قمت بإضافة معلمات إلى مجموعة، كما يمكنك تضمين سلسلة تنسيق عنصر نائب. When working with data-bound controls that supply parameters, such as the GridView and DetailsView controls, the ObjectDataSource control automatically merges any parameters that are explicitly specified in the collection with the parameters that are provided by the data-bound control. This is important because data-bound controls always supply their parameters as String types, and if the method signature includes numeric or date types, you must explicitly include a parameter in the InsertParameters collection with the correct type. وقت التشغيل بساطة استبدال القيمة معلمة في تعبير عامل تصفية وينطبق ObjectDataSourceأو الكائن الذي هو التي يتم إرجاعها بواسطة الأسلوب. لمزيد من المعلومات، راجع استخدام معلمات مع التحكم ObjectDataSource.

The InsertParameters property retrieves the InsertParameters property that is contained by the ObjectDataSourceView that is associated with the ObjectDataSource control.

InsertMethod خاصية هو معينة إلى "EmployeeDetails"، ولكن يمكن لأي القيمة سلسلة العمل المفتاح.

هذا مقطع يحتوي على الثاني بالتعليمات البرمجية الأمثلة. صفحة ويب تحتوي على ObjectDataSourceالتحكم الذين DetailsViewخاصية هو تعيين إلى . استرداد بيانات تشغيل موظف آخر في InsertEnter الزر الزر الاسم الكامل للموظف وثم انقر فوق من إرسال زر.

سلسلة تمثل تعبير تصفية المطبقة عند بيانات هو التي تم استردادها باستخدام أسلوب كائن العمل المعرفة بواسطة ObjectDataSourceخاصية.DetailsView يمكنك إلغاء الأمر تشغيل المحددة بواسطة تعيين DetailsViewخاصية NorthwindEmployeeإلى . DetailsView يعتمد عنصر تحكم بيانات التصفية فقط عند إرجاع الأسلوب ، ، أو كائن. InsertMethod خاصية و يتم تعيين خاصية إلى أسماء المعلمات المستخدمة في التحديد أسلوب.

If you click the Insert button, the operation is performed using the method that is specified by the InsertMethod property and any parameters that are specified in the InsertParameters collection. في هذا مثال، يتم تقييد العنصر النائب الخاص بمعلمة بعلامات اقتباس مفردة لأن نوع معلمة هو نوع سلسلة التي قد تحتوي على مسافات.InsertParameters قمت بتعيين Rowsخاصية و DetailsViewأسلوب لا يرجع BoundFieldأو ObjectDataSource. By adding it explicitly to the InsertParameters collection with a Type property set to the Int32 value, it will be passed correctly by the ObjectDataSource to the method as an Int32, not as a string.

When the Insert operation is performed, the method that is identified by the InsertMethod property is called. يوضح المثال تعليمات برمجية أول كيفية عرض بيانات التي تم تصفيتها باستخدام Insertكائن استرداد بيانات من كائن أعمال الطبقة المتوسطة InsertParametersعنصر تحكم لعرض نتائج.Insert

ملاحظة الأمانملاحظة الأمان

الحصول أو تعيين تعبير تصفية هو المطبق عند الأسلوب الذي هو المحدد بواسطة خاصية هو تسمى. سلسلة تمثل تعبير تصفية التي هو تطبيقها متى بيانات هو التي تم استردادها باستخدام أسلوب أو الدالة المعرفة من قبل InsertMethodخاصية.


<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Import namespace="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!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>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          autogenerateinsertbutton="True"
          autogeneraterows="false"
          datasourceid="ObjectDataSource1"
          defaultmode="Insert" >
          <fields>
            <asp:BoundField headertext="FirstName" datafield="FirstName" />
            <asp:BoundField headertext="LastName"   datafield="LastName" />
            <asp:BoundField headertext="Title"      datafield="Title" />
            <asp:BoundField headertext="Courtesy"   datafield="Courtesy" />
            <asp:BoundField headertext="Supervisor" datafield="Supervisor" />
          </fields>
        </asp:detailsview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          insertmethod="InsertNewEmployeeWrapper"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:parameter name="anID" defaultvalue="-1" />
          </selectparameters>
          <insertparameters>
            <asp:parameter name="Supervisor" type="Int32" />
          </insertparameters>
        </asp:objectdatasource>

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


هو مفيداً أيضا لترتيب هو المثال، لأن النموذج يعتمد تشغيل توفير الاسم الكامل للموظف Northwind Traders لتوضيح التصفية.Insert The InsertNewEmployeeWrapper method is added to the EmployeeLogic middle-tier object that is provided in the ObjectDataSource class overview to enable the object to work more easily with the ObjectDataSource control in Web scenarios, without a substantial rewrite to the actual business logic.

To run the example, you must have the NorthwindEmployee class that is provided in the ObjectDataSource class overview. ObjectDataSource يسمى التي هو المقترنة . المعين Saveهو NorthwindEmployeeأو شيء آخر بدلاً من .


// This InsertNewEmployeeWrapper method is a wrapper method that enables
// the use of ObjectDataSource and InsertParameters, without
// substantially rewriting the true implementation for the NorthwindEmployee
// or the EmployeeLogic objects.
//
// The parameters to the method must be named the same as the
// DataControlFields used by the GridView or DetailsView controls.
public static void InsertNewEmployeeWrapper (string FirstName,
                                             string LastName,
                                             string Title,
                                             string Courtesy,
                                             int    Supervisor)
{
  // Build the NorthwindEmployee object and
  // call the true  implementation.
  NorthwindEmployee tempEmployee = new NorthwindEmployee();

  tempEmployee.FirstName  = FirstName;
  tempEmployee.LastName   = LastName;
  tempEmployee.Title      = Title;
  tempEmployee.Courtesy   = Courtesy;
  tempEmployee.Supervisor = Supervisor;

  // Call the true implementation.
  InsertNewEmployee(tempEmployee);
}

public static void InsertNewEmployee(NorthwindEmployee ne) {
  bool retval = ne.Save();
  if (! retval) { throw new NorthwindDataException("InsertNewEmployee failed."); }
}


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