ObjectDataSource Klasse

Definition

Stellt ein Geschäftsobjekt dar, das Daten zu datengebundenen Steuerelementen in Webanwendungsarchitekturen mit mehreren Ebenen bereitstellt.Represents a business object that provides data to data-bound controls in multitier Web application architectures.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl
type ObjectDataSource = class
    inherit DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Vererbung
ObjectDataSource
Attribute

Beispiele

Für dieses Thema steht ein Visual Studio-Website Projekt mit Quellcode zur Verfügung: Herunterladen.A Visual Studio Web site project with source code is available to accompany this topic: Download.

In diesem Abschnitt wird ObjectDataSource ein in Markup auf einer ASPX-Seite angezeigt, und es werden die Geschäftsobjekte angezeigt, mit denen es arbeitet.This section shows an ObjectDataSource in markup in an .aspx page and it shows the business objects that it works with. Das Beispiel ist die ASPX-Seite.The example is the .aspx page. Sie enthält ein GridView Steuerelement, das an ein ObjectDataSource -Steuerelement gebunden ist.It contains a GridView control that is bound to an ObjectDataSource control. Das ObjectDataSource -Steuerelement Markup gibt den Namen des Geschäftsobjekts und den Namen der aufzurufenden Geschäftsobjekt Methode an, um Daten abzurufen.The ObjectDataSource control markup specifies the name of the business object and the name of the business object method to call in order to retrieve 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>

Das folgende Beispiel zeigt das Geschäftsobjekt, das ObjectDataSource das-Steuerelement in der ASPX-Seite verwendet.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (In vielen ObjectDataSource anderen Codebeispielen wird auch dieses Geschäftsobjekt verwendet.) Das Beispiel besteht aus den folgenden beiden grundlegenden Klassen:(Many other ObjectDataSource code examples use this business object also.) The example consists of the following two basic classes:

  • Die EmployeeLogic -Klasse ist die Geschäftslogik Klasse, ObjectDataSource die von verwendet wird.The EmployeeLogic class is the business logic class that the ObjectDataSource uses.

  • Die NorthwindEmployee -Klasse definiert das Datenobjekt, das von der GetAllEmployees -Methode der EmployeeLogic -Klasse zurückgegeben wird.The NorthwindEmployee class defines the data object that is returned by the GetAllEmployees method of the EmployeeLogic class.

Eine zusätzliche NorthwindDataException Klasse wird zur einfacheren Bereitstellung bereitgestellt.An additional NorthwindDataException class is provided as a convenience.

Diese Gruppe von Beispiel Klassen funktioniert mit der Northwind Traders-Datenbank, die mit Microsoft SQL Server und Microsoft Access verfügbar ist.This set of example classes works with the Northwind Traders database, which is available with Microsoft SQL Server and Microsoft Access. Ein umfassendes, funktionierendes Beispiel ist die Kompilierung und Verwendung dieser Klassen mit dem bereitgestellten ASPX-Seiten Beispiel.For a complete working example, you must compile and use these classes with the .aspx page example that is provided. Informationen zum Installieren der Northwind Traders-Datenbank finden Sie unter Gewusst wie: Installieren Sie BeispielDatenbanken.For information about how to install the Northwind Traders database, see How to: Install Sample Databases.

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

Hinweise

In diesem Thema:In this topic:

EinführungIntroduction

Ein ObjectDataSource -Steuerelement funktioniert mit einer Klasse, die Sie erstellen.An ObjectDataSource control works with a class that you create. Sie erstellen Methoden, mit ObjectDataSource denen Daten abgerufen und aktualisiert werden, und geben dem Steuerelement im Markup die Namen dieser Methoden.You create methods that retrieve and update data, and you provide the names of those methods to the ObjectDataSource control in markup. Während der Rendering-oder Postback Verarbeitung ObjectDataSource Ruft die Methoden auf, die Sie angegeben haben.During rendering or postback processing, the ObjectDataSource calls the methods that you have specified.

Es gibt kein visuelles Rendering des ObjectDataSource Steuer Elements.There is no visual rendering of the ObjectDataSource control. Daher unterstützt das ObjectDataSource keine visuellen Funktionen, wie z. b. die-Eigenschaft oder SkinID die EnableTheming -Eigenschaft.As a result, the ObjectDataSource does not support visual features such as the EnableTheming or SkinID property.

ZweckPurpose

Ein gängiges Anwendungs Entwurfsverfahren besteht darin, die Darstellungs Schicht von der Geschäftslogik zu trennen und die Geschäftslogik in Geschäftsobjekten zu kapseln.A very common application design practice is to separate the presentation layer from business logic and to encapsulate the business logic in business objects. Diese Geschäftsobjekte bilden eine eindeutige Ebene zwischen der Darstellungs Schicht und der Datenebene, was zu einer dreistufigen Anwendungsarchitektur führt.These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. Das ObjectDataSource -Steuerelement ermöglicht es Entwicklern, ein ASP.NET-Datenquellen Steuerelement zu verwenden, während die dreistufige Anwendungsarchitektur beibehalten wird.The ObjectDataSource control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.

