ObjectDataSource Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een bedrijfsobject dat gegevens levert aan gegevensgebonden besturingselementen in multitier-webtoepassingsarchitecturen.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
    inherit DataSourceControl

Public Class ObjectDataSource
Inherits DataSourceControl

Overname: Object

Control

DataSourceControl
ObjectDataSource

Kenmerken: ToolboxBitmapAttribute

Voorbeelden

In deze sectie ziet u een ObjectDataSource in markering op een .aspx pagina en worden de zakelijke objecten weergegeven waarmee deze werkt. Het voorbeeld is de .aspx pagina. Het bevat een GridView besturingselement dat is gebonden aan een ObjectDataSource besturingselement. De ObjectDataSource besturingselementmarkering geeft de naam van het bedrijfsobject en de naam van de zakelijke objectmethode op die moet worden aangeroepen om gegevens op te halen.

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

In het volgende voorbeeld ziet u het bedrijfsobject dat door het ObjectDataSource besturingselement in de .aspx pagina wordt gebruikt. (Veel andere ObjectDataSource codevoorbeelden gebruiken dit zakelijke object ook.) Het voorbeeld bestaat uit de volgende twee basisklassen:

De EmployeeLogic klasse is de bedrijfslogicaklasse die door de ObjectDataSource klasse wordt gebruikt.
De NorthwindEmployee klasse definieert het gegevensobject dat wordt geretourneerd door de GetAllEmployees methode van de EmployeeLogic klasse.

Er wordt een extra NorthwindDataException klasse aangeboden als gemak.

