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
W tej sekcji przedstawiono znaczniki ObjectDataSource na stronie .aspx i są wyświetlane obiekty biznesowe, z którymi współpracuje. Przykładem jest strona .aspx. Zawiera kontrolkę GridView powiązaną 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 przedstawiono 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 przezGetAllEmployeesmetodęEmployeeLogicklasy.
Dodatkowa NorthwindDataException klasa jest dostarczana jako wygoda.
Ten zestaw przykładowych klas współdziała z bazą danych Northwind Traders, która jest dostępna w programach Microsoft SQL Server i Microsoft Access. Aby uzyskać pełny 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.
Używanie 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ć procedurę obsługi zdarzeń ObjectDisposing dla 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 Wybierz. Aby uzyskać więcej informacji na temat tworzenia klas LINQ to SQL, zobacz How to: Create LINQ to SQL Classes in a Web Project (Instrukcje: tworzenie klas LINQ to SQL w projekcie internetowym). Aby zapoznać się z przykładem anulowania rozpowszechniania 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 struktury 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 tego formantu. (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 z wszystkimi obiektami pamięci podręcznej danych utworzonymi przez kontrolę źródła danych. |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control) |
| ClientID |
Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET. (Odziedziczone po DataSourceControl) |
| ClientIDMode |
Ta właściwość nie jest używana w przypadku 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 przekazywania poszczególnych wartości z kontrolki powiązanej z danymi. |
| DeleteMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez 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łączoną 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 wysyłającego żądanie. (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 kontrolki podrzędne bieżącego formantu serwera mają 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 ObjectDataSource przez kontrolkę w celu wstawiania danych. |
| InsertParameters |
Pobiera kolekcję parametrów zawierającą parametry używane przez InsertMethod 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 dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID 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 w celu obsługi stronicowania źródła danych. |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania 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, które zawiera kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control) |
| ParsingCulture |
Pobiera lub ustawia wartość wskazującą, 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 ObjectDataSource przez kontrolkę w celu pobrania liczby wierszy. |
| SelectMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu pobrania danych. |
| SelectParameters |
Pobiera kolekcję parametrów, które są używane przez metodę SelectMethod określoną przez właściwość. |
| Site |
Pobiera informacje o kontenerze, który hostuje 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 programu Microsoft SQL Server. |
| StartRowIndexParameterName |
Pobiera lub ustawia nazwę parametru metody pobierania danych, który jest używany 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 elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| TypeName |
Pobiera lub ustawia nazwę klasy, którą ObjectDataSource reprezentuje obiekt. |
| UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
| UpdateMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu zaktualizowania danych. |
| UpdateParameters |
Pobiera kolekcję parametrów zawierającą parametry, które są używane przez metodę UpdateMethod określoną przez 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 umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb stanu widoku 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ływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia formant 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 danych renderowania w czasie projektowania. (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 sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie sterowania 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 Inheritwartość . (Odziedziczone po Control) |
| CreateChildControls() |
Wywoływana przez platformę strony 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 jej 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ą wywołania DataBinding zdarzenia. (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 kolekcji DeleteParameters . |
| Dispose() |
Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie danych renderowania w czasie projektowania. (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 wejściowy na kontrolkę. (Odziedziczone po DataSourceControl) |
| GetDesignModeState() |
Pobiera dane czasu 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 wartość bieżącego wystąpienia. (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 skojarzonych 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ą zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control) |
| Insert() |
Wykonuje operację wstawiania, wywołując metodę, która jest identyfikowana przez InsertMethod właściwość i wszystkie parametry w kolekcji InsertParameters . |
| IsLiteralContent() |
Określa, czy kontrolka serwera przechowuje 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ą mapuje się ś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) |
LoadComplete Dodaje program 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) |
Pobiera element Stream 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 z Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderChildren(HtmlTextWriter) |
Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter) |
Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control) |
| ResolveAdapter() |
Pobiera kartę sterową 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 bazowego magazynu danych, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość z parametrami w kolekcji SelectParameters . |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości 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 ObjectDataSourceStateBag , aby można je było przechowywać w 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 kolekcji UpdateParameters . |
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 kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony 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 TypeName obiektu, który jest identyfikowany przez właściwość. |
| ObjectCreating |
Występuje przed utworzeniem TypeName obiektu, który jest identyfikowany przez właściwość. |
| ObjectDisposing |
Występuje przed odrzuceniem obiektu identyfikowanego 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 członka, zobacz ControlBuilder. (Odziedziczone po Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Aby uzyskać opis tego członka, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego członka, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego członka, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego elementu członkowskiego, 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 elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control) |
| IListSource.ContainsListCollection |
Wskazuje, czy kontrolka ź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 elementu członkowskiego, 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 sieci Web źródła danych
- ObjectDataSource, kontrolka — omówienie
- Tworzenie obiektu źródłowego kontrolki ObjectDataSource
- Używanie struktury 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