ObjectDataSource Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje obiekt biznesowy, który dostarcza dane do kontrolek powiązanych z danymi w wielowarstwowych architekturach aplikacji internetowych.
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- Dziedziczenie
- Atrybuty
Przykłady
Ta sekcja zawiera ObjectDataSource znaczniki na stronie aspx i pokazuje obiekty biznesowe, z którymi współpracuje. Przykładem jest strona aspx. Zawiera kontrolkę GridView , która jest powiązana z kontrolką ObjectDataSource . Znacznik ObjectDataSource kontroli określa nazwę obiektu biznesowego i nazwę metody obiektu biznesowego do wywołania w celu pobrania danych.
<%@ 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>
W poniższym przykładzie pokazano obiekt biznesowy używany przez kontrolkę ObjectDataSource na stronie aspx. (Wiele innych ObjectDataSource przykładów kodu używa również tego obiektu biznesowego). Przykład składa się z następujących dwóch podstawowych klas:
Klasa
EmployeeLogicjest klasą logiki biznesowej, która ObjectDataSource jest używana.Klasa
NorthwindEmployeedefiniuje obiekt danych zwracany przez metodęGetAllEmployeesEmployeeLogicklasy .
Dodatkowa NorthwindDataException klasa jest udostępniana jako wygoda.
Ten zestaw przykładowych klas współdziała z bazą danych Northwind Traders, która jest dostępna w usługach Microsoft SQL Server i Microsoft Access. Aby uzyskać kompletny przykład pracy, należy skompilować i użyć tych klas z podanym przykładem strony aspx.
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
Uwagi
W tym temacie:
Wprowadzenie
Kontrolka ObjectDataSource działa z klasą, którą tworzysz. Tworzysz metody, które pobierają i aktualizują dane, i podajesz nazwy tych metod do kontrolki ObjectDataSource w adiustacji. Podczas renderowania lub przetwarzania ObjectDataSource zwrotnego metody są wywoływane określone przez Ciebie metody.
Nie ma wizualizacji renderowania kontrolki ObjectDataSource . W związku z tym element ObjectDataSource nie obsługuje funkcji wizualnych, takich jak EnableTheming właściwość lub SkinID .
Przeznaczenie
Bardzo typową praktyką projektowania aplikacji jest oddzielenie warstwy prezentacji od logiki biznesowej i hermetyzowanie logiki biznesowej w obiektach biznesowych. Te obiekty biznesowe tworzą odrębną warstwę między warstwą prezentacji a warstwą danych, co skutkuje architekturą aplikacji trójwarstwowej. Kontrolka ObjectDataSource umożliwia deweloperom korzystanie z ASP.NET kontroli źródła danych przy zachowaniu architektury aplikacji trójwarstwowej.
Kontrolka ObjectDataSource używa odbicia do tworzenia wystąpień obiektów biznesowych i wywoływania metod w celu pobierania, aktualizowania, wstawiania i usuwania danych. Właściwość TypeName identyfikuje nazwę klasy, ObjectDataSource z którą działa. Kontrolka ObjectDataSource tworzy i niszczy wystąpienie klasy dla każdego wywołania metody; nie przechowuje obiektu w pamięci przez cały okres istnienia żądania sieci Web. Jest to poważna kwestia, jeśli używany obiekt biznesowy wymaga wielu zasobów lub jest w inny sposób kosztowny do utworzenia i zniszczenia. Użycie kosztownego obiektu może nie być optymalnym wyborem projektowym, ale można kontrolować cykl życia obiektu przy użyciu zdarzeń ObjectCreating, ObjectCreatedi ObjectDisposing .
Uwaga
Metody identyfikowane przez SelectMethodwłaściwości , , InsertMethodUpdateMethodi DeleteMethod mogą być metodami wystąpienia lub static (Sharedw języku Visual Basic). Jeśli metody to static (Shared w Visual Basic), wystąpienie obiektu biznesowego nie jest tworzone, a ObjectCreatingzdarzenia , ObjectCreatedi ObjectDisposing nie są wywoływane.
Pobieranie danych
Aby pobrać dane z obiektu biznesowego, ustaw SelectMethod właściwość na nazwę metody pobierającej dane. Jeśli metoda nie zwraca IEnumerable obiektu lub DataSet , obiekt jest opakowany przez środowisko uruchomieniowe w IEnumerable kolekcji. Jeśli podpis metody ma parametry, możesz dodać Parameter obiekty do SelectParameters kolekcji, a następnie powiązać je z wartościami, które chcesz przekazać do metody określonej przez SelectMethod właściwość. Aby kontrolka ObjectDataSource używała parametrów, parametry muszą być zgodne z nazwami i typami parametrów w podpisie metody. Aby uzyskać więcej informacji, zobacz Using Parameters with the ObjectDataSource Control (Używanie parametrów z kontrolką ObjectDataSource).
Kontrolka ObjectDataSource pobiera dane za każdym razem, gdy jest wywoływana Select metoda. Ta metoda zapewnia programowy dostęp do metody określonej przez SelectMethod właściwość. Metoda określona przez SelectMethod właściwość jest wywoływana automatycznie przez kontrolki powiązane z ObjectDataSourceDataBind wywołaną metodą . Jeśli ustawisz DataSourceID właściwość kontrolki powiązanej z danymi, kontrolka automatycznie wiąże się z danymi ze źródła danych zgodnie z potrzebami. DataSourceID Ustawienie właściwości jest zalecaną metodą powiązania kontrolki ObjectDataSource z formantem powiązanym z danymi. Alternatywnie można ustawić DataSource właściwość, ale następnie należy jawnie wywołać DataBind metodę kontrolki powiązanej z danymi. Metodę Select można wywołać programowo w dowolnym momencie, aby pobrać dane.
Aby uzyskać więcej informacji na temat wiązania kontrolek powiązanych z danymi do kontrolek źródła danych, zobacz Powiązanie z danymi przy użyciu kontroli źródła danych.
Wykonywanie operacji na danych
W zależności od możliwości obiektu biznesowego, ObjectDataSource z którym współpracuje kontrolka, można wykonywać operacje danych, takie jak aktualizacje, wstawiania i usuwania. Aby wykonać te operacje danych, ustaw odpowiednią nazwę metody i wszystkie skojarzone parametry dla operacji, którą chcesz wykonać. Na przykład w przypadku operacji aktualizacji ustaw UpdateMethod właściwość na nazwę metody obiektu biznesowego, która wykonuje aktualizacje, i dodaj wszystkie wymagane parametry do UpdateParameters kolekcji. Jeśli kontrolka ObjectDataSource jest skojarzona z kontrolką związaną z danymi, parametry są dodawane przez kontrolkę związaną z danymi. W takim przypadku należy upewnić się, że nazwy parametrów metody są zgodne z nazwami pól w kontrolce powiązanej z danymi. Aktualizacja jest wykonywana po wywołaniu Update metody jawnie przez kod lub automatycznie za pomocą kontrolki powiązanej z danymi. Ten sam ogólny wzorzec jest obserwowany dla Delete operacji i .Insert Zakłada się, że obiekty biznesowe wykonują te typy operacji danych jeden rekord naraz, a nie wsadowe.
Filtrowanie danych
Kontrolka ObjectDataSource może filtrować dane pobierane przez SelectMethod właściwość, jeśli dane są zwracane jako DataSet obiekt lub DataTable . Właściwość można ustawić FilterExpression na wyrażenie filtrowania przy użyciu składni ciągu formatu i powiązać wartości w wyrażeniu z parametrami określonymi w kolekcji FilterParameters .
Buforowanie
ObjectDataSource Chociaż obiekt biznesowy nie zachowuje wystąpienia obiektu biznesowego w wielu żądaniach, może buforować wynik wywołania metody zidentyfikowanej przez SelectMethod właściwość. Podczas gdy dane są buforowane, kolejne wywołania Select metody zwracają buforowane dane zamiast tworzyć obiekt biznesowy i wywoływać je SelectMethod przy użyciu odbicia. Buforowanie pozwala uniknąć tworzenia obiektu i wywoływania jego metody danych kosztem pamięci na serwerze sieci Web. Właściwość ObjectDataSource automatycznie buforuje dane, gdy EnableCaching właściwość jest ustawiona na truewartość , a CacheDuration właściwość jest ustawiona na liczbę sekund, w których pamięć podręczna przechowuje dane przed odrzuceniem pamięci podręcznej. Można również określić CacheExpirationPolicy właściwość i właściwość opcjonalną SqlCacheDependency . Kontrolka ObjectDataSource umożliwia buforowanie wszystkich typów danych, ale nie należy buforować obiektów, które zachowują zasoby lub stan, których nie można udostępnić do obsługi wielu żądań (na przykład otwartego SqlDataReader obiektu), ponieważ to samo wystąpienie obiektu będzie używane do obsługi wielu żądań.
Funkcje
W poniższej tabeli opisano funkcje kontrolki ObjectDataSource .
| Możliwość | Wymagania |
|---|---|
| Wybieranie | SelectMethod Ustaw właściwość na nazwę metody obiektu biznesowego, która wybiera dane, i uwzględnij wszelkie niezbędne parametry w SelectParameters kolekcji programowo lub przy użyciu kontrolki powiązanej z danymi. |
| Sortowanie | SortParameterName Ustaw właściwość na nazwę parametru w SelectMethod metodzie, która zawiera kryteria sortowania. |
| Filtrowanie | FilterExpression Ustaw właściwość na wyrażenie filtrowania i opcjonalnie dodaj wszystkie parametry do FilterParameters kolekcji, aby filtrować dane po Select wywołaniu metody. Metoda określona SelectMethod przez właściwość musi zwrócić wartość DataSet lub DataTable. |
| Stronicowanie | Stronicowanie źródła danych jest obsługiwane, jeśli SelectMethod metoda zawiera parametry maksymalnej liczby rekordów do pobrania i indeks pierwszego rekordu do pobrania. Nazwy tych parametrów muszą być ustawione odpowiednio we właściwościach MaximumRowsParameterName i StartRowIndexParameterName . Kontrolka powiązana z danymi może być w stanie wykonać stronicowanie, nawet jeśli ObjectDataSource kontrolka nie obsługuje stronicowania bezpośrednio w metodzie określonej przez SelectMethod właściwość. Wymaganie, aby kontrolka powiązana z danymi mogła to zrobić, jest to, że metoda określona przez SelectMethod właściwość zwraca obiekt implementujący ICollection interfejs. |
| Aktualizowanie | UpdateMethod Ustaw właściwość na nazwę metody obiektu biznesowego, która aktualizuje dane, i dołącz wszelkie niezbędne parametry w kolekcjiUpdateParameters. |
| Usuwanie | DeleteMethod Ustaw właściwość na nazwę metody lub funkcji obiektu biznesowego, która usuwa dane, i uwzględnij wszystkie niezbędne parametry w kolekcjiDeleteParameters. |
| Wstawianie | InsertMethod Ustaw właściwość na nazwę metody lub funkcji obiektu biznesowego, która wstawia dane, i uwzględnij wszystkie niezbędne parametry w kolekcjiInsertParameters. |
| Buforowanie | EnableCaching Ustaw właściwość na true, i CacheDurationCacheExpirationPolicy właściwości zgodnie z zachowaniem buforowania, które ma być przechowywane w pamięci podręcznej. |
Uwaga
Gdy używasz ObjectDataSource klasy do aktualizowania lub wstawiania danych, ciągi wprowadzone na kliencie nie są automatycznie konwertowane z formatu kultury klienta na format kultury serwera. Na przykład kultura klienta może określać DD/MM/RRRR jako format daty, a format daty na serwerze może być MM/DD/RRRR. W takim przypadku 5 października 2009 r. zostanie wprowadzony do TextBox kontroli jako 5/10/2009, ale zostanie zinterpretowany jako 10 maja 2009 r. 15 października 2009 r. zostanie wprowadzony jako 15/10/2009 i zostanie odrzucony jako nieprawidłowa data.
Widok danych
Podobnie jak w przypadku wszystkich kontrolek źródła danych, kontrolka ObjectDataSource jest skojarzona z klasą widoku źródła danych. Chociaż kontrolka ObjectDataSource jest interfejsem używanym przez dewelopera strony do pracy z danymi, ObjectDataSourceView klasa jest interfejsem, z którego działają kontrolki powiązane z danymi. Ponadto klasa ObjectDataSourceView opisuje możliwości kontroli źródła danych i wykonuje rzeczywistą pracę. Kontrolka ObjectDataSource ma tylko jeden skojarzony element ObjectDataSourceViewi zawsze nosi nazwę DefaultView. ObjectDataSourceView Chociaż obiekt jest uwidoczniony przez metodęGetView, wiele jego właściwości i metod jest opakowanych i uwidocznionych bezpośrednio przez kontrolkęObjectDataSource. Za kulisami ObjectDataSourceView obiekt wykonuje wszystkie operacje danych, w tym pobieranie, wstawianie, aktualizowanie, usuwanie, filtrowanie i sortowanie danych. Aby uzyskać więcej informacji, zobacz ObjectDataSourceView.
Korzystanie z LINQ to SQL
Możesz użyć kontrolki ObjectDataSource z klasą LINQ to SQL. W tym celu należy ustawić TypeName właściwość na nazwę klasy kontekstu danych. Należy również ustawić SelectMethodmetody , UpdateMethod, InsertMethodi DeleteMethod na metody w klasie kontekstu danych, które wykonują odpowiednie operacje. Aby anulować usuwanie klasy kontekstu danych, należy utworzyć program obsługi zdarzeń dla ObjectDisposing zdarzenia. Ten krok jest niezbędny, ponieważ LINQ to SQL obsługuje odroczone wykonywanie, podczas gdy kontrolka ObjectDataSource próbuje usunąć kontekst danych po operacji Select. Aby uzyskać więcej informacji na temat tworzenia klas LINQ to SQL, zobacz How to: Create LINQ to SQL Classes in a Web Project (Jak tworzyć klasy LINQ to SQL w projekcie internetowym). Aby zapoznać się z przykładem anulowania rozkładu klasy kontekstu danych, zobacz ObjectDisposing zdarzenie.
Korzystanie z programu Entity Framework
Możesz również użyć kontrolki ObjectDataSource z programem Entity Framework. Aby uzyskać więcej informacji, zobacz Using the Entity Framework and the ObjectDataSource Control (Używanie platformy Entity Framework i kontrolki ObjectDataSource).
Składnia deklaracyjna
<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>
Konstruktory
| ObjectDataSource() |
Inicjuje nowe wystąpienie klasy ObjectDataSource. |
| ObjectDataSource(String, String) |
Inicjuje ObjectDataSource nowe wystąpienie klasy o określonej nazwie typu i nazwie metody pobierania danych. |
Właściwości
| Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
| AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control) |
| CacheDuration |
Pobiera lub ustawia czas (w sekundach), przez który kontrolka źródła danych buforuje dane pobierane przez SelectMethod właściwość . |
| CacheExpirationPolicy |
Pobiera lub ustawia zachowanie wygasania pamięci podręcznej, które w połączeniu z czasem trwania opisuje zachowanie pamięci podręcznej używanej przez kontrolę źródła danych. |
| CacheKeyDependency |
Pobiera lub ustawia zależność klucza zdefiniowanego przez użytkownika, która jest połączona ze wszystkimi obiektami pamięci podręcznej danych utworzonymi przez kontrolę źródła danych. |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control) |
| ClientID |
Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET. (Odziedziczone po DataSourceControl) |
| ClientIDMode |
Ta właściwość nie jest używana dla kontrolek źródła danych. (Odziedziczone po DataSourceControl) |
| ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
| ConflictDetection |
Pobiera lub ustawia wartość, która określa, czy nowe wartości są przekazywane do |
| Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
| Controls |
ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po DataSourceControl) |
| ConvertNullToDBNull |
Pobiera lub ustawia wartość wskazującą, czy Parameter wartości przekazywane do operacji aktualizacji, wstawiania lub usuwania są automatycznie konwertowane z |
| DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
| DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
| DataObjectTypeName |
Pobiera lub ustawia nazwę klasy używanej ObjectDataSource przez kontrolkę dla parametru w operacji aktualizacji, wstawiania lub usuwania danych, zamiast przekazywać poszczególne wartości z kontrolki powiązanej z danymi. |
| DeleteMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSource kontrolkę w celu usunięcia danych. |
| DeleteParameters |
Pobiera kolekcję parametrów zawierającą parametry używane przez metodę DeleteMethod . |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| EnableCaching |
Pobiera lub ustawia wartość wskazującą, czy kontrolka ObjectDataSource ma włączone buforowanie danych. |
| EnablePaging |
Pobiera lub ustawia wartość wskazującą, czy kontrolka źródła danych obsługuje stronicowanie za pośrednictwem zestawu pobieranych danych. |
| EnableTheming |
Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy. (Odziedziczone po DataSourceControl) |
| EnableViewState |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control) |
| Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
| FilterExpression |
Pobiera lub ustawia wyrażenie filtrowania, które jest stosowane, gdy wywoływana jest metoda określona SelectMethod przez właściwość. |
| FilterParameters |
Pobiera kolekcję parametrów skojarzonych z dowolnymi symbolami zastępczymi parametrów w FilterExpression ciągu. |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
| IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
| InsertMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSource kontrolkę w celu wstawiania danych. |
| InsertParameters |
Pobiera kolekcję parametrów zawierającą InsertMethod parametry używane przez właściwość . |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control) |
| MaximumRowsParameterName |
Pobiera lub ustawia nazwę parametru metody pobierania danych obiektu biznesowego, który służy do wskazania liczby rekordów do pobrania na potrzeby obsługi stronicowania źródła danych. |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
| OldValuesParameterFormatString |
Pobiera lub ustawia ciąg formatu, który ma być stosowany do nazw parametrów dla oryginalnych wartości przekazywanych do |
| Page |
Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control) |
| ParsingCulture |
Pobiera lub ustawia wartość, która wskazuje, jakie informacje o kulturze są używane podczas konwertowania wartości ciągów na rzeczywiste typy właściwości w celu skonstruowania obiektu typu wskazanego przez DataObjectTypeName. |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| SelectCountMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSource kontrolkę w celu pobrania liczby wierszy. |
| SelectMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSource kontrolkę w celu pobrania danych. |
| SelectParameters |
Pobiera kolekcję parametrów używanych przez metodę określoną przez SelectMethod właściwość . |
| Site |
Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
| SkinID |
Pobiera skórę do zastosowania do kontrolki DataSourceControl . (Odziedziczone po DataSourceControl) |
| SortParameterName |
Pobiera lub ustawia nazwę obiektu biznesowego, który SelectMethod parametr używany do określania wyrażenia sortowania dla obsługi sortowania źródła danych. |
| SqlCacheDependency |
Pobiera lub ustawia rozdzielany średnikami ciąg wskazujący, które bazy danych i tabele mają być używane dla zależności pamięci podręcznej usługi Microsoft SQL Server. |
| StartRowIndexParameterName |
Pobiera lub ustawia nazwę parametru metody pobierania danych, który służy do wskazania wartości identyfikatora pierwszego rekordu do pobrania na potrzeby obsługi stronicowania źródła danych. |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| TypeName |
Pobiera lub ustawia nazwę klasy reprezentowanej przez ObjectDataSource obiekt. |
| UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
| UpdateMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSource kontrolkę w celu zaktualizowania danych. |
| UpdateParameters |
Pobiera kolekcję parametrów zawierającą parametry używane przez metodę określoną przez UpdateMethod właściwość . |
| ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
| ViewState |
Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie. (Odziedziczone po DataSourceControl) |
Metody
| AddedControl(Control, Int32) |
Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
| BuildProfileTree(String, Boolean) |
Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control) |
| ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
| ClearChildControlState() |
Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit. (Odziedziczone po Control) |
| CreateChildControls() |
Wywoływana przez platformę stron ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control) |
| CreateControlCollection() |
Tworzy kolekcję do przechowywania kontrolek podrzędnych. (Odziedziczone po DataSourceControl) |
| DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi. (Odziedziczone po Control) |
| DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding . (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Delete() |
Wykonuje operację usuwania, wywołując metodę, która jest identyfikowana przez DeleteMethod właściwość z dowolnymi parametrami w DeleteParameters kolekcji. |
| Dispose() |
Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
| EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
| EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| FindControl(String) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego |
| FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
| Focus() |
Ustawia fokus danych wejściowych na kontrolkę. (Odziedziczone po DataSourceControl) |
| GetDesignModeState() |
Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
| GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
| GetView(String) |
Pobiera nazwany widok źródła danych skojarzony z kontrolą źródła danych. |
| GetViewNames() |
Pobiera kolekcję nazw reprezentujących listę obiektów widoku, które są skojarzone z obiektem ObjectDataSource . |
| HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po DataSourceControl) |
| HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
| Insert() |
Wykonuje operację wstawiania, wywołując metodę, która jest identyfikowana przez InsertMethod właściwość i wszystkie parametry w InsertParameters kolekcji. |
| IsLiteralContent() |
Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control) |
| LoadControlState(Object) |
Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control) |
| LoadViewState(Object) |
Ładuje wcześniej zapisany stan widoku kontrolki ObjectDataSource . |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control) |
| OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnInit(EventArgs) |
Dodaje procedurę LoadComplete obsługi zdarzeń do strony zawierającej kontrolkę ObjectDataSource . |
| OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Stream Pobiera element używany do odczytywania pliku. (Odziedziczone po Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
DataSourceChanged Zgłasza zdarzenie. (Odziedziczone po DataSourceControl) |
| RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Wysyła zawartość kontroli serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderChildren(HtmlTextWriter) |
Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control) |
| ResolveAdapter() |
Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
| ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
| ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
| SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
| SaveViewState() |
Zapisuje stan kontrolki ObjectDataSource . |
| Select() |
Pobiera dane z magazynu danych bazowych przez wywołanie metody identyfikowanej przez SelectMethod właściwość z parametrami w SelectParameters kolekcji. |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control) |
| SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| SetTraceData(Object, Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| TrackViewState() |
Śledzi zmiany stanu widoku w kontrolce ObjectDataSource , aby można je było przechowywać w StateBag obiekcie. |
| Update() |
Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod właściwość i wszystkie parametry, które znajdują się w UpdateParameters kolekcji. |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| Deleted |
Występuje po zakończeniu Delete() operacji. |
| Deleting |
Występuje przed operacją Delete() . |
| Disposed |
Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET. (Odziedziczone po Control) |
| Filtering |
Występuje przed operacją filtrowania. |
| Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
| Inserted |
Występuje po zakończeniu Insert() operacji. |
| Inserting |
Występuje przed operacją Insert() . |
| Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
| ObjectCreated |
Występuje po utworzeniu obiektu, który jest identyfikowany przez TypeName właściwość. |
| ObjectCreating |
Występuje przed utworzeniem TypeName obiektu, który jest identyfikowany przez właściwość. |
| ObjectDisposing |
Występuje przed odrzuceniem obiektu, który jest identyfikowany przez TypeName właściwość. |
| PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
| Selected |
Występuje po zakończeniu Select() operacji. |
| Selecting |
Występuje przed operacją Select() . |
| Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
| Updated |
Występuje po zakończeniu Update() operacji. |
| Updating |
Występuje przed operacją Update() . |
Jawne implementacje interfejsu
| IControlBuilderAccessor.ControlBuilder |
Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder. (Odziedziczone po Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState(). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego członka, zobacz HasDataBindings. (Odziedziczone po Control) |
| IDataSource.DataSourceChanged |
Występuje, gdy kontrola źródła danych zmieniła się w sposób, który wpływa na kontrolki powiązane z danymi. (Odziedziczone po DataSourceControl) |
| IDataSource.GetView(String) |
Pobiera nazwany DataSourceView obiekt skojarzony z kontrolką DataSourceControl . Niektóre kontrolki źródła danych obsługują tylko jeden widok, a inne obsługują więcej niż jeden widok. (Odziedziczone po DataSourceControl) |
| IDataSource.GetViewNames() |
Pobiera kolekcję nazw, reprezentującą listę obiektów skojarzonych DataSourceView z kontrolką DataSourceControl . (Odziedziczone po DataSourceControl) |
| IExpressionsAccessor.Expressions |
Aby uzyskać opis tego członka, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego członka, zobacz HasExpressions. (Odziedziczone po Control) |
| IListSource.ContainsListCollection |
Wskazuje, czy kontrola źródła danych jest skojarzona z co najmniej jedną listą danych. (Odziedziczone po DataSourceControl) |
| IListSource.GetList() |
Pobiera listę kontrolek źródła danych, które mogą być używane jako źródła list danych. (Odziedziczone po DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Aby uzyskać opis tego członka, zobacz AddParsedSubObject(Object). (Odziedziczone po Control) |
Metody rozszerzania
| FindDataSourceControl(Control) |
Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki. |
| FindFieldTemplate(Control, String) |
Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki. |
| FindMetaTable(Control) |
Zwraca obiekt metatable dla kontrolki zawierającej dane. |
| GetDefaultValues(IDataSource) |
Pobiera kolekcję wartości domyślnych dla określonego źródła danych. |
| GetMetaTable(IDataSource) |
Pobiera metadane dla tabeli w określonym obiekcie źródła danych. |
| TryGetMetaTable(IDataSource, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
Dotyczy
Zobacz też
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Przewodnik: powiązanie danych z niestandardowym obiektem biznesowym
- Kontrolki serwera internetowego źródła danych
- ObjectDataSource, kontrolka — omówienie
- Tworzenie obiektu źródłowego kontrolki ObjectDataSource
- Korzystanie z platformy Entity Framework i kontrolki ObjectDataSource
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla