ObjectDataSource Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Olyan üzleti objektumot jelöl, amely adatokat biztosít a többtényezős webalkalmazás-architektúrák adatkötött vezérlőinek.
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- Öröklődés
- Attribútumok
Példák
Ez a szakasz egy ObjectDataSource .aspx lapon egy korrektúrát jelenít meg, és megjeleníti azokat az üzleti objektumokat, amelyekkel együttműködik. Ilyen például a .aspx lap. Olyan vezérlőt GridView tartalmaz, amely egy ObjectDataSource vezérlőelemhez van kötve. A ObjectDataSource vezérlőelem-korrektúra megadja az üzleti objektum nevét és a meghívandó üzleti objektum metódusának nevét az adatok lekéréséhez.
<%@ 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>
Az alábbi példa azt az üzleti objektumot mutatja be, amelyet a ObjectDataSource vezérlő a .aspx lapon használ. (Sok más ObjectDataSource példakód is használja ezt az üzleti objektumot.) A példa a következő két alaposztályból áll:
Az
EmployeeLogicosztály az üzleti logikai osztály, amelyet a ObjectDataSource rendszer használ.Az
NorthwindEmployeeosztály határozza meg az osztály metódusa által visszaadottGetAllEmployeesadatobjektumotEmployeeLogic.
Egy további NorthwindDataException osztályt is biztosítunk.
Ez a példaosztály-készlet a Northwind Traders adatbázissal működik, amely Microsoft SQL Server és Microsoft Access érhető el. A teljes munka példához össze kell állítania és használnia kell ezeket az osztályokat a megadott .aspx lap példájával.
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
Megjegyzések
Ebben a témakörben:
Bevezetés
A ObjectDataSource vezérlők egy ön által létrehozott osztálysal működnek. Olyan metódusokat hozhat létre, amelyek adatokat kérnek le és frissítenek, és meg kell adnia a metódusok nevét a ObjectDataSource korrektúra vezérlőelemének. A renderelés vagy a visszaállítás utáni feldolgozás során a rendszer meghívja ObjectDataSource a megadott metódusokat.
A vezérlő nem jelenít meg vizualizációt ObjectDataSource . Ennek eredményeképpen a ObjectDataSource vizualizációs funkciók, például a tulajdonság vagy EnableTheming a SkinID tulajdonság nem támogatottak.
Alkalmazás célja
Az alkalmazások nagyon gyakori tervezési gyakorlata, hogy elkülöníti a bemutató réteget az üzleti logikától, és üzleti objektumokban foglalja magában az üzleti logikát. Ezek az üzleti objektumok külön réteget alkotnak a bemutató réteg és az adatréteg között, ami háromrétegű alkalmazásarchitektúrát eredményez. A ObjectDataSource vezérlő lehetővé teszi a fejlesztők számára, hogy ASP.NET adatforrás-vezérlőt használjanak, miközben megtartják a háromrétegű alkalmazásarchitektúrát.
A ObjectDataSource vezérlő tükröződés használatával hozza létre az üzleti objektumok példányait, és metódusokat hív meg rajtuk az adatok lekéréséhez, frissítéséhez, beszúrásához és törléséhez. A TypeName tulajdonság azonosítja annak az osztálynak a nevét, amellyel a ObjectDataSource munka működik. A ObjectDataSource vezérlő létrehozza és megsemmisíti az osztály egy példányát minden metódushíváshoz; nem tárolja az objektumot a memóriában a webes kérés teljes élettartama alatt. Ez komoly szempont, ha a használt üzleti objektum sok erőforrást igényel, vagy egyébként költséges létrehozni és megsemmisíteni. A drága objektumok használata nem feltétlenül optimális kialakítási választás, de az objektum életciklusát a , ObjectCreatingés ObjectCreated az ObjectDisposingesemények használatával szabályozhatja.
Note
A SelectMethod, UpdateMethod, InsertMethod és DeleteMethod tulajdonságok által azonosított metódusok lehetnek példánymeta vagy static (Shared Visual Basic) metódusok. Ha a metódusok static (Shared Visual Basic), az üzleti objektum egy példánya nem jön létre, és a ObjectCreating, ObjectCreated és ObjectDisposing események nem jönnek létre.
Adatok beolvasása
Ha üzleti objektumból szeretne adatokat lekérni, állítsa a SelectMethod tulajdonságot az adatokat lekérő metódus nevére. Ha a metódus nem ad vissza egy vagy IEnumerable több DataSet objektumot, az objektumot egy gyűjtemény futtatókörnyezete IEnumerable burkolta be. Ha a metódus aláírása paraméterekkel rendelkezik, objektumokat adhat hozzá Parameter a SelectParameters gyűjteményhez, majd azokhoz az értékekhez kötheti őket, amelyeket át szeretne adni a SelectMethod tulajdonság által megadott metódusnak. Ahhoz, hogy a ObjectDataSource vezérlő használni lehessen a paramétereket, a paramétereknek meg kell egyeznie a metódus-aláírásban szereplő paraméterek nevével és típusával. További információ: Paraméterek használata az ObjectDataSource-vezérlővel.
A ObjectDataSource vezérlő minden alkalommal lekéri az adatokat, amikor a Select metódust meghívják. Ez a metódus programozott hozzáférést biztosít a tulajdonság által SelectMethod megadott metódushoz. A tulajdonság által SelectMethod megadott metódust a metódus meghívásának időpontjához ObjectDataSource kötött vezérlők automatikusan meghívják DataBind . Ha egy adathoz kötött vezérlőelem tulajdonságát állítja be DataSourceID , a vezérlő szükség szerint automatikusan kapcsolódik az adatforrásból származó adatokhoz.
DataSourceID A tulajdonság beállítása ajánlott módszer egy vezérlőelem adatkötésű vezérlőelemhez való kötéséhezObjectDataSource. Másik lehetőségként beállíthatja a DataSource tulajdonságot, de akkor explicit módon meg kell hívnia az DataBind adatkötött vezérlőelem metódusát. A metódust Select programozott módon bármikor meghívhatja az adatok lekéréséhez.
Az adatforrás-vezérlőkhöz kötött adatkötési vezérlőkkel kapcsolatos további információkért lásd: Adatkötés adatforrás-vezérlővel.
Adatműveletek végrehajtása
A vezérlő által használható üzleti objektum ObjectDataSource képességeitől függően adatműveleteket hajthat végre, például frissítéseket, beszúrásokat és törléseket. Ezen adatműveletek végrehajtásához adja meg a megfelelő metódusnevet és a végrehajtandó művelethez tartozó paramétereket. Egy frissítési művelet esetében például állítsa a UpdateMethod tulajdonságot annak az üzleti objektum metódusnak a nevére, amely frissítéseket hajt végre, és adja hozzá a szükséges paramétereket a UpdateParameters gyűjteményhez. Ha a ObjectDataSource vezérlő egy adathoz kötött vezérlőelemhez van társítva, a paramétereket az adatkötésű vezérlő hozzáadja. Ebben az esetben győződjön meg arról, hogy a metódus paraméterneve megegyezik az adatkötött vezérlőelem mezőnevével. A frissítés a metódus meghívásakor Update történik, vagy explicit módon a kód, vagy automatikusan egy adathoz kötött vezérlő. Ugyanezt az általános mintát követi a rendszer a műveletekhez és Delete a műveletekhezInsert. Az üzleti objektumok feltételezik, hogy az ilyen típusú adatműveleteket egyszerre egy rekordon hajtják végre, nem pedig kötegelve.
Adatok szűrése
A ObjectDataSource vezérlő szűrheti a SelectMethod tulajdonság által lekért adatokat, ha az adatok visszaadása objektumként vagy DataSet objektumként DataTable történik. A tulajdonságot szűrőkifejezésre állíthatja FilterExpression úgy, hogy formázza a sztring szintaxisát, és a kifejezés értékeit a gyűjteményben FilterParameters megadott paraméterekhez köti.
Caching
Bár az ObjectDataSource üzleti objektum példánya nem marad meg több kérelem között, gyorsítótárazhatja a tulajdonság által SelectMethod azonosított metódus meghívásának eredményét. Amíg az adatok gyorsítótárazva lesznek, a metódus későbbi hívásai a Select gyorsítótárazott adatokat adják vissza az üzleti objektum létrehozása és tükrözés használatával történő meghívása SelectMethod helyett. A gyorsítótárazással elkerülheti az objektum létrehozását és az adatmetódus meghívását a webkiszolgálón lévő memória rovására. A ObjectDataSource tulajdonság beállításakor EnableCachinga rendszer automatikusan gyorsítótárazza az true adatokat, a CacheDuration tulajdonság pedig arra a másodpercre van állítva, amíg a gyorsítótár a gyorsítótár elvetése előtt tárolja az adatokat. Megadhat egy tulajdonságot CacheExpirationPolicy és egy választható SqlCacheDependency tulajdonságot is. A ObjectDataSource vezérlő lehetővé teszi az összes adattípus gyorsítótárazását, de nem szabad gyorsítótáraznia azokat az objektumokat, amelyek olyan erőforrásokat vagy állapotokat őriznek meg, amelyek nem oszthatók meg több kérés (például egy nyitott SqlDataReader objektum) szolgáltatásához, mivel az objektum ugyanazon példánya több kérés kiszolgálására lesz használva.
Funkciók
Az alábbi táblázat a vezérlő funkcióit ObjectDataSource ismerteti.
| Képesség | Requirements |
|---|---|
| Kiválasztása | Állítsa be a SelectMethod tulajdonságot annak az üzleti objektum metódusnak a nevére, amely adatokat választ ki, és a szükséges paramétereket programozott módon vagy egy adathoz kötött vezérlőelem használatával is belefoglalja a SelectParameters gyűjteménybe. |
| Rendezés | Állítsa a SortParameterName tulajdonságot a paraméter nevére a SelectMethod rendezési feltételeket tartalmazó metódusban. |
| Filtering | Állítsa be a FilterExpression tulajdonságot szűrőkifejezésre, és opcionálisan adjon hozzá paramétereket a gyűjteményhez az FilterParameters adatok szűréséhez a Select metódus meghívásakor. A tulajdonság által megadott metódusnak SelectMethod egy vagy DataSettöbb értéket kell visszaadniaDataTable. |
| Paging | Az adatforrások lapozása akkor támogatott, ha a SelectMethod metódus a lekérendő rekordok maximális számának és az első lekérendő rekord indexének paramétereit tartalmazza. Ezeknek a paramétereknek a nevét meg kell adni a tulajdonságokban és a MaximumRowsParameterNameStartRowIndexParameterName tulajdonságokban. Az adathoz kötött vezérlők akkor is képesek lehetnek lapozásra, ha a ObjectDataSource vezérlőelem nem támogatja közvetlenül a tulajdonság által megadott metódusban történő lapozást SelectMethod . Az adathoz kötött vezérlőnek ezt meg kell tudnia tenni, hogy a SelectMethod tulajdonság által megadott metódus egy olyan objektumot ad vissza, amely megvalósítja az interfészt ICollection . |
| Frissítés | Állítsa be a UpdateMethod tulajdonságot annak az üzleti objektum metódusnak a nevére, amely frissíti az adatokat, és tartalmazza a gyűjteményben a UpdateParameters szükséges paramétereket. |
| Törlés | Állítsa a DeleteMethod tulajdonságot az adatokat törlő üzleti objektum metódusának vagy függvényének nevére, és adja meg a gyűjteményben a DeleteParameters szükséges paramétereket. |
| Beillesztés | Állítsa a InsertMethod tulajdonságot az adatokat beszúró üzleti objektum metódusának vagy függvényének nevére, és adja meg a szükséges paramétereket a InsertParameters gyűjteményben. |
| Caching | Állítsa be a EnableCaching tulajdonságot truea gyorsítótárazott adatok gyorsítótárazási viselkedésének megfelelően, és CacheDurationCacheExpirationPolicy adja meg a tulajdonságokat. |
Note
Amikor az ObjectDataSource osztály használatával frissíti vagy beszúrja az adatokat, az ügyfélnél megadott sztringek nem lesznek automatikusan konvertálva az ügyfélkultúra formátumából a kiszolgálói kultúra formátumába. Előfordulhat például, hogy az ügyfélkultúra a DD/MM/YYYYY értéket adja meg dátumformátumként, a kiszolgálón pedig az MM/DD/YYYY dátumformátumot. Ebben az esetben 2009. október 5-ét 2009 TextBox . 2009. október 15-én 2009.10.15-én lett volna megadva, és érvénytelen dátumként lenne elutasítva.
Adatnézet
Az adatforrás-vezérlőkhöz hasonlóan a ObjectDataSource vezérlő is egy adatforrásnézet-osztályhoz van társítva. Bár a ObjectDataSource vezérlő az a felület, amellyel a lap fejlesztője adatokat használ, az ObjectDataSourceView osztály az a felület, amellyel az adatkötéses vezérlők működnek. Az osztály emellett ObjectDataSourceView leírja az adatforrás-vezérlés képességeit, és elvégzi a tényleges munkát. A ObjectDataSource vezérlőelemhez csak egy társítva ObjectDataSourceViewvan, és mindig el van nevezve DefaultView. Bár az ObjectDataSourceView objektumot a GetView metódus teszi ki, számos tulajdonságát és metódusát közvetlenül a ObjectDataSource vezérlő burkolja és teszi elérhetővé. A színfalak mögött az ObjectDataSourceView objektum minden adatműveletet végrehajt, beleértve az adatok beolvasását, beszúrását, frissítését, törlését, szűrését és rendezését. További információért lásd ObjectDataSourceView.
A LINQ használata az SQL-hez
A vezérlőt ObjectDataSource linq és SQL osztály használatával is használhatja. Ehhez a tulajdonságot az TypeName adatkörnyezet osztály nevére kell állítania. A , , SelectMethodUpdateMethodés InsertMethod metódusokat a megfelelő műveleteket végrehajtó adatkörnyezeti osztály metódusaira is beállíthatjaDeleteMethod. Az adatkörnyezeti osztály eltávolításának ObjectDisposing megszakításához létre kell hoznia egy eseménykezelőt az eseményhez. Erre a lépésre azért van szükség, mert az SQL-hez irányuló LINQ támogatja a halasztott végrehajtást, míg a ObjectDataSource vezérlő megpróbálja megsemmisíteni az adatkörnyezetet a Kiválasztás művelet után. További információ a LINQ SQL-osztályokhoz való létrehozásáról: Hogyan is: LINQ létrehozása SQL-osztályokhoz webes Project. Az adatkörnyezeti osztály eltávolításának megszakításáról az eseményben talál ObjectDisposing példát.
Az Entity Framework használata
A vezérlőt az ObjectDataSource Entity Framework használatával is használhatja. További információ: Az Entity Framework és az ObjectDataSource control használata.
Deklaratív szintaxis
<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>
Konstruktorok
| Name | Description |
|---|---|
| ObjectDataSource() |
Inicializálja a ObjectDataSource osztály új példányát. |
| ObjectDataSource(String, String) |
Inicializálja az osztály új példányát a ObjectDataSource megadott típusnévvel és adatlekérési metódusnévvel. |
Tulajdonságok
| Name | Description |
|---|---|
| Adapter |
Lekéri a vezérlő böngészőspecifikus adapterét. (Öröklődés forrása Control) |
| AppRelativeTemplateSourceDirectory |
Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl. (Öröklődés forrása Control) |
| BindingContainer |
Lekéri a vezérlő adatkötését tartalmazó vezérlőt. (Öröklődés forrása Control) |
| CacheDuration |
Másodpercek alatt lekéri vagy beállítja, hogy az adatforrás-vezérlő gyorsítótárazza a SelectMethod tulajdonság által lekért adatokat. |
| CacheExpirationPolicy |
Lekéri vagy beállítja a gyorsítótár lejárati viselkedését, amely az időtartammal kombinálva leírja az adatforrás-vezérlő által használt gyorsítótár viselkedését. |
| CacheKeyDependency |
Lekéri vagy beállít egy felhasználó által definiált kulcsfüggőséget, amely az adatforrás-vezérlő által létrehozott összes adatgyorsítótár-objektumhoz kapcsolódik. |
| ChildControlsCreated |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e. (Öröklődés forrása Control) |
| ClientID |
Lekéri a ASP.NET által létrehozott kiszolgálóvezérlő-azonosítót. (Öröklődés forrása DataSourceControl) |
| ClientIDMode |
Ez a tulajdonság nem használható adatforrás-vezérlőkhöz. (Öröklődés forrása DataSourceControl) |
| ClientIDSeparator |
Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli. (Öröklődés forrása Control) |
| ConflictDetection |
Lekéri vagy beállít egy értéket, amely meghatározza, hogy csak az új értékek lesznek-e átadva a |
| Context |
Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot. (Öröklődés forrása Control) |
| Controls |
ControlCollection Lekéri az objektumot, amely egy adott kiszolgálóvezérlő gyermekvezérlőit jelöli a felhasználói felületi hierarchiában. (Öröklődés forrása DataSourceControl) |
| ConvertNullToDBNull |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a Parameter vezérlő automatikusan konvertálja-e a frissítési, beszúrási vagy törlési műveletnek átadott értékeket az |
| DataItemContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer. (Öröklődés forrása Control) |
| DataKeysContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl. (Öröklődés forrása Control) |
| DataObjectTypeName |
Lekéri vagy beállítja annak az osztálynak a nevét, amelyet a ObjectDataSource vezérlő egy paraméterhez használ egy frissítési, beszúrási vagy törlési műveletben, ahelyett, hogy egyedi értékeket adna át az adathoz kötött vezérlőből. |
| DeleteMethod |
Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a vezérlő meghív az ObjectDataSource adatok törléséhez. |
| DeleteParameters |
Lekéri a metódus által használt paramétereket tartalmazó paramétergyűjteményt DeleteMethod . |
| DesignMode |
Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen. (Öröklődés forrása Control) |
| EnableCaching |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a ObjectDataSource vezérlő engedélyezve van-e az adatok gyorsítótárazása. |
| EnablePaging |
Lekéri vagy beállít egy értéket, amely jelzi, hogy az adatforrás-vezérlő támogatja-e a lekért adatkészlet lapozását. |
| EnableTheming |
Értéket kap, amely jelzi, hogy ez a vezérlő támogatja-e a témákat. (Öröklődés forrása DataSourceControl) |
| EnableViewState |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a kiszolgálóvezérlő megőrzi-e a nézetállapotát, és hogy a gyermekvezérlők nézetállapota megmarad-e a kérést kérő ügyfélnek. (Öröklődés forrása Control) |
| Events |
Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett. (Öröklődés forrása Control) |
| FilterExpression |
Lekéri vagy beállítja a tulajdonság által SelectMethod megadott metódus meghívásakor alkalmazott szűrőkifejezést. |
| FilterParameters |
Lekéri a sztring bármely paraméterhelyőrzőjével társított paraméterek gyűjteményét FilterExpression . |
| HasChildViewState |
Beolvas egy értéket, amely jelzi, hogy az aktuális kiszolgálóvezérlő gyermekvezérlői rendelkeznek-e mentett nézetállapot-beállításokkal. (Öröklődés forrása Control) |
| ID |
Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót. (Öröklődés forrása Control) |
| IdSeparator |
Lekéri a vezérlőazonosítók elválasztásához használt karaktert. (Öröklődés forrása Control) |
| InsertMethod |
Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a ObjectDataSource vezérlő meghív az adatok beszúrásához. |
| InsertParameters |
Lekéri a tulajdonság által használt paramétereket tartalmazó paramétergyűjteményt InsertMethod . |
| IsChildControlStateCleared |
Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal. (Öröklődés forrása Control) |
| IsTrackingViewState |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait. (Öröklődés forrása Control) |
| IsViewStateEnabled |
Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez. (Öröklődés forrása Control) |
| LoadViewStateByID |
Beolvas egy értéket, amely jelzi, hogy a vezérlő részt vesz-e a nézet állapotának index helyett való ID betöltésében. (Öröklődés forrása Control) |
| MaximumRowsParameterName |
Lekéri vagy beállítja az üzleti objektum adatlekérési metódusparaméterének nevét, amely az adatforrás lapozási támogatásához beolvasandó rekordok számát jelzi. |
| NamingContainer |
Lekéri a kiszolgálóvezérlő elnevezési tárolójára mutató hivatkozást, amely egyedi névteret hoz létre az azonos ID tulajdonságértékkel rendelkező kiszolgálóvezérlők megkülönböztetéséhez. (Öröklődés forrása Control) |
| OldValuesParameterFormatString |
Lekéri vagy beállít egy formátumsztringet, amely az eredeti értékeknek a metódusoknak átadott |
| Page |
A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap. (Öröklődés forrása Control) |
| Parent |
Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában. (Öröklődés forrása Control) |
| ParsingCulture |
Lekéri vagy beállít egy értéket, amely azt jelzi, hogy milyen kulturális információk használhatók a sztringértékek tényleges tulajdonságtípusokká alakításakor, hogy létrehozhasson egy objektumot az általuk jelzett típusból DataObjectTypeName. |
| RenderingCompatibility |
Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e. (Öröklődés forrása Control) |
| SelectCountMethod |
Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a ObjectDataSource vezérlőelem meghív a sorok számának lekéréséhez. |
| SelectMethod |
Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a vezérlő meghív az ObjectDataSource adatok lekéréséhez. |
| SelectParameters |
Lekéri a tulajdonság által megadott metódus által használt paraméterek gyűjteményét SelectMethod . |
| Site |
Információt kap arról a tárolóról, amely az aktuális vezérlőt üzemelteti, amikor egy tervezőfelületen rendereli. (Öröklődés forrása Control) |
| SkinID |
Ráveszi a bőrt, hogy alkalmazza a DataSourceControl vezérlő. (Öröklődés forrása DataSourceControl) |
| SortParameterName |
Lekéri vagy beállítja annak az üzleti objektumnak a nevét, amelyet a SelectMethod paraméter az adatforrás-rendezési támogatáshoz használt rendezési kifejezés megadásához használt. |
| SqlCacheDependency |
Lekéri vagy beállít egy pontosvesszővel tagolt sztringet, amely jelzi, hogy mely adatbázisok és táblák használhatók a Microsoft SQL Server gyorsítótár-függőséghez. |
| StartRowIndexParameterName |
Lekéri vagy beállítja annak az adatlekérési metódusparaméternek a nevét, amely az adatforrás lapozási támogatásához beolvasandó első rekord azonosítójának értékét jelzi. |
| TemplateControl |
Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást. (Öröklődés forrása Control) |
| TemplateSourceDirectory |
Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl. (Öröklődés forrása Control) |
| TypeName |
Lekéri vagy beállítja annak az osztálynak a nevét, amelyet az ObjectDataSource objektum képvisel. |
| UniqueID |
Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót. (Öröklődés forrása Control) |
| UpdateMethod |
Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a vezérlő meghív az ObjectDataSource adatok frissítéséhez. |
| UpdateParameters |
Lekéri a tulajdonság által megadott metódus által használt paramétereket tartalmazó paramétergyűjteményt UpdateMethod . |
| ValidateRequestMode |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő ellenőrzi-e a böngészőből érkező ügyfélbemenetet a potenciálisan veszélyes értékekért. (Öröklődés forrása Control) |
| ViewState |
Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy kiszolgálóvezérlő nézetállapotának mentését és visszaállítását ugyanazon lap több kérése között. (Öröklődés forrása Control) |
| ViewStateIgnoresCase |
Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e. (Öröklődés forrása Control) |
| ViewStateMode |
Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját. (Öröklődés forrása Control) |
| Visible |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő vizuálisan jelenik-e meg. (Öröklődés forrása DataSourceControl) |
Metódusok
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az ControlsControl objektum gyűjteményéhez. (Öröklődés forrása Control) |
| AddParsedSubObject(Object) |
Értesíti a kiszolgálóvezérlőt, hogy egy ELEM (XML vagy HTML) elemzése megtörtént, és hozzáadja az elemet a kiszolgálóvezérlő objektumához ControlCollection . (Öröklődés forrása Control) |
| ApplyStyleSheetSkin(Page) |
Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre. (Öröklődés forrása DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Megkezdi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| BuildProfileTree(String, Boolean) |
Adatokat gyűjt a kiszolgálóvezérlőről, és elküldi azt a Trace tulajdonságnak, amely akkor jelenik meg, ha a nyomkövetés engedélyezve van az oldalon. (Öröklődés forrása Control) |
| ClearCachedClientID() |
A gyorsítótárazott ClientID érték beállítása a következőre |
| ClearChildControlState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait. (Öröklődés forrása Control) |
| ClearChildState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit. (Öröklődés forrása Control) |
| ClearChildViewState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait. (Öröklődés forrása Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Az aktuális vezérlőpéldány és a gyermekvezérlők tulajdonságát a következőre Inheritállítja be: . (Öröklődés forrása Control) |
| CreateChildControls() |
A ASP.NET lap keretrendszere meghívta, hogy értesítse a kompozícióalapú implementációt használó kiszolgálóvezérlőket az általuk tartalmazott gyermekvezérlők létrehozására a visszaküldésre vagy a renderelésre való felkészüléshez. (Öröklődés forrása Control) |
| CreateControlCollection() |
Létrehoz egy gyűjteményt a gyermekvezérlők tárolásához. (Öröklődés forrása DataSourceControl) |
| DataBind() |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti. (Öröklődés forrása Control) |
| DataBind(Boolean) |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására. (Öröklődés forrása Control) |
| DataBindChildren() |
Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez. (Öröklődés forrása Control) |
| Delete() |
Törlési műveletet hajt végre úgy, hogy meghívja a tulajdonság által DeleteMethod azonosított metódust a DeleteParameters gyűjteményben található paraméterekkel. |
| Dispose() |
Lehetővé teszi a kiszolgálóvezérlők számára a végleges törlést, mielőtt felszabadítanák a memóriából. (Öröklődés forrása Control) |
| EndRenderTracing(TextWriter, Object) |
Befejezi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| EnsureChildControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre. (Öröklődés forrása Control) |
| EnsureID() |
Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító. (Öröklődés forrása Control) |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| FindControl(String, Int32) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| FindControl(String) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| Focus() |
A beviteli fókuszt a vezérlőre állítja. (Öröklődés forrása DataSourceControl) |
| GetDesignModeState() |
Lekéri a vezérlők tervezési idejének adatait. (Öröklődés forrása Control) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetRouteUrl(Object) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(RouteValueDictionary) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, Object) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| GetUniqueIDRelativeTo(Control) |
A megadott vezérlőelem tulajdonságának UniqueID előtaggal jelölt részét adja vissza. (Öröklődés forrása Control) |
| GetView(String) |
Lekéri az adatforrás-vezérlőhöz társított elnevezett adatforrásnézetet. |
| GetViewNames() |
Lekéri az objektumhoz társított nézetobjektumok listáját képviselő névgyűjteményt ObjectDataSource . |
| HasControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. (Öröklődés forrása DataSourceControl) |
| HasEvents() |
Egy értéket ad vissza, amely jelzi, hogy az események regisztrálva vannak-e a vezérlőelemhez vagy bármely gyermekvezérlőhöz. (Öröklődés forrása Control) |
| Insert() |
Beszúrási műveletet hajt végre a tulajdonság és a InsertMethod gyűjtemény bármely InsertParameters paramétere által azonosított metódus meghívásával. |
| IsLiteralContent() |
Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e. (Öröklődés forrása Control) |
| LoadControlState(Object) |
Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett. (Öröklődés forrása Control) |
| LoadViewState(Object) |
Betölti a vezérlő korábban mentett nézetállapotát ObjectDataSource . |
| MapPathSecure(String) |
Lekéri azt a fizikai útvonalat, amelybe egy virtuális elérési út abszolút vagy relatív értékként van leképezve. (Öröklődés forrása Control) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| OnBubbleEvent(Object, EventArgs) |
Meghatározza, hogy a kiszolgálóvezérlő eseménye átadva van-e a lap felhasználói felület kiszolgálóvezérlő hierarchiájának. (Öröklődés forrása Control) |
| OnDataBinding(EventArgs) |
Az eseményt emeli DataBinding ki. (Öröklődés forrása Control) |
| OnInit(EventArgs) |
Egy eseménykezelőt LoadComplete ad hozzá a ObjectDataSource vezérlőt tartalmazó laphoz. |
| OnLoad(EventArgs) |
Az eseményt emeli Load ki. (Öröklődés forrása Control) |
| OnPreRender(EventArgs) |
Az eseményt emeli PreRender ki. (Öröklődés forrása Control) |
| OnUnload(EventArgs) |
Az eseményt emeli Unload ki. (Öröklődés forrása Control) |
| OpenFile(String) |
Lekéri a Stream fájl olvasásához használt fájlokat. (Öröklődés forrása Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének. (Öröklődés forrása Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Az eseményt emeli DataSourceChanged ki. (Öröklődés forrása DataSourceControl) |
| RemovedControl(Control) |
A rendszer meghívja a gyermekvezérlőt az Controls objektum gyűjteményéből való Control eltávolítása után. (Öröklődés forrása Control) |
| Render(HtmlTextWriter) |
Kiszolgálóvezérlési tartalmat küld egy megadott HtmlTextWriter objektumnak, amely megírja a megjelenítendő tartalmat az ügyfélen. (Öröklődés forrása Control) |
| RenderChildren(HtmlTextWriter) |
Egy kiszolgálóvezérlő gyermekeinek tartalmát egy megadott HtmlTextWriter objektumba adja ki, amely megírja a megjelenítendő tartalmat az ügyfélen. (Öröklődés forrása Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli. (Öröklődés forrása Control) |
| RenderControl(HtmlTextWriter) |
A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja. (Öröklődés forrása DataSourceControl) |
| ResolveAdapter() |
Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert. (Öröklődés forrása Control) |
| ResolveClientUrl(String) |
Lekéri a böngésző által használható URL-címet. (Öröklődés forrása Control) |
| ResolveUrl(String) |
Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá. (Öröklődés forrása Control) |
| SaveControlState() |
Menti azokat a kiszolgálóvezérlő-állapotváltozásokat, amelyek a lap kiszolgálóra való visszatérése óta történtek. (Öröklődés forrása Control) |
| SaveViewState() |
Menti a vezérlő állapotát ObjectDataSource . |
| Select() |
Adatokat kér le a mögöttes adattárból a tulajdonság által SelectMethod azonosított metódus meghívásával a SelectParameters gyűjtemény paramétereivel. |
| SetDesignModeState(IDictionary) |
Beállítja a vezérlőelemek tervezési idejének adatait. (Öröklődés forrása Control) |
| SetRenderMethodDelegate(RenderMethod) |
Hozzárendel egy eseménykezelő delegáltat, hogy a kiszolgálóvezérlőt és annak tartalmát a szülővezérlőbe renderelje. (Öröklődés forrása Control) |
| SetTraceData(Object, Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomkövetéséhez a nyomkövetési objektum, a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| SetTraceData(Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomon követéséhez a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| TrackViewState() |
Nyomon követi a ObjectDataSource vezérlő nézetállapot-változásait, hogy azok tárolhatók legyenek az StateBag objektumban. |
| Update() |
Frissítési műveletet hajt végre a tulajdonság által azonosított metódus és a UpdateMethodUpdateParameters gyűjteményben található paraméterek meghívásával. |
esemény
| Name | Description |
|---|---|
| DataBinding |
Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik. (Öröklődés forrása Control) |
| Deleted |
A művelet befejezésekor Delete() következik be. |
| Deleting |
Művelet előtt Delete() következik be. |
| Disposed |
Akkor fordul elő, ha egy kiszolgálóvezérlő felszabadul a memóriából, amely a kiszolgálóvezérlő életciklusának utolsó szakasza, amikor egy ASP.NET lapot kérnek. (Öröklődés forrása Control) |
| Filtering |
Szűrőművelet előtt következik be. |
| Init |
A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése. (Öröklődés forrása Control) |
| Inserted |
Akkor fordul elő, ha egy Insert() művelet befejeződött. |
| Inserting |
Művelet előtt Insert() következik be. |
| Load |
Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba. (Öröklődés forrása Control) |
| ObjectCreated |
A tulajdonság által TypeName azonosított objektum létrehozása után következik be. |
| ObjectCreating |
A tulajdonság által TypeName azonosított objektum létrehozása előtt következik be. |
| ObjectDisposing |
A tulajdonság által TypeName azonosított objektum elvetése előtt történik. |
| PreRender |
Az objektum betöltése után Control , de a renderelés előtt következik be. (Öröklődés forrása Control) |
| Selected |
A művelet befejezésekor Select() következik be. |
| Selecting |
Művelet előtt Select() következik be. |
| Unload |
Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából. (Öröklődés forrása Control) |
| Updated |
Akkor fordul elő, ha egy Update() művelet befejeződött. |
| Updating |
Művelet előtt Update() következik be. |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Ennek a tagnak a leírását lásd ControlBuilder: . (Öröklődés forrása Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Ennek a tagnak a leírását lásd GetDesignModeState(): . (Öröklődés forrása Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Ennek a tagnak a leírását lásd SetDesignModeState(IDictionary): . (Öröklődés forrása Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Ennek a tagnak a leírását lásd SetOwnerControl(Control): . (Öröklődés forrása Control) |
| IControlDesignerAccessor.UserData |
Ennek a tagnak a leírását lásd UserData: . (Öröklődés forrása Control) |
| IDataBindingsAccessor.DataBindings |
Ennek a tagnak a leírását lásd DataBindings: . (Öröklődés forrása Control) |
| IDataBindingsAccessor.HasDataBindings |
Ennek a tagnak a leírását lásd HasDataBindings: . (Öröklődés forrása Control) |
| IDataSource.DataSourceChanged |
Akkor fordul elő, ha egy adatforrás-vezérlő olyan módon módosult, amely hatással van az adathoz kötött vezérlőkre. (Öröklődés forrása DataSourceControl) |
| IDataSource.GetView(String) |
Lekéri a vezérlőelemhez DataSourceView társított elnevezett DataSourceControl objektumot. Egyes adatforrás-vezérlők csak egy nézetet támogatnak, míg mások több nézetet is támogatnak. (Öröklődés forrása DataSourceControl) |
| IDataSource.GetViewNames() |
Lekéri a vezérlőhöz társított objektumok listáját DataSourceView képviselő névgyűjteményt DataSourceControl . (Öröklődés forrása DataSourceControl) |
| IExpressionsAccessor.Expressions |
Ennek a tagnak a leírását lásd Expressions: . (Öröklődés forrása Control) |
| IExpressionsAccessor.HasExpressions |
Ennek a tagnak a leírását lásd HasExpressions: . (Öröklődés forrása Control) |
| IListSource.ContainsListCollection |
Azt jelzi, hogy az adatforrás-vezérlő egy vagy több adatlistához van-e társítva. (Öröklődés forrása DataSourceControl) |
| IListSource.GetList() |
Lekéri az adatforrás-vezérlők listáját, amelyek adatlisták forrásaként használhatók. (Öröklődés forrása DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Ennek a tagnak a leírását lásd AddParsedSubObject(Object): . (Öröklődés forrása Control) |
Bővítő metódusok
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
A megadott vezérlőhöz tartozó adatforrást adja vissza. |
| FindFieldTemplate(Control, String) |
Visszaadja a megadott oszlop mezősablonját a megadott vezérlő elnevezési tárolójában. |
| FindMetaTable(Control) |
Az adatvezérlő metatáblás objektumát adja vissza. |
| GetDefaultValues(IDataSource) |
Lekéri a megadott adatforrás alapértelmezett értékeinek gyűjteményét. |
| GetMetaTable(IDataSource) |
Lekéri egy tábla metaadatait a megadott adatforrás-objektumban. |
| TryGetMetaTable(IDataSource, MetaTable) |
Meghatározza, hogy a tábla metaadatai elérhetők-e. |