Das ObjectDataSource -Steuerelement verwendet Reflektion, um Instanzen von Geschäftsobjekten zu erstellen und Methoden zum Abrufen, aktualisieren, einfügen und Löschen von Daten aufzurufen.The ObjectDataSource control uses reflection to create instances of business objects and to call methods on them to retrieve, update, insert, and delete data. Die TypeName -Eigenschaft identifiziert den Namen der Klasse, mit ObjectDataSource der der arbeitet.The TypeName property identifies the name of the class that the ObjectDataSource works with. Das ObjectDataSource -Steuerelement erstellt und zerstört eine Instanz der-Klasse für jeden Methoden aufzurufen. das-Objekt ist für die Lebensdauer der Webanforderung nicht im Arbeitsspeicher enthalten.The ObjectDataSource control creates and destroys an instance of the class for each method call; it does not hold the object in memory for the lifetime of the Web request. Dies ist ein schwerwiegender Aspekt, wenn das Geschäftsobjekt, das Sie verwenden, viele Ressourcen erfordert oder anderweitig kostenaufwendig erstellt und zerstört werden.This is a serious consideration if the business object that you use requires many resources or is otherwise expensive to create and destroy. Die Verwendung eines teuren Objekts ist möglicherweise nicht optimal, aber Sie können den Lebenszyklus des Objekts steuern, indem Sie die ObjectCreatingEreignisse, ObjectCreatedund ObjectDisposing verwenden.Using an expensive object might not be an optimal design choice, but you can control the life cycle of the object by using the ObjectCreating, ObjectCreated, and ObjectDisposing events.

Hinweis

Die Methoden, die durch SelectMethoddie Eigenschaften, UpdateMethod, InsertMethodund identifiziert werden, können Instanzmethoden oderShared static (in Visual Basic)- DeleteMethod Methoden sein.The methods that are identified by the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod properties can be instance methods or static (Shared in Visual Basic) methods. Wenn die Methoden ( static Shared in Visual Basic) sind, wird keine Instanz des Geschäftsobjekts erstellt, und die ObjectCreating-, ObjectCreated-und- ObjectDisposing Ereignisse werden nicht ausgelöst.If the methods are static (Shared in Visual Basic), an instance of the business object is not created, and the ObjectCreating, ObjectCreated, and ObjectDisposing events are not raised.

Abrufen von DatenRetrieving Data

Um Daten aus einem Geschäftsobjekt abzurufen, legen Sie SelectMethod die-Eigenschaft auf den Namen der Methode fest, mit der Daten abgerufen werden.To retrieve data from a business object, set the SelectMethod property to the name of the method that retrieves data. Wenn die Methode kein-Objekt IEnumerable oder DataSet -Objekt zurückgibt, wird das-Objekt von der Common IEnumerable Language Runtime in einer-Auflistung umschließt.If the method does not return an IEnumerable or DataSet object, the object is wrapped by the runtime in an IEnumerable collection. Wenn die Methoden Signatur über Parameter verfügt, können Sie Parameter der SelectParameters Auflistung Objekte hinzufügen und diese dann an die Werte binden, die an die von der SelectMethod -Eigenschaft angegebene Methode übergeben werden sollen.If the method signature has parameters, you can add Parameter objects to the SelectParameters collection, and then bind them to the values that you want to pass to the method that is specified by the SelectMethod property. Damit das ObjectDataSource Steuerelement die Parameter verwenden kann, müssen die Parameter mit den Namen und Typen der Parameter in der Methoden Signatur identisch sein.In order for the ObjectDataSource control to use the parameters, the parameters must match the names and types of the parameters in the method signature. Weitere Informationen finden Sie unter Verwenden von Parametern mit dem ObjectDataSource-SteuerElement.For more information, see Using Parameters with the ObjectDataSource Control.

Wenn ObjectDataSource dieSelect -Methode aufgerufen wird, ruft das-Steuerelement Daten ab.The ObjectDataSource control retrieves data whenever the Select method is called. Diese Methode ermöglicht programmgesteuerten Zugriff auf die Methode, die durch SelectMethod die-Eigenschaft angegeben wird.This method provides programmatic access to the method that is specified by SelectMethod property. Die Methode, die von der SelectMethod -Eigenschaft angegeben wird, wird automatisch von Steuerelementen aufgerufen, die ObjectDataSource an DataBind gebunden sind, wenn Ihre-Methode aufgerufen wird.The method that is specified by the SelectMethod property is called automatically by controls that are bound to the ObjectDataSource when their DataBind method is called. Wenn Sie die DataSourceID -Eigenschaft eines Daten gebundenen Steuer Elements festlegen, wird das-Steuerelement bei Bedarf automatisch an Daten aus der Datenquelle gebunden.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. Das Festlegen DataSourceID der-Eigenschaft ist die empfohlene Methode zum ObjectDataSource Binden eines-Steuer Elements an ein Daten gebundenes Steuerelement.Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. Alternativ können Sie die DataSource -Eigenschaft festlegen, aber dann müssen Sie die DataBind -Methode des Daten gebundenen Steuer Elements explizit aufzurufen.Alternatively, you can set the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. Sie können die Select -Methode jederzeit Programm gesteuert aufrufen, um Daten abzurufen.You can call the Select method programmatically at any time to retrieve data.

Weitere Informationen zum Binden von Daten gebundenen Steuerelementen an Datenquellen-Steuerelemente finden Sie unterbinden an Daten mithilfe eines Datenquellen-SteuerElements.For more information about binding data-bound controls to data source controls, see Binding to Data Using a Data Source Control.

Ausführen von Daten VorgängenPerforming Data Operations

