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 für datengebundene Steuerelemente in mehrstufigen Webanwendungsarchitekturen 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
Dieser Abschnitt zeigt ein ObjectDataSource Markup auf einer .aspx Seite und zeigt die Geschäftsobjekte an, mit denen es arbeitet. 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 aufzurufenden Geschäftsobjektmethode an, um Daten abzurufen.
<%@ 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 beiden Grundlegenden Klassen:
Die
EmployeeLogicKlasse ist die von der Klasse verwendete ObjectDataSource Geschäftslogikklasse.Die
NorthwindEmployeeKlasse definiert das Datenobjekt, das von derGetAllEmployeesMethode derEmployeeLogicKlasse zurückgegeben wird.
Eine zusätzliche NorthwindDataException Klasse wird als Komfort 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, mit denen Daten abgerufen und aktualisiert werden, und Sie stellen die Namen dieser Methoden für das ObjectDataSource Steuerelement im Markup bereit. Während der Rendering- oder Postbackverarbeitung werden die ObjectDataSource von Ihnen angegebenen Methoden aufgerufen.
Es gibt kein visuelles Rendering des ObjectDataSource Steuerelements. Daher ObjectDataSource werden visuelle Features wie die Eigenschaft oder SkinID die EnableTheming Eigenschaft nicht unterstützt.
Purpose
Eine sehr gängige Anwendungsentwurfspraxis besteht darin, die Präsentationsebene von geschäftslogik zu trennen und die Geschäftslogik in Geschäftsobjekten zu kapseln. Diese Geschäftsobjekte bilden eine unterschiedliche Ebene zwischen der Präsentationsschicht und der Datenebene, was zu einer dreistufigen Anwendungsarchitektur führt. Mit dem ObjectDataSource Steuerelement können Entwickler ein ASP.NET Datenquellensteuerelement verwenden und gleichzeitig ihre dreistufige Anwendungsarchitektur beibehalten.
Das ObjectDataSource Steuerelement verwendet Spiegelung zum Erstellen von Instanzen von Geschäftsobjekten und zum Aufrufen von Methoden zum Abrufen, Aktualisieren, Einfügen und Löschen von Daten. Die TypeName Eigenschaft gibt den Namen der Klasse an, mit der die ObjectDataSource Klasse funktioniert. Das ObjectDataSource Steuerelement erstellt und zerstört eine Instanz der Klasse für jeden Methodenaufruf. Es enthält das Objekt nicht im Arbeitsspeicher für die Lebensdauer der Webanforderung. Dies ist ein schwerwiegender Aspekt, wenn das von Ihnen verwendete Geschäftsobjekt viele Ressourcen erfordert oder anderweitig teuer ist, um sie zu erstellen und zu zerstören. Die Verwendung eines teuren Objekts ist möglicherweise keine optimale Designauswahl, Sie können jedoch den Lebenszyklus des Objekts mithilfe der ObjectCreatingEreignisse ObjectCreatedund Ereignisse ObjectDisposing steuern.
Hinweis
Die methoden, die durch die SelectMethodMethoden , UpdateMethod, , InsertMethodund DeleteMethod Eigenschaften identifiziert werden, können Instanzmethoden oder static (Shared in Visual Basic) Methoden sein. Wenn die Methoden (Shared in Visual Basic) sind static , wird keine Instanz des Geschäftsobjekts erstellt, und die ObjectCreatingEreignisse ObjectCreatedund ObjectDisposing Ereignisse werden nicht ausgelöst.
Abrufen von Daten
Wenn Sie Daten aus einem Geschäftsobjekt abrufen möchten, legen Sie die SelectMethod Eigenschaft auf den Namen der Methode fest, die Daten abruft. Wenn die Methode kein Objekt zurückgibt IEnumerableDataSet , wird das Objekt von der Laufzeit in einer IEnumerable Auflistung umbrochen. 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 von der SelectMethod Eigenschaft angegebene Methode übergeben möchten. Damit das ObjectDataSource Steuerelement die Parameter verwenden kann, 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 ObjectDataSource Aufruf ihrer DataBind Methode gebunden sind. 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 ObjectDataSource Steuerelements an ein datengebundenes Steuerelement. Alternativ können Sie die DataSource Eigenschaft festlegen, aber dann müssen Sie die DataBind Methode des datengebundenen Steuerelements explizit 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 ausführen, z. B. Aktualisierungen, Einfügungen und Löschungen. Um diese Datenvorgänge auszuführen, legen Sie den entsprechenden Methodennamen und alle zugehörigen Parameter für den Vorgang fest, den Sie ausführen möchten. Legen Sie z. B. für einen Aktualisierungsvorgang die UpdateMethod Eigenschaft auf den Namen der Geschäftsobjektmethode fest, die Aktualisierungen 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 den Feldnamen im datengebundenen Steuerelement entsprechen. Die Aktualisierung wird ausgeführt, wenn die Update Methode entweder explizit vom Code oder automatisch von einem datengebundenen Steuerelement aufgerufen wird. Das gleiche allgemeine Muster wird für Delete und Insert Vorgänge befolgt. Geschäftsobjekte werden davon ausgegangen, dass diese Arten von Datenvorgängen jeweils jeweils und nicht in einem Batch ausgeführt werden.
Filtern von Daten
Das ObjectDataSource Steuerelement kann Daten filtern, die von der SelectMethod Eigenschaft abgerufen werden, wenn die Daten als objekt DataSetDataTable 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 die ObjectDataSource Instanz des Geschäftsobjekts nicht über mehrere Anforderungen hinweg beibehalten wird, kann es das Ergebnis des Aufrufs 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 die Verwendung der SelectMethod Spiegelung aufzurufen. Mit der Zwischenspeicherung können Sie das Erstellen des Objekts vermeiden und dessen Datenmethode auf Kosten des Arbeitsspeichers auf dem Webserver aufrufen. Die ObjectDataSource Daten werden automatisch zwischengespeichert, wenn die EnableCaching Eigenschaft auf true"" festgelegt ist, und die CacheDuration Eigenschaft wird auf die Anzahl von Sekunden festgelegt, die der Cache speichert, bevor der Cache verworfen wird. Sie können auch eine CacheExpirationPolicy Eigenschaft und eine optionale SqlCacheDependency Eigenschaft angeben. Mit dem ObjectDataSource Steuerelement können Sie alle Datentypen zwischenspeichern. Sie sollten jedoch keine Objekte zwischenspeichern, die Ressourcen oder Den Zustand beibehalten, die nicht für mehrere Anforderungen freigegeben werden können (z. B. ein geöffnetes SqlDataReader Objekt), da dieselbe Instanz des Objekts zum Warten mehrerer Anforderungen verwendet wird.
Funktionen
In der folgenden Tabelle werden die Features des ObjectDataSource Steuerelements beschrieben.
| Fähigkeit | Anforderungen |
|---|---|
| Auswählen | Legen Sie die SelectMethod Eigenschaft auf den Namen der Geschäftsobjektmethode fest, die Daten auswählt, und fügen 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. |
| Filterung | Legen Sie die FilterExpression Eigenschaft auf einen Filterausdruck fest, und fügen Sie optional der Auflistung Parameter hinzu FilterParameters , um die Daten zu filtern, wenn die Select Methode aufgerufen wird. Die von der SelectMethod Eigenschaft angegebene Methode muss ein oder .DataTableDataSet |
| Paging | Datenquellen-Paging wird unterstützt, wenn die SelectMethod Methode Parameter für die maximale Anzahl abzurufender Datensätze und den Index des ersten abzurufenden Datensatzes enthält. Die Namen dieser Parameter müssen in den MaximumRowsParameterName jeweiligen Eigenschaften festgelegt StartRowIndexParameterName werden. Ein datengebundenes Steuerelement kann das Paging selbst ausführen, auch wenn das ObjectDataSource Steuerelement das Paging nicht direkt in der durch die SelectMethod Eigenschaft angegebenen Methode unterstützt. Die Anforderung, dass das datengebundene Steuerelement dies tun kann, besteht darin, dass die durch die 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 fügen 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 fügen 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 fügen Sie alle erforderlichen Parameter in die InsertParameters Auflistung ein. |
| Zwischenspeicherung | Legen Sie die EnableCaching Eigenschaft auf trueund die CacheDuration Eigenschaften CacheExpirationPolicy entsprechend dem Zwischenspeicherungsverhalten für zwischengespeicherte Daten fest. |
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. Die Clientkultur kann z. B. TT/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 in ein TextBox Steuerelement als 5/10/2009 eingegeben, aber als 10. Mai 2009 interpretiert werden. Der 15. Oktober 2009 würde als 15.10.2009 eingegeben und als ungültiges Datum abgelehnt.
Datenansicht
Wie bei allen Datenquellensteuerelementen ist das ObjectDataSource Steuerelement einer Datenquellenansichtsklasse zugeordnet. Während das ObjectDataSource Steuerelement die Schnittstelle ist, die der Seitenentwickler für die Arbeit mit Daten verwendet, ist die ObjectDataSourceView Klasse die Schnittstelle, mit der datengebundene Steuerelemente verwendet werden. Darüber hinaus beschreibt die ObjectDataSourceView Klasse die Funktionen des Datenquellensteuerelements und führt die eigentliche Arbeit aus. Das ObjectDataSource Steuerelement hat nur ein zugeordnetes ObjectDataSourceViewSteuerelement, und es wird immer benannt DefaultView. Während das ObjectDataSourceView Objekt von der GetView Methode verfügbar gemacht wird, werden viele seiner Eigenschaften und Methoden direkt vom ObjectDataSource Steuerelement umbrochen und verfügbar gemacht. Hinter den Kulissen führt das ObjectDataSourceView Objekt alle Datenvorgänge aus, einschließlich Abrufen, Einfügen, Aktualisieren, Löschen, Filtern und Sortieren 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 in UpdateMethodder Datenkontextklasse fest, InsertMethodDeleteMethod die die entsprechenden Vorgänge ausführen. Sie müssen einen Ereignishandler für das ObjectDisposing Ereignis erstellen, um die Löschung 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 Auswahlvorgang zu löschen. Weitere Informationen zum Erstellen von LINQ to SQL-Klassen finden Sie unter How to: Create LINQ to SQL Classes in a Web Project. Ein Beispiel zum Abbrechen der Löschung einer Datenkontextklasse finden Sie im ObjectDisposing Ereignis.
Verwenden von Entity Framework
Sie können das ObjectDataSource Steuerelement auch mit dem Entity Framework verwenden. Weitere Informationen finden Sie unter Using the Entity Framework and the ObjectDataSource Control.
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
| Name | Beschreibung |
|---|---|
| ObjectDataSource() |
Initialisiert eine neue Instanz der ObjectDataSource-Klasse. |
| ObjectDataSource(String, String) |
Initialisiert eine neue Instanz der ObjectDataSource Klasse mit dem angegebenen Typnamen und dem Namen der Datenabrufmethode. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| CacheDuration |
Ruft die Dauer in Sekunden ab, die das Datenquellensteuerelement Daten zwischenspeichert, die von der SelectMethod Eigenschaft abgerufen werden, oder legt diese fest. |
| CacheExpirationPolicy |
Ruft ab oder legt das Cacheablaufverhalten fest, das in Kombination mit der Dauer das Verhalten des Caches beschreibt, den das Datenquellensteuerelement verwendet. |
| CacheKeyDependency |
Dient zum Abrufen oder Festlegen einer benutzerdefinierten Schlüsselabhängigkeit, die mit allen Datencacheobjekten verknüpft ist, die vom Datenquellensteuerelement erstellt werden. |
| 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 Serversteuerelementbezeichner ab. (Geerbt von DataSourceControl) |
| ClientIDMode |
Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet. (Geerbt von DataSourceControl) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ConflictDetection |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob nur die neuen Werte an die |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von DataSourceControl) |
| ConvertNullToDBNull |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Werte, die Parameter an einen Aktualisierungs-, Einfüge- oder Löschvorgang übergeben werden, automatisch in |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DataObjectTypeName |
Dient zum Abrufen oder Festlegen des Namens einer Klasse, die das ObjectDataSource Steuerelement für einen Parameter in einem Aktualisierungs-, Einfügen- oder Löschen-Datenvorgang verwendet, anstatt einzelne Werte aus dem datengebundenen Steuerelement zu übergeben. |
| DeleteMethod |
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSource Steuerelement zum Löschen von Daten aufruft. |
| DeleteParameters |
Ruft die Parameterauflistung ab, die die Parameter enthält, die von der DeleteMethod Methode verwendet werden. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| EnableCaching |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die ObjectDataSource Datenzwischenspeicherung aktiviert hat. |
| EnablePaging |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Datenquellensteuerelement das Paging über die datenmenge unterstützt, die sie abruft. |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob dieses Steuerelement Designs unterstützt. (Geerbt von DataSourceControl) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| FilterExpression |
Dient zum Abrufen oder Festlegen eines Filterausdrucks, der angewendet wird, wenn die von der SelectMethod Eigenschaft angegebene Methode aufgerufen wird. |
| FilterParameters |
Ruft eine Auflistung von Parametern ab, die allen Parameterplatzhaltern in der FilterExpression Zeichenfolge zugeordnet sind. |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| InsertMethod |
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSource Steuerelement zum Einfügen von Daten aufruft. |
| InsertParameters |
Ruft die Parameterauflistung ab, die die Parameter enthält, die von der InsertMethod Eigenschaft verwendet werden. |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand 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 am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| MaximumRowsParameterName |
Dient zum Abrufen oder Festlegen des Namens des Datenabrufmethodenparameters des Geschäftsobjekts, der verwendet wird, um die Anzahl der Datensätze anzugeben, die für die Unterstützung der Datenquellen paging abgerufen werden sollen. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control) |
| OldValuesParameterFormatString |
Dient zum Abrufen oder Festlegen einer Formatzeichenfolge, die auf die Namen der Parameter für originale Werte angewendet werden soll, die an die oder |
| 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 Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| ParsingCulture |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, welche Kulturinformationen verwendet werden, wenn Zeichenfolgenwerte in tatsächliche Eigenschaftstypen konvertiert werden, um ein Objekt des typs zu erstellen, der durch DataObjectTypeName. |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| SelectCountMethod |
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSource Steuerelement aufruft, um eine Zeilenanzahl abzurufen. |
| SelectMethod |
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSource Steuerelement aufruft, um Daten abzurufen. |
| SelectParameters |
Ruft eine Auflistung von Parametern ab, die von der durch die SelectMethod Eigenschaft angegebenen Methode verwendet werden. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Haut ab, die auf das DataSourceControl Steuerelement angewendet werden soll. (Geerbt von DataSourceControl) |
| SortParameterName |
Dient zum Abrufen oder Festlegen des Namens des Geschäftsobjekts, das der SelectMethod Parameter zum Angeben eines Sortierausdrucks für die Unterstützung der Datenquellensortierung verwendet hat. |
| SqlCacheDependency |
Dient zum Abrufen oder Festlegen einer durch Semikolons getrennten Zeichenfolge, die angibt, welche Datenbanken und Tabellen für die Microsoft SQL Server-Cacheabhängigkeit verwendet werden sollen. |
| StartRowIndexParameterName |
Dient zum Abrufen oder Festlegen des Namens des Datenabrufmethodenparameters, der verwendet wird, um den Wert des Bezeichners des ersten Datensatzes anzugeben, der für die Unterstützung der Datenquellen paging abgerufen werden soll. |
| TemplateControl |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| TypeName |
Dient zum Abrufen oder Festlegen des Namens der Klasse, die das ObjectDataSource Objekt darstellt. |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| UpdateMethod |
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSource Steuerelement zum Aktualisieren von Daten aufruft. |
| UpdateParameters |
Ruft die Parameterauflistung ab, die die Parameter enthält, die von der Methode verwendet werden, die von der UpdateMethod Eigenschaft angegeben wird. |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement visuell angezeigt wird. (Geerbt von DataSourceControl) |
Methoden
| Name | Beschreibung |
|---|---|
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control) |
| ApplyStyleSheetSkin(Page) |
Wendet die Formatvorlageneigenschaften an, die im Seitenstylesheet definiert sind, auf das Steuerelement. (Geerbt von DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt eine Sammlung 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 einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Delete() |
Führt einen Löschvorgang aus, indem die Methode aufgerufen wird, die von der DeleteMethod Eigenschaft mit allen Parametern identifiziert wird, die sich in der DeleteParameters Auflistung befinden. |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf das Steuerelement fest. (Geerbt von DataSourceControl) |
| GetDesignModeState() |
Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Dient 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 die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| GetView(String) |
Ruft die benannte Datenquellenansicht ab, die dem Datenquellensteuerelement zugeordnet ist. |
| GetViewNames() |
Ruft eine Auflistung von Namen ab, die die Liste der Ansichtsobjekte darstellt, die dem ObjectDataSource Objekt zugeordnet sind. |
| HasControls() |
Bestimmt, 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 untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| Insert() |
Führt einen Einfügevorgang aus, indem die Methode aufgerufen wird, die durch die InsertMethod Eigenschaft und alle Parameter in der InsertParameters Auflistung identifiziert wird. |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadViewState(Object) |
Lädt den zuvor gespeicherten Ansichtszustand des ObjectDataSource Steuerelements. |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Fügt der Seite, die das ObjectDataSource Steuerelement enthält, einen LoadComplete 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 Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements 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 Serversteuerelementinhalte an ein bereitgestelltes HtmlTextWriter Objekt, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von DataSourceControl) |
| 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) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert den Zustand des ObjectDataSource Steuerelements. |
| Select() |
Ruft Daten aus dem zugrunde liegenden Datenspeicher ab, indem die Methode aufgerufen wird, die von der SelectMethod Eigenschaft mit den Parametern in der SelectParameters Auflistung identifiziert wird. |
| SetDesignModeState(IDictionary) |
Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Verfolgt Änderungen am Ansichtszustand des ObjectDataSource Steuerelements nach, sodass sie im StateBag Objekt gespeichert werden können. |
| Update() |
Führt einen Aktualisierungsvorgang aus, indem die Methode aufgerufen wird, die durch die UpdateMethod Eigenschaft und alle Parameter in der UpdateParameters Auflistung identifiziert wird. |
Ereignisse
| Name | Beschreibung |
|---|---|
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Deleted |
Tritt auf, wenn ein Delete() Vorgang abgeschlossen wurde. |
| Deleting |
Tritt vor einem Vorgang auf Delete() . |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Filtering |
Tritt vor einem Filtervorgang auf. |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Inserted |
Tritt auf, wenn ein Insert() Vorgang abgeschlossen ist. |
| Inserting |
Tritt vor einem Insert() Vorgang auf. |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| ObjectCreated |
Tritt ein, nachdem das objekt, das von der TypeName Eigenschaft identifiziert wird, erstellt wurde. |
| ObjectCreating |
Tritt auf, bevor das Objekt erstellt wird, das von der TypeName Eigenschaft identifiziert wird. |
| ObjectDisposing |
Tritt auf, bevor das durch die TypeName Eigenschaft identifizierte Objekt verworfen wird. |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| Selected |
Tritt auf, wenn ein Select() Vorgang abgeschlossen wurde. |
| Selecting |
Tritt vor einem Vorgang auf Select() . |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
| Updated |
Tritt auf, wenn ein Update() Vorgang abgeschlossen ist. |
| Updating |
Tritt vor einem Update() Vorgang auf. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control) |
| IDataSource.DataSourceChanged |
Tritt auf, wenn sich ein Datenquellensteuerelement auf eine Weise geändert hat, 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, während andere mehr als eine Ansicht unterstützen. (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 Mitglieds finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control) |
| IListSource.ContainsListCollection |
Gibt an, ob das Datenquellensteuerelement einer oder mehreren Datenlisten zugeordnet ist. (Geerbt von DataSourceControl) |
| IListSource.GetList() |
Ruft eine Liste der Datenquellensteuerelemente ab, die als Datenquellen von Datenlisten verwendet werden können. (Geerbt von DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| 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 metatable -Objekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(IDataSource) |
Ruft die Auflistung der Standardwerte 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
- Datenquellenwebserversteuerelemente
- ObjectDataSource-Steuerelement ( Übersicht)
- Erstellen eines ObjectDataSource-Steuerelementquellobjekts
- Verwenden des Entity Framework und des ObjectDataSource-Steuerelements
