ObjectDataSourceView.SelectMethod Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView kontrollen anropar för att hämta data.

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

Egenskapsvärde

String

En sträng som representerar namnet på den metod eller funktion som ObjectDataSourceView används för att hämta data. Standardvärdet är en tom sträng ("").

Exempel

Följande kodexempel visar hur en GridView kontroll kan visa data med hjälp av en ObjectDataSource kontroll på en webbformulärsida. ObjectDataSource Identifierar ett delvis eller fullständigt kvalificerat klassnamn med dess TypeName egenskap och en metod som anropas för att hämta data med dess SelectMethod egenskap. Vid körning skapas objektet och metoden anropas med reflektion. Kontrollen GridView räknas upp via samlingen IEnumerable som returneras av SelectMethodoch visar sedan data.

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

Kommentarer

Den angivna metoden kan ha valfri metodsignatur men måste returnera någon av de typer som anges i följande tabell för att kontrollen ska kunna anropa den ObjectDataSource

Returtyp Action
IEnumerable IEnumerable Returneras av Select metoden .
DataTable En DataView skapas med hjälp av DataTable och returneras av Select metoden.
DataSet Den första DataTable av DataSet extraheras och en DataView skapas och returneras av Select metoden.
Object Objektet omsluts i ett ett-element IEnumerable och returneras av Select metoden.

Den metod som identifieras av egenskapen SelectMethod kan vara en instansmetod eller en static -metod (Shared i Visual Basic). Om det är en instansmetod skapas och förstörs affärsobjektet varje gång SelectMethod metoden anropas. Du kan hantera ObjectCreated händelsen för att arbeta med affärsobjektet innan den metod som anges av SelectMethod egenskapen anropas. Du kan också hantera händelsen ObjectDisposing som utlöses efter att den metod som anges av SelectMethod egenskapen anropas. (Dispose anropas endast om affärsobjektet implementerar gränssnittet IDisposable.) Om metoden är en static-metod (Shared i Visual Basic) skapas aldrig affärsobjektet och du kan inte hantera dessa händelser.

Om affärsobjektet som ObjectDataSource kontrollen fungerar med implementerar mer än en metod eller funktion med samma namn (metoden överbelastas) försöker datakällkontrollen anropa rätt enligt en uppsättning villkor, inklusive parametrarna i SelectParameters samlingen. Om parametrarna SelectParameters i samlingen inte matchar dem för signaturen för den metod som anges av SelectMethod egenskapen genererar datakällan ett undantag.

Mer information finns i ObjectDataSource.SelectMethod.

Gäller för

Se även