Abhängig von den Funktionen des Geschäftsobjekts, mit dem ObjectDataSource das Steuerelement arbeitet, können Sie Daten Vorgänge ausführen, z. b. Aktualisierungen, Einfügungen und Löschungen.Depending on the capabilities of the business object that the ObjectDataSource control works with, you can perform data operations, such as updates, insertions, and deletions. Um diese Daten Vorgänge auszuführen, legen Sie den entsprechenden Methodennamen und alle zugehörigen Parameter für den Vorgang fest, den Sie ausführen möchten.To perform these data operations, set the appropriate method name and any associated parameters for the operation that you want to perform. Legen Sie für einen Aktualisierungs Vorgang z. b UpdateMethod . die-Eigenschaft auf den Namen der Geschäftsobjekt Methode fest, die Updates ausführt, und fügen UpdateParameters Sie der Auflistung alle erforderlichen Parameter hinzu.For example, for an update operation, set the UpdateMethod property to the name of the business object method that performs updates and add any required parameters to the UpdateParameters collection. Wenn das ObjectDataSource Steuerelement einem Daten gebundenen Steuerelement zugeordnet ist, werden die Parameter durch das Daten gebundene Steuerelement hinzugefügt.If the ObjectDataSource control is associated with a data-bound control, the parameters are added by the data-bound control. In diesem Fall müssen Sie sicherstellen, dass die Parameternamen der Methode den Feldnamen im Daten gebundenen Steuerelement entsprechen.In this case, you need to ensure that the parameter names of the method match the field names in the data-bound control. Das Update wird ausgeführt, wenn Update die-Methode aufgerufen wird, entweder explizit durch Ihren Code oder automatisch durch ein Daten gebundenes Steuerelement.The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. Das gleiche allgemeine Muster wird für Delete -und- Insert Vorgänge befolgt.The same general pattern is followed for Delete and Insert operations. Geschäftsobjekte werden davon ausgegangen, dass diese Daten Satz Typen jeweils nacheinander und nicht als Batch verarbeitet werden.Business objects are assumed to perform these types of data operations one record at a time, rather than batched.

Filtern von DatenFiltering Data

Das ObjectDataSource -Steuerelement kann Daten filtern, die von SelectMethod der-Eigenschaft abgerufen werden, wenn die DataSet Daten als DataTable -Objekt oder-Objekt zurückgegeben werden.The ObjectDataSource control can filter data that is retrieved by the SelectMethod property, if the data is returned as a DataSet or DataTable object. Sie können die- FilterExpression Eigenschaft auf einen Filter Ausdruck festlegen, indem Sie eine Syntax der Format Zeichenfolge verwenden und Werte im Ausdruck an Parameter binden FilterParameters , die in der-Auflistung angegeben sind.You can set the FilterExpression property to a filtering expression by using a format string syntax and bind values in the expression to parameters that are specified in the FilterParameters collection.

ZwischenspeicherungCaching

Obwohl die Instanz des Geschäftsobjekts nicht über mehrere Anforderungen hinweg beibehält, kann Sie das Ergebnis des Aufrufs der-Methode Zwischenspeichern, SelectMethod die durch die-Eigenschaft identifiziert wird. ObjectDataSourceAlthough the ObjectDataSource does not retain the instance of the business object across multiple requests, it can cache the result of calling the method identified by the SelectMethod property. Während die Daten zwischengespeichert werden, geben nachfolgende Select Aufrufe der-Methode die zwischengespeicherten Daten zurück, anstatt das Geschäftsobjekt SelectMethod zu erstellen und mit Reflektion aufzurufen.While the data is cached, subsequent calls to the Select method return the cached data instead of creating the business object and calling its SelectMethod using reflection. Durch die Zwischenspeicherung können Sie das Erstellen des Objekts und das Aufrufen seiner Daten Methode auf Kosten des Arbeitsspeichers auf dem Webserver vermeiden.Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. Speichert Daten EnableCaching true CacheDuration automatisch zwischen, wenn die-Eigenschaft auf festgelegt ist, und die-Eigenschaft wird auf die Anzahl der Sekunden festgelegt, in denen der Cache Daten speichert, bevor der Cache verworfen wird. ObjectDataSourceThe ObjectDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is discarded. Sie können auch eine CacheExpirationPolicy -Eigenschaft und eine optionale SqlCacheDependency -Eigenschaft angeben.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. Das ObjectDataSource -Steuerelement ermöglicht es Ihnen, alle Datentypen zwischenzuspeichern, aber Sie sollten keine Objekte zwischenspeichern, die Ressourcen oder einen Zustand beibehalten, die nicht für den Dienst mehrerer SqlDataReader Anforderungen freigegeben werden können (z. b. ein offenes Objekt), da die gleiche Instanz des Objekts wird verwendet, um mehrere Anforderungen zu bedienen.The ObjectDataSource control allows you to cache all types of data, but you should not cache objects that retain resources or state that cannot be shared to service multiple requests (for example, an open SqlDataReader object), because the same instance of the object will be used to service multiple requests.

FeaturesFeatures

In der folgenden Tabelle werden die Funktionen des ObjectDataSource -Steuer Elements beschrieben.The following table describes the features of the ObjectDataSource control.

