ObjectDataSource.SelectMethod Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 GridView ObjectDataSource 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 TypeName SelectMethod 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 DataTable DataSet 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

Aracılığıyla paylaş