Deze set voorbeeldklassen werkt met de Northwind Traders-database, die beschikbaar is voor Microsoft SQL Server en Microsoft Access. Voor een volledig werkvoorbeeld moet u deze klassen compileren en gebruiken met het .aspx paginavoorbeeld dat is opgegeven.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations one can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

      try {

        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        foreach (DataRowView row in IDs) {
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }
    public static NorthwindEmployee GetEmployee(object anID) {
      return new NorthwindEmployee(anID);
    }

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

    public static void DeleteEmployee(NorthwindEmployee ne) { }
  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

        SqlConnection conn = new SqlConnection (cts.ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // This is not a while loop. It only loops once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (!sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}

Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
   ' Returns a collection of NorthwindEmployee objects.
   Public Shared Function GetAllEmployees() As ICollection
      Dim al As New ArrayList()

      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
      Try
         Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

         ' Iterate through the Enumeration and create a
         ' NorthwindEmployee object for each ID.
         For Each row As DataRowView In IDs
            Dim id As String = row("EmployeeID").ToString()
            Dim nwe As New NorthwindEmployee(id)
            ' Add the NorthwindEmployee object to the collection.
            al.Add(nwe)
         Next
      Finally
         ' If anything strange happens, clean up.
         sds.Dispose()
      End Try

      Return al
   End Function 'GetAllEmployees

   Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
      Return New NorthwindEmployee(anID)
   End Function 'GetEmployee


   Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
      Dim retval As Boolean = ne.Save()
      If Not retval Then
         Throw New NorthwindDataException("UpdateEmployee failed.")
      End If
   End Sub

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


   Public Sub New()
      ID = DBNull.Value
      aLastName = ""
      aFirstName = ""
      aTitle = ""
      titleOfCourtesy = ""
      reportsTo = - 1
   End Sub


   Public Sub New(anID As Object)
      Me.ID = anID
      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim conn As New SqlConnection(cts.ConnectionString)
      Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
                               " FROM Employees " & _
                               " WHERE EmployeeID = @empId", conn)
      ' Add the employee ID parameter and set its value.
      sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
      Dim sdr As SqlDataReader = Nothing

      Try
         conn.Open()
         sdr = sc.ExecuteReader()

         ' This is not a while loop. It only loops once.
         If Not (sdr Is Nothing) AndAlso sdr.Read() Then
            ' The IEnumerable contains DataRowView objects.
            Me.aFirstName = sdr("FirstName").ToString()
            Me.aLastName = sdr("LastName").ToString()
            Me.aTitle = sdr("Title").ToString()
            Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
            If Not sdr.IsDBNull(4) Then
               Me.reportsTo = sdr.GetInt32(4)
            End If
         Else
            Throw New NorthwindDataException("Data not loaded for employee id.")
         End If
      Finally
         Try
            If Not (sdr Is Nothing) Then
               sdr.Close()
            End If
            conn.Close()
         Catch se As SqlException
            ' Log an event in the Application Event Log.
            Throw
         End Try
      End Try
   End Sub

   Private ID As Object

   Private aLastName As String
   Public Property LastName() As String
      Get
         Return aLastName
      End Get
      Set
         aLastName = value
      End Set
   End Property

   Private aFirstName As String
   Public Property FirstName() As String
      Get
         Return aFirstName
      End Get
      Set
         aFirstName = value
      End Set
   End Property

   Private aTitle As String
   Public Property Title() As String
      Get
         Return aTitle
      End Get
      Set
         aTitle = value
      End Set
   End Property

   Private titleOfCourtesy As String
   Public Property Courtesy() As String
      Get
         Return titleOfCourtesy
      End Get
      Set
         titleOfCourtesy = value
      End Set
   End Property
   Private reportsTo As Integer

   Public Property Supervisor() As Integer
      Get
         Return reportsTo
      End Get
      Set
         reportsTo = value
      End Set
   End Property

   Public Function Save() As Boolean
      Return True
   End Function 'Save
End Class


Friend Class NorthwindDataException
   Inherits Exception

   Public Sub New(msg As String)
      MyBase.New(msg)
   End Sub
End Class
End Namespace

Opmerkingen

In dit onderwerp:

Introduction
Purpose
Gegevens ophalen
Gegevensbewerkingen uitvoeren
gegevens filteren
In het geheugen opslaan
Features
Gegevensweergave
LINQ gebruiken voor SQL
Declaratieve syntaxis

Introduction

Een ObjectDataSource besturingselement werkt met een klasse die u maakt. U maakt methoden waarmee gegevens worden opgehaald en bijgewerkt en u geeft de namen van deze methoden op voor het ObjectDataSource besturingselement in markeringen. Tijdens het verwerken van rendering of postback worden de ObjectDataSource methoden aangeroepen die u hebt opgegeven.

Er is geen visuele weergave van het ObjectDataSource besturingselement. ObjectDataSource Hierdoor worden visuele functies zoals de EnableTheming of SkinID eigenschap niet ondersteund.

Purpose

Een zeer gangbare praktijk voor toepassingsontwerp is het scheiden van de presentatielaag van bedrijfslogica en het inkapselen van de bedrijfslogica in bedrijfsobjecten. Deze zakelijke objecten vormen een afzonderlijke laag tussen de presentatielaag en de gegevenslaag, wat resulteert in een toepassingsarchitectuur met drie lagen. Met het besturingselement ObjectDataSource kunnen ontwikkelaars een ASP.NET gegevensbronbeheer gebruiken en tegelijkertijd hun toepassingsarchitectuur met drie lagen behouden.

Het ObjectDataSource besturingselement maakt gebruik van weerspiegeling voor het maken van exemplaren van zakelijke objecten en het aanroepen van methoden om gegevens op te halen, bij te werken, in te voegen en te verwijderen. De TypeName eigenschap geeft de naam aan van de klasse waarmee de ObjectDataSource klasse werkt. Het ObjectDataSource besturingselement maakt en vernietigt een exemplaar van de klasse voor elke methodeaanroep. Het object wordt gedurende de levensduur van de webaanvraag niet in het geheugen opgeslagen. Dit is een serieuze overweging als het bedrijfsobject dat u gebruikt veel resources vereist of anderszins duur is om te maken en te vernietigen. Het gebruik van een duur object is mogelijk geen optimale ontwerpkeuze, maar u kunt de levenscyclus van het object beheren met behulp van de ObjectCreating, ObjectCreateden ObjectDisposing gebeurtenissen.

Note

De methoden die worden geïdentificeerd door de SelectMethod, UpdateMethod, InsertMethod en DeleteMethod eigenschappen kunnen exemplaarmethoden of static (Shared in Visual Basic) methoden zijn. Als de methoden zijn static (Shared in Visual Basic), wordt er geen exemplaar van het bedrijfsobject gemaakt en worden de gebeurtenissen ObjectCreating, ObjectCreated en ObjectDisposing gebeurtenissen niet gegenereerd.

Gegevens ophalen

Als u gegevens wilt ophalen uit een bedrijfsobject, stelt u de SelectMethod eigenschap in op de naam van de methode waarmee gegevens worden opgehaald. Als de methode geen IEnumerable of DataSet object retourneert, wordt het object verpakt door de runtime in een IEnumerable verzameling. Als de methodehandtekening parameters bevat, kunt u objecten toevoegen Parameter aan de SelectParameters verzameling en deze vervolgens binden aan de waarden die u wilt doorgeven aan de methode die is opgegeven door de SelectMethod eigenschap. Als u wilt dat het ObjectDataSource besturingselement de parameters gebruikt, moeten de parameters overeenkomen met de namen en typen van de parameters in de methodehandtekening. Zie Parameters gebruiken met het besturingselement ObjectDataSource voor meer informatie.

Het ObjectDataSource besturingselement haalt gegevens op wanneer de Select methode wordt aangeroepen. Deze methode biedt programmatische toegang tot de methode die is opgegeven door SelectMethod de eigenschap. De methode die door de SelectMethod eigenschap wordt opgegeven, wordt automatisch aangeroepen door besturingselementen die afhankelijk zijn van de ObjectDataSource methode wanneer de DataBind methode wordt aangeroepen. Als u de DataSourceID eigenschap van een gegevensgebonden besturingselement instelt, wordt het besturingselement indien nodig automatisch gekoppeld aan gegevens uit de gegevensbron. Het instellen van de DataSourceID eigenschap is de aanbevolen methode voor het binden van een ObjectDataSource besturingselement aan een gegevensgebonden besturingselement. U kunt de DataSource eigenschap ook instellen, maar vervolgens moet u de DataBind methode van het gegevensgebonden besturingselement expliciet aanroepen. U kunt de Select methode programmatisch aanroepen om gegevens op te halen.

Zie Binding to Data Using a Data Source Control (Binding to Data Using a Data Source Control) (Binding met gegevens met behulp van een besturingselement voor gegevensbronnen) voor meer informatie over bindingsgegevensgebonden besturingselementen voor besturingselementen voor gegevensbronnen.

Gegevensbewerkingen uitvoeren

Afhankelijk van de mogelijkheden van het bedrijfsobject waarmee het ObjectDataSource besturingselement werkt, kunt u gegevensbewerkingen uitvoeren, zoals updates, invoegingen en verwijderingen. Als u deze gegevensbewerkingen wilt uitvoeren, stelt u de juiste methodenaam en de bijbehorende parameters in voor de bewerking die u wilt uitvoeren. Stel bijvoorbeeld voor een updatebewerking de UpdateMethod eigenschap in op de naam van de bedrijfsobjectmethode waarmee updates worden uitgevoerd en voeg eventuele vereiste parameters toe aan de UpdateParameters verzameling. Als het ObjectDataSource besturingselement is gekoppeld aan een gegevensgebonden besturingselement, worden de parameters toegevoegd door het besturingselement voor gegevens. In dit geval moet u ervoor zorgen dat de parameternamen van de methode overeenkomen met de veldnamen in het gegevensgebonden besturingselement. De update wordt uitgevoerd wanneer de Update methode wordt aangeroepen, expliciet door uw code of automatisch door een gegevensgebonden besturingselement. Hetzelfde algemene patroon wordt gevolgd voor Delete en Insert bewerkingen. Voor zakelijke objecten wordt ervan uitgegaan dat deze typen gegevensbewerkingen één record tegelijk worden uitgevoerd in plaats van batchgewijs.

Gegevens filteren

Het ObjectDataSource besturingselement kan gegevens filteren die door de SelectMethod eigenschap worden opgehaald, als de gegevens worden geretourneerd als een DataSet of DataTable object. U kunt de FilterExpression eigenschap instellen op een filterexpressie met behulp van een syntaxis van een notatietekenreeks en waarden in de expressie binden aan parameters die zijn opgegeven in de FilterParameters verzameling.

Caching

Hoewel het ObjectDataSource exemplaar van het bedrijfsobject niet in meerdere aanvragen wordt bewaard, kan het het resultaat van het aanroepen van de methode die door de eigenschap is geïdentificeerd, in de SelectMethod cache opslaan. Terwijl de gegevens in de cache worden opgeslagen, retourneren volgende aanroepen naar de methode de gegevens in de Select cache in plaats van het bedrijfsobject te maken en het aan te roepen SelectMethod met behulp van weerspiegeling. Met caching kunt u voorkomen dat u het object maakt en de bijbehorende gegevensmethode aanroept ten koste van het geheugen op de webserver. De ObjectDataSource gegevens worden automatisch in de cache opgeslagen wanneer de EnableCaching eigenschap is ingesteld trueop en de CacheDuration eigenschap wordt ingesteld op het aantal seconden dat de cache gegevens opslaat voordat de cache wordt verwijderd. U kunt ook een CacheExpirationPolicy eigenschap en een optionele SqlCacheDependency eigenschap opgeven. Met het ObjectDataSource besturingselement kunt u alle typen gegevens in de cache opslaan, maar u moet geen objecten opslaan die resources of statussen bewaren die niet kunnen worden gedeeld voor meerdere aanvragen (bijvoorbeeld een geopend SqlDataReader object), omdat hetzelfde exemplaar van het object wordt gebruikt om meerdere aanvragen te verwerken.

Features

In de volgende tabel worden de functies van het ObjectDataSource besturingselement beschreven.

Capability	Vereisten
Selecteren	Stel de SelectMethod eigenschap in op de naam van de bedrijfsobjectmethode waarmee gegevens worden geselecteerd en neem eventuele benodigde parameters op in de SelectParameters verzameling via een programma of met behulp van een besturingselement voor gegevens.
Sorteervolgorde	Stel de SortParameterName eigenschap in op de naam van de parameter in de SelectMethod methode die de sorteercriteria bevat.
Filteren	Stel de FilterExpression eigenschap in op een filterexpressie en voeg eventueel parameters toe aan de FilterParameters verzameling om de gegevens te filteren wanneer de Select methode wordt aangeroepen. De methode die door de SelectMethod eigenschap is opgegeven, moet een DataSet of DataTable.
Paging	Pagering van gegevensbronnen wordt ondersteund als de SelectMethod methode parameters bevat voor het maximum aantal records dat moet worden opgehaald en de index van de eerste record die moet worden opgehaald. De namen van deze parameters moeten respectievelijk worden ingesteld in de MaximumRowsParameterName en StartRowIndexParameterName eigenschappen. Een gegevensgebonden besturingselement kan mogelijk paging zelf uitvoeren, zelfs als het ObjectDataSource besturingselement geen ondersteuning biedt voor paging rechtstreeks in de methode die is opgegeven door de SelectMethod eigenschap. De vereiste voor het gegevensgebonden besturingselement om dit te kunnen doen, is dat de methode die is opgegeven door de SelectMethod eigenschap een object retourneert dat de ICollection interface implementeert.
Bijwerken	Stel de UpdateMethod eigenschap in op de naam van de bedrijfsobjectmethode waarmee gegevens worden bijgewerkt en voeg de benodigde parameters in de UpdateParameters verzameling toe.
Verwijderen	Stel de DeleteMethod eigenschap in op de naam van de bedrijfsobjectmethode of -functie waarmee gegevens worden verwijderd en neem eventuele benodigde parameters op in de DeleteParameters verzameling.
Invoegen	Stel de InsertMethod eigenschap in op de naam van de bedrijfsobjectmethode of -functie waarmee gegevens worden ingevoegd en voeg de benodigde parameters in de InsertParameters verzameling toe.
Caching	Stel de EnableCaching eigenschap in op `true`en de CacheDuration eigenschappen CacheExpirationPolicy op basis van het cachegedrag dat u wilt gebruiken voor uw gegevens in de cache.

Note

Wanneer u de ObjectDataSource klasse gebruikt om gegevens bij te werken of in te voegen, worden tekenreeksen die op de client worden ingevoerd, niet automatisch geconverteerd van de clientcultuurindeling naar de servercultuurindeling. De clientcultuur kan bijvoorbeeld DD/MM/JJJJ opgeven als datumnotatie en de datumnotatie op de server kan MM/DD/JJJJ zijn. In dat geval zou 5 oktober 2009 in een TextBox besturingselement worden ingevoerd als 10-5-2009, maar zou worden geïnterpreteerd als 10 mei 2009. 15 oktober 2009 wordt ingevoerd als 15-10-2009 en wordt geweigerd als een ongeldige datum.

Gegevensweergave

Net als bij alle besturingselementen voor gegevensbronnen wordt het ObjectDataSource besturingselement gekoppeld aan een gegevensbronweergaveklasse. Hoewel het ObjectDataSource besturingselement de interface is waarmee de ontwikkelaar van de pagina werkt met gegevens, is de ObjectDataSourceView klasse de interface waarmee gegevensgebonden besturingselementen werken. Daarnaast beschrijft de ObjectDataSourceView klasse de mogelijkheden van het besturingselement voor gegevensbronnen en voert de werkelijke hoeveelheid werk uit. Het ObjectDataSource besturingselement heeft slechts één gekoppeld ObjectDataSourceView, en het heeft altijd de naam DefaultView. Hoewel het ObjectDataSourceView object door de GetView methode wordt weergegeven, worden veel van de eigenschappen en methoden ervan verpakt en rechtstreeks door het ObjectDataSource besturingselement weergegeven. Achter de schermen voert het ObjectDataSourceView object alle gegevensbewerkingen uit, waaronder het ophalen, invoegen, bijwerken, verwijderen, filteren en sorteren van de gegevens. Zie ObjectDataSourceView voor meer informatie.

LINQ gebruiken voor SQL

U kunt het ObjectDataSource besturingselement gebruiken met een LINQ naar SQL-klasse. Hiervoor stelt u de TypeName eigenschap in op de naam van de gegevenscontextklasse. U stelt ook de SelectMethodmethoden , UpdateMethoden InsertMethod DeleteMethod methoden in op de methoden in de gegevenscontextklasse waarmee de bijbehorende bewerkingen worden uitgevoerd. U moet een gebeurtenis-handler voor de ObjectDisposing gebeurtenis maken om het verwijderen van de gegevenscontextklasse te annuleren. Deze stap is nodig omdat LINQ naar SQL ondersteuning biedt voor uitgestelde uitvoering, terwijl het ObjectDataSource besturingselement de gegevenscontext na de selectiebewerking probeert te verwijderen. Zie Hoe to: LINQ maken voor SQL-klassen in een web Project voor meer informatie over het maken van LINQ naar SQL-klassen. Zie de ObjectDisposing gebeurtenis voor een voorbeeld van het annuleren van het verwijderen van een gegevenscontextklasse.

Entity Framework gebruiken

U kunt het ObjectDataSource besturingselement ook gebruiken met entity framework. Zie Het Entity Framework en het ObjectDataSource-besturingselement gebruiken voor meer informatie.

Declaratieve syntaxis

<asp:ObjectDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConvertNullToDBNull="True|False"
    DataObjectTypeName="string"
    DeleteMethod="string"
    EnableCaching="True|False"
    EnablePaging="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertMethod="string"
    MaximumRowsParameterName="string"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnObjectCreated="ObjectCreated event handler"
    OnObjectCreating="ObjectCreating event handler"
    OnObjectDisposing="ObjectDisposing event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    runat="server"
    SelectCountMethod="string"
    SelectMethod="string"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    StartRowIndexParameterName="string"
    TypeName="string"
    UpdateMethod="string"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:ObjectDataSource>

Constructors

Name	Description
ObjectDataSource()	Initialiseert een nieuw exemplaar van de ObjectDataSource klasse.
ObjectDataSource(String, String)	Initialiseert een nieuw exemplaar van de ObjectDataSource klasse met de opgegeven typenaam en de naam van de methode voor het ophalen van gegevens.

Eigenschappen

Name	Description
Adapter	Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control)
AppRelativeTemplateSourceDirectory	Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control)
BindingContainer	Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control)
CacheDuration	Hiermee wordt de tijdsduur opgehaald of ingesteld, in seconden, dat met het gegevensbronbeheer gegevens worden opgeslagen die door de SelectMethod eigenschap worden opgehaald.
CacheExpirationPolicy	Hiermee wordt het verloopgedrag van de cache opgehaald of ingesteld dat, in combinatie met de duur, het gedrag beschrijft van de cache die door het gegevensbronbeheer wordt gebruikt.
CacheKeyDependency	Hiermee haalt u een door de gebruiker gedefinieerde sleutelafhankelijkheid op die is gekoppeld aan alle gegevenscacheobjecten die zijn gemaakt door het besturingselement voor de gegevensbron.
ChildControlsCreated	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control)
ClientID	Hiermee haalt u de serverbesturings-id op die is gegenereerd door ASP.NET. (Overgenomen van DataSourceControl)
ClientIDMode	Deze eigenschap wordt niet gebruikt voor besturingselementen voor gegevensbronnen. (Overgenomen van DataSourceControl)
ClientIDSeparator	Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control)
ConflictDetection	Hiermee wordt een waarde opgehaald of ingesteld die bepaalt of alleen de nieuwe waarden worden doorgegeven aan de `Update` methode, of zowel de oude als de nieuwe waarden worden doorgegeven aan de `Update` methode.
Context	Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control)
Controls	Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van DataSourceControl)
ConvertNullToDBNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Parameter waarden die worden doorgegeven aan een update-, invoeg- of verwijderbewerking automatisch worden geconverteerd van `null` de waarde naar de Value waarde door het ObjectDataSource besturingselement.
DataItemContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control)
DataKeysContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control)
DataObjectTypeName	Hiermee haalt u de naam op van een klasse die door het ObjectDataSource besturingselement wordt gebruikt voor een parameter in een bijwerk-, invoeg- of verwijdergegevensbewerking, in plaats van afzonderlijke waarden door te geven uit het besturingselement voor gegevens.
DeleteMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSource besturingselement wordt aangeroepen om gegevens te verwijderen.
DeleteParameters	Hiermee haalt u de verzameling parameters op die de parameters bevat die door de DeleteMethod methode worden gebruikt.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control)
EnableCaching	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het ObjectDataSource besturingselement gegevenscache heeft ingeschakeld.
EnablePaging	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement van de gegevensbron paging ondersteunt via de set gegevens die worden opgehaald.
EnableTheming	Hiermee wordt een waarde opgehaald die aangeeft of dit besturingselement thema's ondersteunt. (Overgenomen van DataSourceControl)
EnableViewState	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control)
Events	Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control)
FilterExpression	Hiermee haalt u een filterexpressie op die wordt toegepast wanneer de methode die is opgegeven door de SelectMethod eigenschap wordt aangeroepen.
FilterParameters	Hiermee haalt u een verzameling parameters op die zijn gekoppeld aan tijdelijke aanduidingen voor parameters in de FilterExpression tekenreeks.
HasChildViewState	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control)
ID	Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control)
IdSeparator	Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control)
InsertMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSource besturingselement wordt aangeroepen om gegevens in te voegen.
InsertParameters	Hiermee haalt u de verzameling parameters op die de parameters bevat die door de InsertMethod eigenschap worden gebruikt.
IsChildControlStateCleared	Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control)
IsViewStateEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control)
LoadViewStateByID	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control)
MaximumRowsParameterName	Hiermee haalt u de naam op van de methodeparameter voor het ophalen van zakelijke objectgegevens die wordt gebruikt om het aantal records aan te geven dat moet worden opgehaald voor ondersteuning voor paging van gegevensbronnen.
NamingContainer	Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control)
OldValuesParameterFormatString	Hiermee haalt u een notatietekenreeks op die moet worden toegepast op de namen van de parameters voor oorspronkelijke waarden die worden doorgegeven aan de `Delete` of `Update` methoden.
Page	Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control)
Parent	Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control)
ParsingCulture	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft welke cultuurgegevens worden gebruikt bij het converteren van tekenreekswaarden naar werkelijke eigenschapstypen om een object van het type te maken dat wordt aangegeven door DataObjectTypeName.
RenderingCompatibility	Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control)
SelectCountMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSource besturingselement wordt aangeroepen om het aantal rijen op te halen.
SelectMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSource besturingselement wordt aangeroepen om gegevens op te halen.
SelectParameters	Hiermee haalt u een verzameling parameters op die worden gebruikt door de methode die is opgegeven door de SelectMethod eigenschap.
Site	Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control)
SkinID	Hiermee wordt de huid op de DataSourceControl controle toegepast. (Overgenomen van DataSourceControl)
SortParameterName	Hiermee haalt u de naam op van het bedrijfsobject dat door de SelectMethod parameter wordt gebruikt voor het opgeven van een sorteerexpressie voor de ondersteuning voor het sorteren van gegevensbronnen.
SqlCacheDependency	Hiermee haalt u een door puntkomma's gescheiden tekenreeks op die aangeeft welke databases en tabellen moeten worden gebruikt voor de Microsoft SQL Server cacheafhankelijkheid.
StartRowIndexParameterName	Hiermee haalt u de naam op van de parameter voor de methode voor het ophalen van gegevens die wordt gebruikt om de waarde van de id van de eerste record aan te geven die moet worden opgehaald voor ondersteuning voor pagineering van gegevensbronnen.
TemplateControl	Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control)
TemplateSourceDirectory	Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control)
TypeName	Hiermee wordt de naam opgehaald of ingesteld van de klasse die het ObjectDataSource object vertegenwoordigt.
UniqueID	Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control)
UpdateMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSource besturingselement wordt aangeroepen om gegevens bij te werken.
UpdateParameters	Hiermee haalt u de verzameling parameters op die de parameters bevat die worden gebruikt door de methode die is opgegeven door de UpdateMethod eigenschap.
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control)
ViewStateIgnoresCase	Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control)
ViewStateMode	Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement visueel wordt weergegeven. (Overgenomen van DataSourceControl)