FunktionCapability AnforderungenRequirements
AuswählenSelecting Legen Sie SelectMethod die-Eigenschaft auf den Namen der Geschäftsobjekt Methode fest, mit der Daten ausgewählt werden, und fügen SelectParameters Sie alle erforderlichen Parameter in der Auflistung entweder Programm gesteuert oder mit einem Daten gebundenen Steuerelement ein.Set the SelectMethod property to the name of the business object method that selects data, and include any necessary parameters in the SelectParameters collection either programmatically or by using a data-bound control.
SortierenSorting Legen Sie SortParameterName die-Eigenschaft auf den Namen des Parameters SelectMethod in der-Methode fest, die die Sortierkriterien enthält.Set the SortParameterName property to the name of the parameter in the SelectMethod method that carries the sort criteria.
FilternFiltering Legen Sie FilterExpression die-Eigenschaft auf einen Filter Ausdruck fest, und fügen Sie FilterParameters der Auflistung optional Parameter hinzu, um Select die Daten zu filtern, wenn die-Methode aufgerufen wird.Set the FilterExpression property to a filtering expression and optionally add any parameters to the FilterParameters collection to filter the data when the Select method is called. Die von der SelectMethod -Eigenschaft angegebene Methode muss ein DataSet - DataTableoder-Objekt zurückgeben.The method specified by the SelectMethod property must return a DataSet or DataTable.
PagingPaging Das Paging von Datenquellen wird unterstützt SelectMethod , wenn die-Methode Parameter für die maximale Anzahl der abzurufenden Datensätze und den Index des ersten abzurufenden Datensatzes enthält.Data source paging is supported, if the SelectMethod method contains parameters for the maximum number of records to retrieve and the index of the first record to retrieve. Die Namen dieser Parameter müssen festgelegt werden, der MaximumRowsParameterName und StartRowIndexParameterName Eigenschaften bzw.The names of those parameters must be set in the MaximumRowsParameterName and StartRowIndexParameterName properties, respectively. Ein Daten gebundenes Steuerelement kann Paging selbst ausführen, auch wenn das ObjectDataSource Steuerelement das Paging nicht direkt in der durch die SelectMethod -Eigenschaft angegebenen Methode unterstützt.A data-bound control might be able to perform paging itself, even if the ObjectDataSource control does not support paging directly in the method specified by the SelectMethod property. Das Daten gebundene Steuerelement muss dies tun, da die von der SelectMethod -Eigenschaft angegebene Methode ein Objekt zurückgibt, das die ICollection -Schnittstelle implementiert.The requirement for the data-bound control to be able to do this is that the method specified by the SelectMethod property return an object that implements the ICollection interface.
Wird aktualisiertUpdating Legen Sie UpdateMethod die-Eigenschaft auf den Namen der Geschäftsobjekt Methode fest, mit der Daten aktualisiert werden, und fügen UpdateParameters Sie alle erforderlichen Parameter in die Auflistung ein.Set the UpdateMethod property to the name of the business object method that updates data, and include any necessary parameters in the UpdateParameters collection.
Wird gelöschtDeleting Legen Sie DeleteMethod die-Eigenschaft auf den Namen der Geschäftsobjekt Methode oder-Funktion fest, mit der Daten gelöscht werden, und DeleteParameters fügen Sie alle erforderlichen Parameter in die Auflistung ein.Set the DeleteMethod property to the name of the business object method or function that deletes data, and include any necessary parameters in the DeleteParameters collection.
EinfügenInserting Legen Sie InsertMethod die-Eigenschaft auf den Namen der Geschäftsobjekt Methode oder-Funktion fest, mit der Daten eingefügt werden, und InsertParameters fügen Sie alle erforderlichen Parameter in die Auflistung ein.Set the InsertMethod property to the name of the business object method or function that inserts data, and include any necessary parameters in the InsertParameters collection.
ZwischenspeicherungCaching Legen Sie EnableCaching die- trueEigenschaft auf und CacheDuration die CacheExpirationPolicy -Eigenschaft und die-Eigenschaft entsprechend dem zwischen Speicherungs Verhalten für die zwischengespeicherten Daten fest.Set the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.

Hinweis

Wenn Sie die ObjectDataSource -Klasse zum Aktualisieren oder Einfügen von Daten verwenden, werden Zeichen folgen, die auf dem Client eingegeben werden, nicht automatisch aus dem Client Kultur Format in das Server Kultur Format konvertiert.When you use the ObjectDataSource class to update or insert data, strings that are entered at the client are not automatically converted from the client culture format to the server culture format. Die Client Kultur könnte z. b. dd/mm/yyyy als Datumsformat angeben, und das Datumsformat auf dem Server ist möglicherweise mm/dd/yyyy.For example, the client culture might specify DD/MM/YYYY as the date format, and the date format on the server might be MM/DD/YYYY. In diesem Fall würde der 5. Oktober 2009 in einem TextBox -Steuerelement als 5/10/2009 eingegeben werden, wird aber als 10. Mai 2009 interpretiert.In that case, October 5, 2009 would be entered in a TextBox control as 5/10/2009 but would be interpreted as May 10, 2009. Der 15. Oktober 2009 wird als 15/10/2009 eingegeben und als ungültiges Datum abgelehnt.October 15, 2009 would be entered as 15/10/2009, and would be rejected as an invalid date.

DatenansichtData View

Wie bei allen Datenquellen-Steuerelementen ObjectDataSource ist das Steuerelement einer Datenquellen Sicht-Klasse zugeordnet.As with all data source controls, the ObjectDataSource control is associated with a data source view class. Das- ObjectDataSourceView Steuerelement ist zwar die Schnittstelle, die der Seiten Entwickler zum Arbeiten mit Daten verwendet, aber die-Klasse ist die Schnittstelle, mit der Daten gebundene Steuerelemente funktionieren. ObjectDataSourceWhile the ObjectDataSource control is the interface that the page developer uses to work with data, the ObjectDataSourceView class is the interface that data-bound controls work with. Außerdem beschreibt die ObjectDataSourceView -Klasse die Funktionen des Datenquellen-Steuer Elements und führt die eigentliche Arbeit aus.Additionally, the ObjectDataSourceView class describes the capabilities of the data source control, and performs the actual work. Dem ObjectDataSource -Steuerelement ist nur ObjectDataSourceViewein zugeordnet, und es wird DefaultViewimmer benannt.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Während das ObjectDataSourceView -Objekt von der GetView -Methode verfügbar gemacht wird, werden viele seiner Eigenschaften und Methoden umschließt ObjectDataSource und direkt vom-Steuerelement bereitgestellt.While the ObjectDataSourceView object is exposed by the GetView method, many of its properties and methods are wrapped and exposed directly by the ObjectDataSource control. Im Hintergrund führt das ObjectDataSourceView -Objekt alle Daten Vorgänge aus, einschließlich abrufen, einfügen, aktualisieren, löschen, Filtern und Sortieren der Daten.Behind the scenes, the ObjectDataSourceView object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. Weitere Informationen finden Sie unter ObjectDataSourceView.For more information, see ObjectDataSourceView.

