ObjectDataSource Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Geschäftsobjekt dar, das Daten zu datengebundenen Steuerelementen in Webanwendungsarchitekturen mit mehreren Ebenen bereitstellt.
public ref class ObjectDataSource : System::Web::UI::DataSourceControl[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
inherit DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Vererbung
- Attribute
Beispiele
In diesem Abschnitt wird ein ObjectDataSource In-Markup in einer ASPX-Seite und die Geschäftsobjekte angezeigt, mit denen er funktioniert. Das Beispiel ist die ASPX-Seite. Es enthält ein GridView Steuerelement, das an ein ObjectDataSource Steuerelement gebunden ist. Das ObjectDataSource Steuerelementmarkup gibt den Namen des Geschäftsobjekts und den Namen der Geschäftsobjektmethode an, die zum Abrufen von Daten aufgerufen werden soll.
<%@ 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 das ObjectDataSource Steuerelement auf der ASPX-Seite verwendet. (Viele andere ObjectDataSource Codebeispiele verwenden dieses Geschäftsobjekt ebenfalls.) Das Beispiel besteht aus den folgenden zwei grundlegenden Klassen:
Die
EmployeeLogic-Klasse ist die Geschäftslogikklasse, die von verwendet ObjectDataSource wird.Die
NorthwindEmployee-Klasse definiert das Datenobjekt, das von derGetAllEmployees-Methode derEmployeeLogic-Klasse zurückgegeben wird.
Als Komfort wird eine zusätzliche NorthwindDataException Klasse bereitgestellt.
Dieser Satz von Beispielklassen funktioniert mit der Northwind Traders-Datenbank, die mit Microsoft SQL Server und Microsoft Access verfügbar ist. Für ein vollständiges Arbeitsbeispiel müssen Sie diese Klassen kompilieren und mit dem bereitgestellten ASPX-Seitenbeispiel verwenden.
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:
Einführung
Ein ObjectDataSource Steuerelement funktioniert mit einer Klasse, die Sie erstellen. Sie erstellen Methoden, die Daten abrufen und aktualisieren, und geben die Namen dieser Methoden für das ObjectDataSource Steuerelement im Markup an. Ruft während der Rendering- oder Postbackverarbeitung die ObjectDataSource von Ihnen angegebenen Methoden auf.
Es gibt kein visuelles Rendering des Steuerelements ObjectDataSource . Daher werden visuelle ObjectDataSource Features wie die EnableTheming - oder SkinID -Eigenschaft nicht unterstützt.
Zweck
Eine sehr gängige Anwendungsentwurfspraxis besteht darin, die Präsentationsebene von der Geschäftslogik zu trennen und die Geschäftslogik in Geschäftsobjekten zu kapseln. Diese Geschäftsobjekte bilden eine unterschiedliche Ebene zwischen der Präsentationsebene und der Datenebene, was zu einer dreistufigen Anwendungsarchitektur führt. Das ObjectDataSource Steuerelement ermöglicht Es Entwicklern, ein ASP.NET Datenquellensteuerelement zu verwenden und gleichzeitig ihre dreistufige Anwendungsarchitektur beizubehalten.
Das ObjectDataSource Steuerelement verwendet Reflektion, um Instanzen von Geschäftsobjekten zu erstellen und Methoden für diese aufzurufen, um Daten abzurufen, zu aktualisieren, einzufügen und zu löschen. Die TypeName -Eigenschaft gibt den Namen der Klasse an, mit der die ObjectDataSource -Klasse arbeitet. Das ObjectDataSource Steuerelement erstellt und zerstört eine instance der -Klasse für jeden Methodenaufruf. Das Objekt befindet sich für die Lebensdauer der Webanforderung nicht im Arbeitsspeicher. Dies ist eine ernsthafte Überlegung, wenn das von Ihnen verwendete Geschäftsobjekt viele Ressourcen benötigt oder anderweitig teuer zu erstellen und zu zerstören ist. Die Verwendung eines teuren Objekts ist möglicherweise keine optimale Entwurfsoption, aber Sie können den Lebenszyklus des Objekts mithilfe der ObjectCreatingEreignisse , ObjectCreatedund ObjectDisposing steuern.
Hinweis
Die Methoden, die durch die SelectMethodEigenschaften , UpdateMethod, InsertMethodund DeleteMethod identifiziert werden, können instance Methoden oder static (Shared in Visual Basic) Methoden sein. Wenn die Methoden (Shared in Visual Basic) sind static , wird kein instance des Geschäftsobjekts erstellt, und die ObjectCreatingEreignisse , ObjectCreatedund ObjectDisposing werden nicht ausgelöst.
Abrufen von Daten
Um Daten aus einem Geschäftsobjekt abzurufen, legen Sie die SelectMethod -Eigenschaft auf den Namen der Methode fest, die Daten abruft. Wenn die -Methode kein -Objekt oder DataSet -Objekt zurückgibtIEnumerable, wird das Objekt von der Runtime in einer IEnumerable Auflistung umschlossen. Wenn die Methodensignatur Parameter enthält, können Sie der SelectParameters Auflistung Objekte hinzufügen Parameter und diese dann an die Werte binden, die Sie an die Methode übergeben möchten, die von der SelectMethod -Eigenschaft angegeben wird. Damit das ObjectDataSource Steuerelement die Parameter verwendet, müssen die Parameter mit den Namen und Typen der Parameter in der Methodensignatur übereinstimmen. Weitere Informationen finden Sie unter Verwenden von Parametern mit dem ObjectDataSource-Steuerelement.
Das ObjectDataSource Steuerelement ruft Daten ab, wenn die Select -Methode aufgerufen wird. Diese Methode bietet programmgesteuerten Zugriff auf die Methode, die durch SelectMethod die -Eigenschaft angegeben wird. Die von der SelectMethod -Eigenschaft angegebene Methode wird automatisch von Steuerelementen aufgerufen, die an den gebunden sind, wenn ihre ObjectDataSourceDataBind Methode aufgerufen wird. Wenn Sie die DataSourceID -Eigenschaft eines datengebundenen Steuerelements festlegen, wird das Steuerelement bei Bedarf automatisch an Daten aus der Datenquelle gebunden. Das Festlegen der DataSourceID -Eigenschaft ist die empfohlene Methode zum Binden eines Steuerelements ObjectDataSource an ein datengebundenes Steuerelement. Alternativ können Sie die DataSource -Eigenschaft festlegen, aber dann müssen Sie explizit die DataBind Methode des datengebundenen Steuerelements aufrufen. Sie können die Select Methode jederzeit programmgesteuert aufrufen, um Daten abzurufen.
Weitere Informationen zum Binden von datengebundenen Steuerelementen an Datenquellensteuerelemente finden Sie unter Binden an Daten mithilfe eines Datenquellensteuerelements.
Ausführen von Datenvorgängen
Abhängig von den Funktionen des Geschäftsobjekts, mit dem das ObjectDataSource Steuerelement arbeitet, können Sie Datenvorgänge wie Updates, Einfügungen und Löschungen ausführen. Um diese Datenvorgänge auszuführen, legen Sie den entsprechenden Methodennamen und alle zugeordneten Parameter für den Vorgang fest, den Sie ausführen möchten. Legen Sie beispielsweise für einen Aktualisierungsvorgang die UpdateMethod Eigenschaft auf den Namen der Geschäftsobjektmethode fest, die Updates ausführt, und fügen Sie der UpdateParameters Auflistung alle erforderlichen Parameter hinzu. Wenn das ObjectDataSource Steuerelement einem datengebundenen Steuerelement zugeordnet ist, werden die Parameter vom datengebundenen Steuerelement hinzugefügt. In diesem Fall müssen Sie sicherstellen, dass die Parameternamen der Methode mit den Feldnamen im datengebundenen Steuerelement übereinstimmen. Das Update wird ausgeführt, wenn die Update -Methode aufgerufen wird, entweder explizit von Ihrem Code oder automatisch von einem datengebundenen Steuerelement. Das gleiche allgemeine Muster wird für Delete Und-Vorgänge Insert befolgt. Es wird davon ausgegangen, dass Geschäftsobjekte diese Arten von Datenvorgängen jeweils einen Datensatz nach dem anderen ausführen und nicht batchweise.
Filtern von Daten
Das ObjectDataSource Steuerelement kann Daten filtern, die von der SelectMethod -Eigenschaft abgerufen werden, wenn die Daten als - DataSet Objekt oder DataTable -Objekt zurückgegeben werden. Sie können die FilterExpression Eigenschaft auf einen Filterausdruck festlegen, indem Sie eine Formatzeichenfolgensyntax verwenden und Werte im Ausdruck an Parameter binden, die in der FilterParameters Auflistung angegeben sind.
Zwischenspeicherung
Obwohl der ObjectDataSource nicht die instance des Geschäftsobjekts über mehrere Anforderungen hinweg behält, kann es das Ergebnis des Aufrufens der durch die SelectMethod -Eigenschaft identifizierten Methode zwischenspeichern. Während die Daten zwischengespeichert werden, geben nachfolgende Aufrufe der Select -Methode die zwischengespeicherten Daten zurück, anstatt das Geschäftsobjekt zu erstellen und dessen SelectMethod Using-Reflektion aufzurufen. Mit der Zwischenspeicherung können Sie das Erstellen des Objekts und das Aufrufen seiner Datenmethode auf Kosten des Arbeitsspeichers auf dem Webserver vermeiden. Die ObjectDataSource speichert Daten automatisch zwischen, wenn die EnableCaching -Eigenschaft auf truefestgelegt ist, und die CacheDuration -Eigenschaft auf die Anzahl von Sekunden festgelegt ist, die der Cache speichert, bevor der Cache verworfen wird. Sie können auch eine CacheExpirationPolicy Eigenschaft und eine optionale SqlCacheDependency Eigenschaft angeben. Mit ObjectDataSource dem Steuerelement können Sie alle Arten von Daten zwischenspeichern, aber Sie sollten keine Objekte zwischenspeichern, die Ressourcen oder Zustände beibehalten, die nicht für mehrere Anforderungen freigegeben werden können (z. B. ein offenes SqlDataReader Objekt), da dieselbe instance des Objekts verwendet wird, um mehrere Anforderungen zu verarbeiten.
Funktionen
In der folgenden Tabelle werden die Features des ObjectDataSource Steuerelements beschrieben.
| Funktionalität | Anforderungen |
|---|---|
| Wählen Sie Folgendes aus: | Legen Sie die SelectMethod -Eigenschaft auf den Namen der Geschäftsobjektmethode fest, die Daten auswählt, und schließen Sie alle erforderlichen Parameter entweder programmgesteuert oder mithilfe eines datengebundenen Steuerelements in die SelectParameters Auflistung ein. |
| Sortieren | Legen Sie die SortParameterName -Eigenschaft auf den Namen des Parameters in der SelectMethod Methode fest, die die Sortierkriterien enthält. |
| Filtern | Legen Sie die FilterExpression -Eigenschaft auf einen Filterausdruck fest, und fügen Sie optional beliebige Parameter zur FilterParameters Auflistung hinzu, um die Daten zu filtern, wenn die Select Methode aufgerufen wird. Die von der SelectMethod -Eigenschaft angegebene Methode muss ein DataSet oder DataTablezurückgeben. |
| Paging | Das Paging von Datenquellen wird unterstützt, wenn die SelectMethod -Methode Parameter für die maximale Anzahl der abzurufenden Datensätze und den Index des ersten abzurufenden Datensatzes enthält. Die Namen dieser Parameter müssen in den MaximumRowsParameterName Eigenschaften und StartRowIndexParameterName festgelegt werden. Ein datengebundenes Steuerelement kann das Paging selbst ausführen, auch wenn das Steuerelement das ObjectDataSource Paging nicht direkt in der von der SelectMethod -Eigenschaft angegebenen Methode unterstützt. Die Voraussetzung dafür ist, dass das datengebundene Steuerelement dazu in der Lage ist, dass die von der SelectMethod -Eigenschaft angegebene Methode ein Objekt zurückgibt, das die ICollection Schnittstelle implementiert. |
| Wird aktualisiert | Legen Sie die UpdateMethod -Eigenschaft auf den Namen der Geschäftsobjektmethode fest, die Daten aktualisiert, und schließen Sie alle erforderlichen Parameter in die UpdateParameters Auflistung ein. |
| Wird gelöscht | Legen Sie die DeleteMethod -Eigenschaft auf den Namen der Geschäftsobjektmethode oder -funktion fest, die Daten löscht, und schließen Sie alle erforderlichen Parameter in die DeleteParameters Auflistung ein. |
| Einfügen | Legen Sie die InsertMethod -Eigenschaft auf den Namen der Geschäftsobjektmethode oder -funktion fest, die Daten einfügt, und schließen Sie alle erforderlichen Parameter in die InsertParameters Auflistung ein. |
| Zwischenspeicherung | Legen Sie die EnableCaching Eigenschaft auf truefest, und legen Sie die CacheDuration Eigenschaften und CacheExpirationPolicy entsprechend dem Zwischenspeicherverhalten fest, das Sie für Ihre zwischengespeicherten Daten benötigen. |
Hinweis
Wenn Sie die ObjectDataSource -Klasse zum Aktualisieren oder Einfügen von Daten verwenden, werden Zeichenfolgen, die auf dem Client eingegeben werden, nicht automatisch aus dem Clientkulturformat in das Serverkulturformat konvertiert. Beispielsweise kann die Clientkultur DD/MM/JJJJ als Datumsformat angeben, und das Datumsformat auf dem Server kann MM/TT/JJJJ sein. In diesem Fall würde der 5. Oktober 2009 am 5.10.2009 in eine TextBox Kontrolle aufgenommen, aber als 10. Mai 2009 interpretiert. Der 15. Oktober 2009 würde als 15.10.2009 eingegeben und als ungültiges Datum abgelehnt.
Datensicht
Wie bei allen Datenquellensteuerelementen ist das ObjectDataSource Steuerelement einer Datenquellensichtklasse zugeordnet. Während das ObjectDataSource Steuerelement die Schnittstelle ist, die der Seitenentwickler zum Arbeiten mit Daten verwendet, ist die ObjectDataSourceView -Klasse die Schnittstelle, mit der datengebundene Steuerelemente arbeiten. Darüber hinaus beschreibt die ObjectDataSourceView -Klasse die Funktionen des Datenquellensteuerelements und führt die eigentliche Arbeit aus. Dem ObjectDataSource Steuerelement ist nur eine zugeordnet ObjectDataSourceView, und es heißt immer DefaultView. Während das ObjectDataSourceView Objekt von der GetView -Methode verfügbar gemacht wird, werden viele seiner Eigenschaften und Methoden direkt vom ObjectDataSource Steuerelement umschlossen und verfügbar gemacht. Hinter den Kulissen führt das ObjectDataSourceView Objekt alle Datenvorgänge aus, einschließlich des Abrufens, Einfügens, Aktualisierens, Löschens, Filterns und Sortierens der Daten. Weitere Informationen finden Sie unter ObjectDataSourceView.
Verwenden von LINQ to SQL
Sie können das ObjectDataSource Steuerelement mit einer LINQ to SQL-Klasse verwenden. Dazu legen Sie die TypeName -Eigenschaft auf den Namen der Datenkontextklasse fest. Außerdem legen Sie die SelectMethodMethoden , UpdateMethod, InsertMethodund DeleteMethod auf die Methoden in der Datenkontextklasse fest, die die entsprechenden Vorgänge ausführen. Sie müssen einen Ereignishandler für das Ereignis erstellen, um das ObjectDisposing Löschen der Datenkontextklasse abzubrechen. Dieser Schritt ist erforderlich, da LINQ to SQL die verzögerte Ausführung unterstützt, während das ObjectDataSource Steuerelement versucht, den Datenkontext nach dem Select-Vorgang zu verwerfen. Weitere Informationen zum Erstellen LINQ to SQL Klassen finden Sie unter Vorgehensweise: Erstellen LINQ to SQL Klassen in einem Webprojekt. Ein Beispiel für das Abbrechen des Löschens einer Datenkontextklasse finden Sie im ObjectDisposing -Ereignis.
Verwenden von Entity Framework
Sie können das ObjectDataSource Steuerelement auch mit Entity Framework verwenden. Weitere Informationen finden Sie unter Verwenden des Entity Framework und des ObjectDataSource-Steuerelements.
Deklarative 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. |
| ObjectDataSource(String, String) |
Initialisiert eine neue Instanz der ObjectDataSource-Klasse unter Verwendung des angegebenen Typnamens und des angegebenen Datenabrufmethoden-Namens. |
Eigenschaften
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (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. (Geerbt von Control) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (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. |
| CacheExpirationPolicy |
Ruft das Cacheablaufverhalten ab, das in Kombination mit der Dauer das Verhalten des vom Datenquellen-Steuerelement verwendeten Caches beschreibt. |
| CacheKeyDependency |
Ruft eine benutzerdefinierte Schlüsselabhängigkeit ab, die mit sämtlichen vom Datenquellen-Steuerelement erstellten Datencacheobjekten verknüpft ist, oder legt diese fest. |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft den von ASP.NET generierten Bezeichner des Serversteuerelements ab. (Geerbt von DataSourceControl) |
| ClientIDMode |
Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet. (Geerbt von DataSourceControl) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| ConflictDetection |
Ruft einen Wert ab, der bestimmt, ob nur die neuen Werte an die |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (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. (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 |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (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. |
| DeleteMethod |
Ruft den Namen der Methode oder Funktion ab, die vom ObjectDataSource-Steuerelement zum Löschen von Daten aufgerufen wird, oder legt diesen fest. |
| DeleteParameters |
Ruft die Parameterauflistung ab, die die von der DeleteMethod-Methode verwendeten Parameter enthält. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (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. |
| EnablePaging |
Ruft einen Wert ab, der angibt, ob das Datenquellensteuerelement Paging für den von ihm abgerufenen Datensatz unterstützt, oder legt diesen fest. |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob Designs von diesem Objekt unterstützt werden. (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. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| FilterExpression |
Ruft einen Filterausdruck ab, der beim Aufruf der von der SelectMethod-Eigenschaft angegebenen Methode angewendet wird, oder legt diesen fest. |
| FilterParameters |
Ruft eine Auflistung von Parametern ab, die beliebigen Parameterplatzhaltern in der FilterExpression-Zeichenfolge zugeordnet sind. |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (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. |
| InsertParameters |
Ruft die Parameterauflistung ab, die die von der InsertMethod-Eigenschaft verwendeten Parameter enthält. |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (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. |
| 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. (Geerbt von Control) |
| OldValuesParameterFormatString |
Ruft eine Formatzeichenfolge ab, die auf die Namen der Parameter für ursprüngliche Werte angewendet wird, die an die |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (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. |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (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. |
| SelectMethod |
Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSource-Steuerelement zum Abrufen von Daten aufgerufen wird, oder legt diesen fest. |
| SelectParameters |
Ruft eine Auflistung mit den Parametern ab, die von der mit der SelectMethod-Eigenschaft angegebenen Methode verwendet werden. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Skin ab, um sie auf das DataSourceControl-Steuerelement anzuwenden. (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. |
| 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. |
| 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. |
| TemplateControl |
Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control) |
| TypeName |
Ruft den Namen der vom ObjectDataSource-Objekt dargestellten Klasse ab, oder legt diesen fest. |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (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. |
| UpdateParameters |
Ruft die Parameterauflistung mit den Parametern ab, die von der durch die UpdateMethod-Eigenschaft angegebenen Methode verwendet werden. |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (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. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| Visible |
Ruft einen Wert ab, der angibt, ob das Steuerelement visuell dargestellt wird, oder legt diesen fest. (Geerbt von DataSourceControl) |
Methoden
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (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. (Geerbt von Control) |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (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. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| ClearChildControlState() |
Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (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. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt eine Auflistung zum Speichern untergeordneter Steuerelemente. (Geerbt von DataSourceControl) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (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. |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| EnsureChildControls() |
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Setzt den Eingabefokus auf das Steuerelement. (Geerbt von DataSourceControl) |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| GetView(String) |
Ruft die benannte Datenquellenansicht ab, die dem Datenquellen-Steuerelement zugeordnet ist. |
| GetViewNames() |
Ruft eine Auflistung von Namen ab, die die Liste der dem ObjectDataSource-Objekt zugeordneten Ansichtsobjekte darstellt. |
| HasControls() |
Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von DataSourceControl) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (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. |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadViewState(Object) |
Lädt den zuvor gespeicherten Ansichtszustand des ObjectDataSource-Steuerelements. |
| MapPathSecure(String) |
Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen 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. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Fügt der Seite mit dem LoadComplete-Steuerelement einen ObjectDataSource-Ereignishandler hinzu. |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von Control) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Löst das DataSourceChanged-Ereignis aus. (Geerbt von DataSourceControl) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (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. (Geerbt von DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (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. (Geerbt von Control) |
| SaveViewState() |
Speichert den Zustand des ObjectDataSource-Steuerelements. |
| 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. |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (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. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Verfolgt die am Ansichtszustand des ObjectDataSource-Steuerelements vorgenommenen Änderungen und speichert diese im StateBag-Objekt. |
| Update() |
Führt einen Aktualisierungsvorgang durch Aufrufen der von der UpdateMethod-Eigenschaft angegebenen Methode mit sämtlichen Parametern in der UpdateParameters-Auflistung aus. |
Ereignisse
| DataBinding |
Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control) |
| Deleted |
Tritt ein, wenn ein Delete()-Vorgang abgeschlossen wurde. |
| Deleting |
Tritt vor einem Delete()-Vorgang auf. |
| 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. (Geerbt von Control) |
| Filtering |
Tritt vor einem Filtervorgang auf. |
| Init |
Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control) |
| Inserted |
Tritt ein, wenn ein Insert()-Vorgang abgeschlossen wurde. |
| Inserting |
Tritt vor einem Insert()-Vorgang ein. |
| Load |
Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control) |
| ObjectCreated |
Tritt auf, nachdem das von der TypeName-Eigenschaft angegebene Objekt erstellt wurde. |
| ObjectCreating |
Tritt auf, bevor das von der TypeName-Eigenschaft angegebene Objekt erstellt wird. |
| ObjectDisposing |
Tritt auf, bevor das von der TypeName-Eigenschaft angegebene Objekt verworfen wird. |
| PreRender |
Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control) |
| Selected |
Tritt ein, wenn ein Select()-Vorgang abgeschlossen wurde. |
| Selecting |
Tritt vor einem Select()-Vorgang auf. |
| Unload |
Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control) |
| Updated |
Tritt ein, wenn ein Update()-Vorgang abgeschlossen wurde. |
| Updating |
Tritt vor einem Update()-Vorgang ein. |
Explizite Schnittstellenimplementierungen
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Elements finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Elements finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Elements finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Elements finden Sie unter HasDataBindings. (Geerbt von Control) |
| IDataSource.DataSourceChanged |
Tritt ein, wenn ein Datenquellen-Steuerelement auf eine Weise geändert wurde, die sich auf datengebundene Steuerelemente auswirkt. (Geerbt von DataSourceControl) |
| IDataSource.GetView(String) |
Ruft das benannte DataSourceView-Objekt ab, das dem DataSourceControl-Steuerelement zugeordnet ist. Einige Datenquellensteuerelemente unterstützen nur eine Ansicht, andere hingegen unterstützen mehrere Ansichten. (Geerbt von DataSourceControl) |
| IDataSource.GetViewNames() |
Ruft eine Auflistung von Namen ab, die die Liste der DataSourceView-Objekte darstellt, die dem DataSourceControl-Steuerelement zugeordnet sind. (Geerbt von DataSourceControl) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Elements finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Elements finden Sie unter HasExpressions. (Geerbt von Control) |
| IListSource.ContainsListCollection |
Gibt an, ob das Datenquellensteuerelement einer oder mehreren Listen mit Daten zugeordnet ist. (Geerbt von DataSourceControl) |
| IListSource.GetList() |
Ruft eine Liste der Datenquellensteuerelemente ab, die als Quellen für Listen mit Daten verwendet werden können. (Geerbt von DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(IDataSource) |
Ruft die Auflistung von Standardwerten für die angegebene Datenquelle ab. |
| GetMetaTable(IDataSource) |
Ruft die Metadaten für eine Tabelle im angegebenen Datenquellenobjekt ab. |
| TryGetMetaTable(IDataSource, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
Gilt für:
Weitere Informationen
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt
- Datengebundene Webserversteuerelemente
- Übersicht über das ObjectDataSource-Steuerelement
- Erstellen eines Quellobjekts für das ObjectDataSource-Steuerelement
- Verwenden des Entity Framework und des ObjectDataSource-Steuerelements
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für