Methoden

Name	Description
AddedControl(Control, Int32)	Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control)
AddParsedSubObject(Object)	Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control)
ApplyStyleSheetSkin(Page)	De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control)
BuildProfileTree(String, Boolean)	Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control)
ClearCachedClientID()	Hiermee stelt u de waarde in de cache in ClientID op `null`. (Overgenomen van Control)
ClearChildControlState()	Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildState()	Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildViewState()	Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearEffectiveClientIDMode()	Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control)
CreateChildControls()	Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control)
CreateControlCollection()	Hiermee maakt u een verzameling voor het opslaan van onderliggende besturingselementen. (Overgenomen van DataSourceControl)
DataBind()	Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control)
DataBind(Boolean)	Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control)
DataBindChildren()	Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
Delete()	Voert een verwijderbewerking uit door de methode aan te roepen die wordt geïdentificeerd door de DeleteMethod eigenschap met parameters die zich in de DeleteParameters verzameling bevinden.
Dispose()	Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control)
EndRenderTracing(TextWriter, Object)	Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control)
EnsureChildControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control)
EnsureID()	Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindControl(String, Int32)	Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven `id` in de `pathOffset` parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven. (Overgenomen van Control)
FindControl(String)	Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven `id` parameter. (Overgenomen van DataSourceControl)
Focus()	Hiermee stelt u de invoerfocus in op het besturingselement. (Overgenomen van DataSourceControl)
GetDesignModeState()	Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetRouteUrl(Object)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(String, Object)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUniqueIDRelativeTo(Control)	Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control)
GetView(String)	Hiermee haalt u de benoemde gegevensbronweergave op die is gekoppeld aan het besturingselement voor de gegevensbron.
GetViewNames()	Hiermee haalt u een verzameling namen op die de lijst met weergaveobjecten vertegenwoordigen die aan het ObjectDataSource object zijn gekoppeld.
HasControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van DataSourceControl)
HasEvents()	Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control)
Insert()	Voert een invoegbewerking uit door de methode aan te roepen die wordt geïdentificeerd door de InsertMethod eigenschap en eventuele parameters in de InsertParameters verzameling.
IsLiteralContent()	Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control)
LoadControlState(Object)	Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control)
LoadViewState(Object)	Laadt de eerder opgeslagen weergavestatus van het ObjectDataSource besturingselement.
MapPathSecure(String)	Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnBubbleEvent(Object, EventArgs)	Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control)
OnDataBinding(EventArgs)	Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control)
OnInit(EventArgs)	Hiermee voegt u een LoadComplete gebeurtenis-handler toe aan de pagina die het ObjectDataSource besturingselement bevat.
OnLoad(EventArgs)	Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control)
OnPreRender(EventArgs)	Hiermee wordt de PreRender gebeurtenis gegenereerd. (Overgenomen van Control)
OnUnload(EventArgs)	Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control)
OpenFile(String)	Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control)
RaiseBubbleEvent(Object, EventArgs)	Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control)
RaiseDataSourceChangedEvent(EventArgs)	Hiermee wordt de DataSourceChanged gebeurtenis gegenereerd. (Overgenomen van DataSourceControl)
RemovedControl(Control)	Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control)
Render(HtmlTextWriter)	Verzendt inhoud van serverbeheer naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderChildren(HtmlTextWriter)	Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderControl(HtmlTextWriter, ControlAdapter)	De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control)
RenderControl(HtmlTextWriter)	Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van DataSourceControl)
ResolveAdapter()	Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control)
ResolveClientUrl(String)	Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control)
ResolveUrl(String)	Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control)
SaveControlState()	Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SaveViewState()	Hiermee wordt de status van het ObjectDataSource besturingselement opgeslagen.
Select()	Haalt gegevens op uit de onderliggende gegevensopslag door de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap met de parameters in de SelectParameters verzameling.
SetDesignModeState(IDictionary)	Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control)
SetRenderMethodDelegate(RenderMethod)	Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control)
SetTraceData(Object, Object, Object)	Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
SetTraceData(Object, Object)	Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee worden wijzigingen in de weergavestatus bijgehouden in het ObjectDataSource besturingselement, zodat ze in het StateBag object kunnen worden opgeslagen.
Update()	Voert een updatebewerking uit door de methode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap en parameters die zich in de UpdateParameters verzameling bevinden.