Verwenden von LINQ to SQLUsing LINQ to SQL

Sie können das ObjectDataSource -Steuerelement mit einer LINQ to SQL-Klasse verwenden.You can use the ObjectDataSource control with a LINQ to SQL class. Legen Sie hierzu die TypeName -Eigenschaft auf den Namen der Datenkontext Klasse fest.To do so, you set the TypeName property to the name of the data-context class. Außerdem legen Sie die SelectMethodMethoden UpdateMethod, InsertMethod, und DeleteMethod auf die Methoden in der Datenkontext Klasse fest, mit denen die entsprechenden Vorgänge durchgeführt werden.You also set the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod methods to the methods in the data-context class that perform the corresponding operations. Sie müssen einen Ereignishandler für das ObjectDisposing -Ereignis erstellen, um die Freigabe der Datenkontext Klasse abzubrechen.You must create an event handler for the ObjectDisposing event in order to cancel disposing of the data-context class. Dieser Schritt ist erforderlich, da LINQ to SQL verzögerte Ausführung unterstützt, ObjectDataSource während das-Steuerelement versucht, den Datenkontext nach dem Select-Vorgang zu verwerfen.This step is necessary because LINQ to SQL supports deferred execution, whereas the ObjectDataSource control tries to dispose the data context after the Select operation. Weitere Informationen zum Erstellen von LINQ to SQL Klassen finden Sie unter Gewusst wie: Erstellen Sie LINQ to SQL Klassen in einem Webprojekt.For more information about how to create LINQ to SQL classes, see How to: Create LINQ to SQL Classes in a Web Project. Ein Beispiel für das Abbrechen der Freigabe einer Datenkontext Klasse finden Sie unter dem ObjectDisposing -Ereignis.For an example of how to cancel the disposing of a data context class, see the ObjectDisposing event.

Verwenden des Entity FrameworkUsing the Entity Framework

Sie können das ObjectDataSource -Steuerelement auch mit dem-Entity Framework verwenden.You can also use the ObjectDataSource control with the Entity Framework. Weitere Informationen finden Sie unter Verwenden der Entity Framework und des ObjectDataSource-SteuerElements.For more information, see Using the Entity Framework and the ObjectDataSource Control.

Deklarative SyntaxDeclarative Syntax

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

Konstruktoren

ObjectDataSource()

Initialisiert eine neue Instanz der ObjectDataSource-Klasse.Initializes a new instance of the ObjectDataSource class.

ObjectDataSource(String, String)

Initialisiert eine neue Instanz der ObjectDataSource-Klasse unter Verwendung des angegebenen Typnamens und des angegebenen Datenabrufmethoden-Namens.Initializes a new instance of the ObjectDataSource class with the specified type name and data retrieval method name.

Eigenschaften

Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.Gets the browser-specific adapter for the control.

(Geerbt von Control)
AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Geerbt von Control)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.Gets the control that contains this control's data binding.

(Geerbt von Control)
CacheDuration

Ruft die Zeitspanne in Sekunden ab, die das Datenquellensteuerelement die von der SelectMethod-Eigenschaft abgerufenen Daten zwischenspeichert, oder legt diese fest.Gets or sets the length of time, in seconds, that the data source control caches data that is retrieved by the SelectMethod property.

CacheExpirationPolicy

Ruft das Cacheablaufverhalten ab, das in Kombination mit der Dauer das Verhalten des vom Datenquellen-Steuerelement verwendeten Caches beschreibt.Gets or sets the cache expiration behavior that, when combined with the duration, describes the behavior of the cache that the data source control uses.

CacheKeyDependency

Ruft eine benutzerdefinierte Schlüsselabhängigkeit ab, die mit sämtlichen vom Datenquellen-Steuerelement erstellten Datencacheobjekten verknüpft ist, oder legt diese fest.Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control.

ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.Gets a value that indicates whether the server control's child controls have been created.

(Geerbt von Control)
ClientID

Ruft den von ASP.NET generierten Bezeichner des Serversteuerelements ab.Gets the server control identifier generated by ASP.NET.

(Geerbt von DataSourceControl)
ClientIDMode

Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet.This property is not used for data source controls.

(Geerbt von DataSourceControl)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.Gets a character value representing the separator character used in the ClientID property.

(Geerbt von Control)
ConflictDetection

Ruft einen Wert ab, der bestimmt, ob nur die neuen Werte an die Update-Methode oder aber die alten und die neuen Werte an die Update-Methode übergeben werden, oder legt diesen fest.Gets or sets a value that determines whether or not just the new values are passed to the Update method or both the old and new values are passed to the Update method.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.Gets the HttpContext object associated with the server control for the current Web request.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Geerbt von DataSourceControl)
ConvertNullToDBNull

