ObjectDataSourceView.SelectMethod Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView besturingselement wordt aangeroepen om gegevens op te halen.

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

Waarde van eigenschap

String

Een tekenreeks die de naam vertegenwoordigt van de methode of functie die wordt ObjectDataSourceView gebruikt om gegevens op te halen. De standaardwaarde is een lege tekenreeks ("").

Voorbeelden

In het volgende codevoorbeeld ziet u hoe een GridView besturingselement gegevens kan weergeven met behulp van een ObjectDataSource besturingselement op een webpagina met webformulieren. Hiermee ObjectDataSource wordt een gedeeltelijk of volledig gekwalificeerde klassenaam geïdentificeerd met de TypeName eigenschap en een methode die wordt aangeroepen om gegevens op te halen met de SelectMethod eigenschap. Tijdens runtime wordt het object gemaakt en wordt de methode aangeroepen met behulp van weerspiegeling. Het GridView besturingselement inventariseert de IEnumerable verzameling die wordt geretourneerd door de SelectMethoden geeft vervolgens de gegevens weer.

<%@ 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>

Opmerkingen

De opgegeven methode kan elke methodehandtekening hebben, maar moet een van de typen retourneren die in de volgende tabel worden vermeld, zodat het ObjectDataSource besturingselement deze kan aanroepen

Terugbrengtype Action
IEnumerable De IEnumerable waarde wordt geretourneerd door de Select methode.
DataTable Er wordt een DataView gemaakt met behulp van de DataTable en geretourneerde Select methode.
DataSet De eerste DataTable is DataSet geëxtraheerd en er wordt een DataView gemaakt en geretourneerd door de Select methode.
Object Het object wordt verpakt in een één element IEnumerable en geretourneerd door de Select methode.

De methode die wordt geïdentificeerd door de eigenschap SelectMethod kan een instantiemethode of een methode static (Shared in Visual Basic) zijn. Als het een instantiemethode is, wordt het bedrijfsobject gemaakt en vernietigd telkens wanneer de SelectMethod methode wordt aangeroepen. U kunt de ObjectCreated gebeurtenis afhandelen om met het bedrijfsobject te werken voordat de methode die is opgegeven door de SelectMethod eigenschap wordt aangeroepen. U kunt ook de ObjectDisposing gebeurtenis afhandelen die wordt gegenereerd nadat de methode die is opgegeven door de SelectMethod eigenschap is aangeroepen. (Dispose wordt alleen aangeroepen als het bedrijfsobject de interface IDisposable implementeert.) Als de methode een methode static (Shared in Visual Basic) is, wordt het bedrijfsobject nooit gemaakt en kunt u deze gebeurtenissen niet afhandelen.

Als het bedrijfsobject waarmee het ObjectDataSource besturingselement werkt meer dan één methode of functie met dezelfde naam implementeert (overbelasting van methode), probeert het besturingselement voor gegevensbronnen de juiste methode aan te roepen volgens een set voorwaarden, inclusief de parameters in de SelectParameters verzameling. Als de parameters in de SelectParameters verzameling niet overeenkomen met de parameters van de handtekening van de methode die is opgegeven door de SelectMethod eigenschap, genereert de gegevensbron een uitzondering.

Zie ObjectDataSource.SelectMethod voor meer informatie.

Van toepassing op

Zie ook