gebeurtenis

Name	Description
DataBinding	Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control)
Deleted	Vindt plaats wanneer een Delete() bewerking is voltooid.
Deleting	Vindt plaats vóór een Delete() bewerking.
Disposed	Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control)
Filtering	Vindt plaats vóór een filterbewerking.
Init	Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control)
Inserted	Treedt op wanneer een Insert() bewerking is voltooid.
Inserting	Vindt plaats vóór een Insert() bewerking.
Load	Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control)
ObjectCreated	Vindt plaats nadat het object dat wordt geïdentificeerd door de TypeName eigenschap is gemaakt.
ObjectCreating	Vindt plaats voordat het object dat wordt geïdentificeerd door de TypeName eigenschap wordt gemaakt.
ObjectDisposing	Vindt plaats voordat het object dat wordt geïdentificeerd door de TypeName eigenschap wordt verwijderd.
PreRender	Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control)
Selected	Vindt plaats wanneer een Select() bewerking is voltooid.
Selecting	Vindt plaats vóór een Select() bewerking.
Unload	Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control)
Updated	Treedt op wanneer een Update() bewerking is voltooid.
Updating	Vindt plaats vóór een Update() bewerking.

Expliciete interface-implementaties

Name	Description
IControlBuilderAccessor.ControlBuilder	Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()	Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control)
IControlDesignerAccessor.UserData	Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control)
IDataBindingsAccessor.DataBindings	Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings	Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control)
IDataSource.DataSourceChanged	Treedt op wanneer een besturingselement voor gegevensbronnen is gewijzigd op een manier die van invloed is op gegevensgebonden besturingselementen. (Overgenomen van DataSourceControl)
IDataSource.GetView(String)	Hiermee wordt het benoemde DataSourceView object opgehaald dat aan het DataSourceControl besturingselement is gekoppeld. Sommige besturingselementen voor gegevensbronnen ondersteunen slechts één weergave, terwijl andere meer dan één weergave ondersteunen. (Overgenomen van DataSourceControl)
IDataSource.GetViewNames()	Hiermee haalt u een verzameling namen op die de lijst DataSourceView met objecten vertegenwoordigen die aan het DataSourceControl besturingselement zijn gekoppeld. (Overgenomen van DataSourceControl)
IExpressionsAccessor.Expressions	Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control)
IExpressionsAccessor.HasExpressions	Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control)
IListSource.ContainsListCollection	Geeft aan of het besturingselement voor de gegevensbron is gekoppeld aan een of meer lijsten met gegevens. (Overgenomen van DataSourceControl)
IListSource.GetList()	Hiermee haalt u een lijst met besturingselementen voor gegevensbronnen op die kunnen worden gebruikt als bronnen van lijsten met gegevens. (Overgenomen van DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control)

Extensiemethoden

Name	Description
FindDataSourceControl(Control)	Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.
FindFieldTemplate(Control, String)	Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.
FindMetaTable(Control)	Retourneert het metatable-object voor het bevattende gegevensbeheer.
GetDefaultValues(IDataSource)	Hiermee haalt u de verzameling van de standaardwaarden voor de opgegeven gegevensbron op.
GetMetaTable(IDataSource)	Haalt de metagegevens op voor een tabel in het opgegeven gegevensbronobject.
TryGetMetaTable(IDataSource, MetaTable)	Bepaalt of tabelmetagegevens beschikbaar zijn.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?