Ruft einen Wert ab, der angibt, ob die an einen Aktualisierungs-, Einfüge- oder Löschvorgang übergebenen Parameter-Werte vom Value-Steuerelement automatisch von null in den ObjectDataSource-Wert konvertiert werden, oder legt diesen fest.Gets or sets a value indicating whether the Parameter values that are passed to an update, insert, or delete operation are automatically converted from null to the Value value by the ObjectDataSource control.

DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Geerbt von Control)
DataObjectTypeName

Ruft den Namen einer Klasse ab, die vom ObjectDataSource-Steuerelement als Parameter bei Datenvorgängen vom Typ Aktualisieren, Einfügen oder Löschen verwendet wird, anstatt einzelne Werte aus dem datengebundenen Steuerelement zu übergeben, oder legt diesen fest.Gets or sets the name of a class that the ObjectDataSource control uses for a parameter in an update, insert, or delete data operation, instead of passing individual values from the data-bound control.

DeleteMethod

Ruft den Namen der Methode oder Funktion ab, die vom ObjectDataSource-Steuerelement zum Löschen von Daten aufgerufen wird, oder legt diesen fest.Gets or sets the name of the method or function that the ObjectDataSource control invokes to delete data.

DeleteParameters

Ruft die Parameterauflistung ab, die die von der DeleteMethod-Methode verwendeten Parameter enthält.Gets the parameters collection that contains the parameters that are used by the DeleteMethod method.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.Gets a value indicating whether a control is being used on a design surface.

(Geerbt von Control)
EnableCaching

Ruft einen Wert ab, der angibt, ob für das ObjectDataSource-Steuerelement die Zwischenspeicherung von Daten aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether the ObjectDataSource control has data caching enabled.

EnablePaging

Ruft einen Wert ab, der angibt, ob das Datenquellensteuerelement Paging für den von ihm abgerufenen Datensatz unterstützt, oder legt diesen fest.Gets or sets a value that indicates whether the data source control supports paging through the set of data that it retrieves.

EnableTheming

Ruft einen Wert ab, der angibt, ob Designs von diesem Objekt unterstützt werden.Gets a value indicating whether this control supports themes.

(Geerbt von DataSourceControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Geerbt von Control)
FilterExpression

Ruft einen Filterausdruck ab, der beim Aufruf der von der SelectMethod-Eigenschaft angegebenen Methode angewendet wird, oder legt diesen fest.Gets or sets a filtering expression that is applied when the method that is specified by the SelectMethod property is called.

FilterParameters

Ruft eine Auflistung von Parametern ab, die beliebigen Parameterplatzhaltern in der FilterExpression-Zeichenfolge zugeordnet sind.Gets a collection of parameters that are associated with any parameter placeholders in the FilterExpression string.

HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.Gets the character used to separate control identifiers.

(Geerbt von Control)
InsertMethod

Ruft den Namen der Methode oder Funktion ab, die vom ObjectDataSource-Steuerelement zum Einfügen von Daten aufgerufen wird, oder legt diese fest.Gets or sets the name of the method or function that the ObjectDataSource control invokes to insert data.

InsertParameters

Ruft die Parameterauflistung ab, die die von der InsertMethod-Eigenschaft verwendeten Parameter enthält.Gets the parameters collection that contains the parameters that are used by the InsertMethod property.

IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.Gets a value indicating whether controls contained within this control have control state.

(Geerbt von Control)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the server control is saving changes to its view state.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.Gets a value indicating whether view state is enabled for this control.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Geerbt von Control)
MaximumRowsParameterName

Ruft den Namen des Datenabruf-Methodenparameters für Geschäftsobjekte ab, mit dem die Anzahl der Datensätze angegeben wird, die für die Unterstützung des Datenquellen-Paging abgerufen werden, oder legt diesen fest.Gets or sets the name of the business object data retrieval method parameter that is used to indicate the number of records to retrieve for data source paging support.

NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Geerbt von Control)
OldValuesParameterFormatString

Ruft eine Formatzeichenfolge ab, die auf die Namen der Parameter für ursprüngliche Werte angewendet wird, die an die Delete-Methode oder an die Update-Methode übergeben werden, oder legt diese fest.Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.

Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.Gets a reference to the Page instance that contains the server control.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.Gets a reference to the server control's parent control in the page control hierarchy.

(Geerbt von Control)
ParsingCulture

Ruft einen Wert ab oder legt einen Wert fest, der angibt, welche Kulturinformationen verwendet werden, wenn Zeichenfolgenwerte in tatsächliche Eigenschaftentypen konvertiert werden, um ein Objekt des Typs zu erstellen, der von DataObjectTypeName angegeben wird.Gets a or sets a value that indicates what culture information is used when converting string values to actual property types in order to construct an object of the type indicated by DataObjectTypeName.

RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Geerbt von Control)
SelectCountMethod

Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSource-Steuerelement zum Abrufen der Zeilenanzahl aufgerufen wird, oder legt diesen fest.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve a row count.

SelectMethod

Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSource-Steuerelement zum Abrufen von Daten aufgerufen wird, oder legt diesen fest.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve data.

SelectParameters

Ruft eine Auflistung mit den Parametern ab, die von der mit der SelectMethod-Eigenschaft angegebenen Methode verwendet werden.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.Gets information about the container that hosts the current control when rendered on a design surface.

(Geerbt von Control)
SkinID

Ruft die Skin ab, um sie auf das DataSourceControl-Steuerelement anzuwenden.Gets the skin to apply to the DataSourceControl control.

