ObjectDataSource.SelectMethod Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin verileri almak için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

public:
 property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };
public string SelectMethod { get; set; }
member this.SelectMethod : string with get, set
Public Property SelectMethod As String

Özellik Değeri

String

Veri almak için kullandığı yöntemin veya işlevin ObjectDataSource adını temsil eden bir dize. Varsayılan değer, boş dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir denetimin Web Forms sayfasındaki bir GridViewObjectDataSource denetimi kullanarak verileri nasıl görüntüleyebileceğini gösterir. özelliğiyle ObjectDataSource kısmen veya tam sınıf adını ve özelliğiyle TypeNameSelectMethod veri almak için çağrılan bir yöntemi tanımlar. Çalışma zamanında nesnesi oluşturulur ve yansıma kullanılarak yöntemi çağrılır. Denetim, GridView özelliği tarafından SelectMethod belirtilen yöntemi tarafından döndürülen koleksiyonda IEnumerable numaralandırılır ve verileri görüntüler.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="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:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

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

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!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 - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

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

Açıklamalar

Belirtilen yöntemin herhangi bir yöntem imzası olabilir, ancak denetimin başarıyla çağırması için aşağıdaki tabloda gösterilen türlerden birini döndürmesi ObjectDataSource gerekir.

Dönüş türü Eylem
IEnumerable IEnumerable yöntemi tarafından Select döndürülür.
DataTable yöntemi DataView tarafından Select döndürülen ve kullanılarak DataTable oluşturulur.
DataView yöntemi tarafından Select döndürülürDataView.
DataSet öğesinin ilki DataTableDataSet ayıklanır ve yöntemi tarafından Select oluşturulur DataView ve döndürülür.
Object nesnesi tek öğeli IEnumerable bir koleksiyonda sarmalanır ve yöntemi tarafından Select döndürülür.

özelliği, SelectMethod denetimle ilişkilendirilmiş nesnenin ObjectDataSourceView özelliğini temsil ederObjectDataSource.SelectMethod

verileri silmek veya güncelleştirmek için sınıfını kullandığınızdaObjectDataSource, koleksiyon veya UpdateParameters koleksiyondaki denetim için ObjectDataSource yapılandırılan parametre adlarının DeleteParameters seçme yöntemi tarafından döndürülen sütun adlarla eşleştiğinden emin olun.

Nesne Ömrü

özelliği tarafından SelectMethod tanımlanan yöntem bir örnek yöntemi veya static (Shared Visual Basic'te) yöntemi olabilir. Bu bir örnek yöntemiyse, özelliği tarafından SelectMethod belirtilen yöntem her çağrıldığında iş nesnesi oluşturulur ve yok edilir. özelliği tarafından belirtilen yöntem çağrılmadan önce iş nesnesiyle çalışmak için ve ObjectCreating olaylarını SelectMethod işleyebilirsinizObjectCreated. Özelliği tarafından SelectMethod belirtilen yöntem çağrıldıktan sonra tetiklenen olayı da işleyebilirsinizObjectDisposing. İş nesnesi arabirimini IDisposable uygularsa, Dispose nesne yok edilmeden önce yöntemi çağrılır. Yöntem static (Shared Visual Basic'te) ise, iş nesnesi hiçbir zaman oluşturulmaz ve , ObjectCreatingve ObjectDisposing olaylarını ObjectCreatedişleyemezsiniz.

Parametre Birleştirme

Parametreler şu kaynaklardan koleksiyona SelectParameters eklenir:

  • öğesinden bildirim temelli SelectParameters olarak.

  • Yönteminden Selecting program aracılığıyla.

İlk olarak, öğesinde SelectParameters listelenen parametreler eklenir. İkincisi, yöntem çalıştırılmadan önce Select gerçekleşen olaya program aracılığıyla parametreler eklenir ve kaldırılırSelecting. Yöntemi, parametreler birleştirildikten sonra çözülür. Yöntem çözümlemesi bir sonraki bölümde açıklanmıştır.

Önemli

İstemciden aldığınız tüm parametre değerlerini doğrulamanız gerekir. Çalışma zamanı yalnızca parametre değerini özelliğiyle değiştirmektedir SelectMethod .

Yöntem Çözümlemesi

Select Yöntemi çağrıldığında, veriye bağlı denetimdeki veri alanları, öğesinde SelectParameters bildirim temelli olarak oluşturulan parametreler ve olay işleyicisine eklenen parametrelerin Selecting tümü birleştirilir. (Daha fazla bilgi için önceki bölüme bakın.) Denetim ObjectDataSource daha sonra çağrılacak bir yöntem bulmaya çalışır. İlk olarak, özelliğinde SelectMethod belirtilen ada sahip bir veya daha fazla yöntemi arar. Eşleşme bulunmazsa bir InvalidOperationException özel durum oluşturulur. Eşleşme bulunursa, eşleşen parametre adlarını arar. Örneğin, özelliği tarafından belirtilen bir türün TypeName adlı SelectARecordiki yöntemi olduğunu varsayalım. Birinin SelectARecord bir parametresi ID, diğerinde SelectARecord ise iki parametresi Name vardır ve Number. Koleksiyonun SelectParameters adlı IDtek bir parametresi varsa, SelectARecord yalnızca parametresine ID sahip yöntem çağrılır. Yöntemlerin çözümlenmesinde parametrenin türü denetlenmedi. Parametrelerin sırası önemli değildir.

DataObjectTypeName özelliği ayarlanırsa yöntemi farklı bir şekilde çözümlenir. özelliğinde ObjectDataSource belirtilen ve özelliğinde belirtilen türdeki DataObjectTypeName bir parametreyi SelectMethod alan adlı bir yöntemi arar. Bu durumda, parametrenin adı önemli değildir.

Şunlara uygulanır

Ayrıca bkz.