(Geerbt von DataSourceControl)
SortParameterName

Ruft den Namen des Geschäftsobjekts ab, mit dem der SelectMethod-Parameter einen Sortierausdruck für die Unterstützung der Datenquellensortierung angegeben hat, oder legt diesen fest.Gets or sets the name of the business object that the SelectMethod parameter used to specify a sort expression for data source sorting support.

SqlCacheDependency

Ruft eine durch Semikolons getrennte Zeichenfolge ab, die die für die Microsoft SQL Server-Cacheabhängigkeit zu verwendenden Datenbanken und Tabellen angibt, oder legt diese fest.Gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency.

StartRowIndexParameterName

Ruft den Namen des Parameters der Datenabrufmethode ab, mit dem der Wert des Bezeichners des ersten Datensatzes angegeben wird, der für die Unterstützung des Datenquellen-Paging abgerufen wird, oder legt diesen fest.Gets or sets the name of the data retrieval method parameter that is used to indicate the value of the identifier of the first record to retrieve for data source paging support.

TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.Gets or sets a reference to the template that contains this control.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Geerbt von Control)
TypeName

Ruft den Namen der vom ObjectDataSource-Objekt dargestellten Klasse ab, oder legt diesen fest.Gets or sets the name of the class that the ObjectDataSource object represents.

UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.Gets the unique, hierarchically qualified identifier for the server control.

(Geerbt von Control)
UpdateMethod

Ruft den Namen der Methode oder der Funktion ab, die vom ObjectDataSource-Steuerelement zum Aktualisieren von Daten aufgerufen wird, oder legt diesen fest.Gets or sets the name of the method or function that the ObjectDataSource control invokes to update data.

UpdateParameters

Ruft die Parameterauflistung mit den Parametern ab, die von der durch die UpdateMethod-Eigenschaft angegebenen Methode verwendet werden.Gets the parameters collection that contains the parameters that are used by the method that is specified by the UpdateMethod property.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.Gets a value that indicates whether the StateBag object is case-insensitive.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.Gets or sets the view-state mode of this control.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob das Steuerelement visuell dargestellt wird, oder legt diesen fest.Gets or sets a value indicating whether the control is visually displayed.

(Geerbt von DataSourceControl)

Methoden

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.Called after a child control is added to the Controls collection of the Control object.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Geerbt von Control)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.Applies the style properties that are defined in the page style sheet to the control.

(Geerbt von DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.Begins design-time tracing of rendering data.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.Sets the cached ClientID value to null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.Deletes the control-state information for the server control's child controls.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state and control-state information for all the server control's child controls.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state information for all the server control's child controls.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Geerbt von Control)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Geerbt von Control)
CreateControlCollection()

Erstellt eine Auflistung zum Speichern untergeordneter Steuerelemente.Creates a collection to store child controls.

(Geerbt von DataSourceControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.Binds a data source to the invoked server control and all its child controls.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.Binds a data source to the server control's child controls.

(Geerbt von Control)
Delete()

Führt einen Löschvorgang durch Aufrufen der von der DeleteMethod-Eigenschaft angegebenen Methode mit sämtlichen Parametern in der DeleteParameters-Auflistung aus.Performs a delete operation by calling the method that is identified by the DeleteMethod property with any parameters that are in the DeleteParameters collection.

Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.Enables a server control to perform final clean up before it is released from memory.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.Ends design-time tracing of rendering data.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines whether the server control contains child controls. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.If it does not, it creates child controls.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.Creates an identifier for controls that do not have an identifier assigned.

(Geerbt von Control)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

(Geerbt von DataSourceControl)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

(Geerbt von Control)
Focus()

Setzt den Eingabefokus auf das Steuerelement.Sets input focus to the control.

(Geerbt von DataSourceControl)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.Gets design-time data for a control.

(Geerbt von Control)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.Returns the prefixed portion of the UniqueID property of the specified control.

(Geerbt von Control)
GetView(String)

Ruft die benannte Datenquellenansicht ab, die dem Datenquellen-Steuerelement zugeordnet ist.Retrieves the named data source view that is associated with the data source control.

GetViewNames()

Ruft eine Auflistung von Namen ab, die die Liste der dem ObjectDataSource-Objekt zugeordneten Ansichtsobjekte darstellt.Retrieves a collection of names representing the list of view objects that are associated with the ObjectDataSource object.

HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines if the server control contains any child controls.

(Geerbt von DataSourceControl)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.Returns a value indicating whether events are registered for the control or any child controls.

(Geerbt von Control)
Insert()

Führt einen Einfügevorgang durch Aufrufen der von der InsertMethod-Eigenschaft angegebenen Methode mit sämtlichen Parametern in der InsertParameters-Auflistung aus.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.Determines if the server control holds only literal content.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Geerbt von Control)
LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des ObjectDataSource-Steuerelements.Loads the previously saved view state of the ObjectDataSource control.

MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Geerbt von Control)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.Raises the DataBinding event.

(Geerbt von Control)
OnInit(EventArgs)

Fügt der Seite mit dem LoadComplete-Steuerelement einen ObjectDataSource-Ereignishandler hinzu.Adds a LoadComplete event handler to the page that contains the ObjectDataSource control.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.Raises the Load event.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.Raises the PreRender event.

(Geerbt von Control)
OnUnload(EventArgs)

Löst das Unload-Ereignis aus.Raises the Unload event.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.Gets a Stream used to read a file.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

(Geerbt von Control)
RaiseDataSourceChangedEvent(EventArgs)

Löst das DataSourceChanged-Ereignis aus.Raises the DataSourceChanged event.

(Geerbt von DataSourceControl)
RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.Called after a child control is removed from the Controls collection of the Control object.

(Geerbt von Control)
Render(HtmlTextWriter)

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Geerbt von DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Geerbt von Control)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.Gets the control adapter responsible for rendering the specified control.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.Gets a URL that can be used by the browser.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.Converts a URL into one that is usable on the requesting client.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Geerbt von Control)
SaveViewState()

Speichert den Zustand des ObjectDataSource-Steuerelements.Saves the state of the ObjectDataSource control.

Select()

Ruft Daten aus dem zugrunde liegenden Datenspeicher ab, indem die von der SelectMethod-Eigenschaft angegebene Methode mit den Parametern in der SelectParameters-Auflistung aufgerufen wird.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.Sets design-time data for a control.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.Assigns an event handler delegate to render the server control and its content into its parent control.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TrackViewState()

Verfolgt die am Ansichtszustand des ObjectDataSource-Steuerelements vorgenommenen Änderungen und speichert diese im StateBag-Objekt.Tracks view-state changes to the ObjectDataSource control so that they can be stored in the StateBag object.

Update()

Führt einen Aktualisierungsvorgang durch Aufrufen der von der UpdateMethod-Eigenschaft angegebenen Methode mit sämtlichen Parametern in der UpdateParameters-Auflistung aus.Performs an update operation by calling the method that is identified by the UpdateMethod property and any parameters that are in the UpdateParameters collection.

Ereignisse

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.Occurs when the server control binds to a data source.

(Geerbt von Control)
Deleted

Tritt ein, wenn ein Delete()-Vorgang abgeschlossen wurde.Occurs when a Delete() operation has completed.

Deleting

Tritt vor einem Delete()-Vorgang auf.Occurs before a Delete() operation.

Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Geerbt von Control)
Filtering

Tritt vor einem Filtervorgang auf.Occurs before a filter operation.

Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Geerbt von Control)
Inserted

Tritt ein, wenn ein Insert()-Vorgang abgeschlossen wurde.Occurs when an Insert() operation has completed.

Inserting

Tritt vor einem Insert()-Vorgang ein.Occurs before an Insert() operation.

Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.Occurs when the server control is loaded into the Page object.

(Geerbt von Control)
ObjectCreated

Tritt auf, nachdem das von der TypeName-Eigenschaft angegebene Objekt erstellt wurde.Occurs after the object that is identified by the TypeName property is created.

ObjectCreating

Tritt auf, bevor das von der TypeName-Eigenschaft angegebene Objekt erstellt wird.Occurs before the object that is identified by the TypeName property is created.

ObjectDisposing

Tritt auf, bevor das von der TypeName-Eigenschaft angegebene Objekt verworfen wird.Occurs before the object that is identified by the TypeName property is discarded.

PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.Occurs after the Control object is loaded but prior to rendering.

(Geerbt von Control)
Selected

Tritt ein, wenn ein Select()-Vorgang abgeschlossen wurde.Occurs when a Select() operation has completed.

Selecting

Tritt vor einem Select()-Vorgang auf.Occurs before a Select() operation.

Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.Occurs when the server control is unloaded from memory.

(Geerbt von Control)
Updated

Tritt ein, wenn ein Update()-Vorgang abgeschlossen wurde.Occurs when an Update() operation has completed.

Updating

Tritt vor einem Update()-Vorgang ein.Occurs before an Update() operation.

Explizite Schnittstellenimplementierungen

IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.For a description of this member, see ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().For a description of this member, see GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.For a description of this member, see UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.For a description of this member, see DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.For a description of this member, see HasDataBindings.

(Geerbt von Control)
IDataSource.DataSourceChanged

Tritt ein, wenn ein Datenquellen-Steuerelement auf eine Weise geändert wurde, die sich auf datengebundene Steuerelemente auswirkt.Occurs when a data source control has changed in a way that affects data-bound controls.

(Geerbt von DataSourceControl)
IDataSource.GetView(String)

Ruft das benannte DataSourceView-Objekt ab, das dem DataSourceControl-Steuerelement zugeordnet ist.Gets the named DataSourceView object associated with the DataSourceControl control. Einige Datenquellensteuerelemente unterstützen nur eine Ansicht, andere hingegen unterstützen mehrere Ansichten.Some data source controls support only one view, while others support more than one.

(Geerbt von DataSourceControl)
IDataSource.GetViewNames()

Ruft eine Auflistung von Namen ab, die die Liste der DataSourceView-Objekte darstellt, die dem DataSourceControl-Steuerelement zugeordnet sind.Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

(Geerbt von DataSourceControl)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.For a description of this member, see Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.For a description of this member, see HasExpressions.

(Geerbt von Control)
IListSource.ContainsListCollection

Gibt an, ob das Datenquellensteuerelement einer oder mehreren Listen mit Daten zugeordnet ist.Indicates whether the data source control is associated with one or more lists of data.

(Geerbt von DataSourceControl)
IListSource.GetList()

Ruft eine Liste der Datenquellensteuerelemente ab, die als Quellen für Listen mit Daten verwendet werden können.Gets a list of data source controls that can be used as sources of lists of data.

(Geerbt von DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Geerbt von Control)

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource)

Ruft die Auflistung von Standardwerten für die angegebene Datenquelle ab.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource)

Ruft die Metadaten für eine Tabelle im angegebenen Datenquellenobjekt ab.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.Determines whether table metadata is available.

Gilt für:

Siehe auch