ObjectDataSource Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar ett affärsobjekt som tillhandahåller data till databundna kontroller i arkitekturer för webbprogram i flera nivåer.
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- Arv
- Attribut
Exempel
Det här avsnittet visar en ObjectDataSource i-markering på en .aspx-sida och visar de affärsobjekt som den fungerar med. Exemplet är sidan .aspx. Den innehåller en GridView kontroll som är bunden till en ObjectDataSource kontroll. Kontrollmarkeringen ObjectDataSource anger namnet på affärsobjektet och namnet på den affärsobjektmetod som ska anropas för att hämta data.
<%@ 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>
I följande exempel visas det affärsobjekt som ObjectDataSource kontrollen på sidan .aspx använder. (Många andra ObjectDataSource kodexempel använder även det här affärsobjektet.) Exemplet består av följande två grundläggande klasser:
Klassen
EmployeeLogicär den affärslogikklass som ObjectDataSource används.Klassen
NorthwindEmployeedefinierar det dataobjekt som returneras avGetAllEmployeesklassensEmployeeLogicmetod.
NorthwindDataException Ytterligare en klass tillhandahålls som en bekvämlighet.
Den här uppsättningen exempelklasser fungerar med Databasen Northwind Traders, som är tillgänglig med Microsoft SQL Server och Microsoft Access. För ett fullständigt arbetsexempel måste du kompilera och använda dessa klasser med det .aspx sidexempel som tillhandahålls.
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
Kommentarer
I det här avsnittet:
Introduction
En ObjectDataSource kontroll fungerar med en klass som du skapar. Du skapar metoder som hämtar och uppdaterar data och anger namnen på dessa metoder till ObjectDataSource kontrollen i markering. Under återgivning eller efterbearbetning anropar de ObjectDataSource metoder som du har angett.
Det finns ingen visuell återgivning av ObjectDataSource kontrollen. Därför ObjectDataSource stöder inte visuella funktioner som EnableTheming egenskapen eller .SkinID
Purpose
En mycket vanlig metod för programdesign är att separera presentationsskiktet från affärslogik och kapsla in affärslogik i affärsobjekt. Dessa affärsobjekt utgör ett distinkt lager mellan presentationslagret och datanivån, vilket resulterar i en programarkitektur på tre nivåer. Med kontrollen ObjectDataSource kan utvecklare använda en ASP.NET datakällkontroll samtidigt som de behåller sin programarkitektur på tre nivåer.
Kontrollen ObjectDataSource använder reflektion för att skapa instanser av affärsobjekt och anropa metoder för dem för att hämta, uppdatera, infoga och ta bort data. Egenskapen TypeName identifierar namnet på den klass som ObjectDataSource fungerar med. Kontrollen ObjectDataSource skapar och förstör en instans av klassen för varje metodanrop. Den innehåller inte objektet i minnet under webbbegärans livslängd. Detta är ett allvarligt övervägande om affärsobjektet som du använder kräver många resurser eller annars är dyrt att skapa och förstöra. Att använda ett dyrt objekt kanske inte är ett optimalt designval, men du kan styra objektets livscykel med hjälp ObjectCreatingav händelserna , ObjectCreatedoch ObjectDisposing .
Note
De metoder som identifieras av egenskaperna SelectMethod, UpdateMethod, InsertMethod och DeleteMethod kan vara instansmetoder eller static (Shared i Visual Basic). Om metoderna är static (Shared i Visual Basic) skapas inte en instans av affärsobjektet och ObjectCreating, ObjectCreated och ObjectDisposing händelser utlöses inte.
Hämtar data
Om du vill hämta data från ett affärsobjekt anger du SelectMethod egenskapen till namnet på den metod som hämtar data. Om metoden inte returnerar ett IEnumerable objekt eller DataSet ett objekt omsluts objektet av körningen i en IEnumerable samling. Om metodsignaturen har parametrar kan du lägga till Parameter objekt i SelectParameters samlingen och sedan binda dem till de värden som du vill skicka till den metod som anges av SelectMethod egenskapen. För att kontrollen ska kunna ObjectDataSource använda parametrarna måste parametrarna matcha namnen och typerna av parametrarna i metodsignaturen. Mer information finns i Använda parametrar med ObjectDataSource-kontrollen.
Kontrollen ObjectDataSource hämtar data när Select metoden anropas. Den här metoden ger programmatisk åtkomst till den metod som anges av SelectMethod egenskapen. Den metod som anges av SelectMethod egenskapen anropas automatiskt av kontroller som är bundna till ObjectDataSource när deras DataBind metod anropas. Om du anger egenskapen för DataSourceID en databunden kontroll binder kontrollen automatiskt till data från datakällan efter behov. Att ange egenskapen DataSourceID är den rekommenderade metoden för att binda en ObjectDataSource kontroll till en databunden kontroll. Du kan också ange DataSource egenskapen, men sedan måste du uttryckligen DataBind anropa metoden för den databundna kontrollen. Du kan anropa Select metoden programmatiskt när som helst för att hämta data.
Mer information om hur du binder databundna kontroller till datakällans kontroller finns i Bindning till data med hjälp av en datakällakontroll.
Utföra dataåtgärder
Beroende på funktionerna i affärsobjektet som ObjectDataSource kontrollen fungerar med kan du utföra dataåtgärder, till exempel uppdateringar, infogningar och borttagningar. Om du vill utföra dessa dataåtgärder anger du lämpligt metodnamn och eventuella associerade parametrar för den åtgärd som du vill utföra. För en uppdateringsåtgärd anger du UpdateMethod till exempel egenskapen till namnet på den affärsobjektmetod som utför uppdateringar och lägger till nödvändiga parametrar i UpdateParameters samlingen. Om kontrollen ObjectDataSource är associerad med en databunden kontroll läggs parametrarna till av den databundna kontrollen. I det här fallet måste du se till att parameternamnen för metoden matchar fältnamnen i den databundna kontrollen. Uppdateringen utförs när Update metoden anropas, antingen explicit av din kod eller automatiskt av en databunden kontroll. Samma allmänna mönster följs för Delete och Insert åtgärder. Affärsobjekt antas utföra dessa typer av dataåtgärder en post i taget i stället för batchbaserade.
Filtrera data
Kontrollen ObjectDataSource kan filtrera data som hämtas av SelectMethod egenskapen om data returneras som ett DataSet eller DataTable -objekt. Du kan ange FilterExpression egenskapen till ett filtreringsuttryck med hjälp av en formatsträngssyntax och bindningsvärden i uttrycket till parametrar som anges i FilterParameters samlingen.
Caching
ObjectDataSource Även om inte behåller instansen av affärsobjektet över flera begäranden, kan den cachelagrar resultatet av att anropa metoden som identifieras av SelectMethod egenskapen. Medan data cachelagras returnerar efterföljande anrop till Select metoden cachelagrade data i stället för att skapa affärsobjektet och anropa dess SelectMethod med reflektion. Med cachelagring kan du undvika att skapa objektet och anropa dess datametod på bekostnad av minnet på webbservern. Cachelagrar ObjectDataSource automatiskt data när EnableCaching egenskapen är inställd på true, och CacheDuration egenskapen anges till det antal sekunder som cacheminnet lagrar data innan cacheminnet tas bort. Du kan också ange en CacheExpirationPolicy egenskap och en valfri SqlCacheDependency egenskap. Med ObjectDataSource kontrollen kan du cachelagrar alla typer av data, men du bör inte cachelagrar objekt som behåller resurser eller tillstånd som inte kan delas till flera begäranden (till exempel ett öppet SqlDataReader objekt), eftersom samma instans av objektet används för att hantera flera begäranden.
Features
I följande tabell beskrivs funktionerna i ObjectDataSource kontrollen.
| Capability | Kravspecifikation |
|---|---|
| Välja | SelectMethod Ange egenskapen till namnet på den affärsobjektmetod som väljer data och inkludera eventuella nödvändiga parametrar i SelectParameters samlingen antingen programmatiskt eller med hjälp av en databunden kontroll. |
| Sortering | SortParameterName Ange egenskapen till namnet på parametern i metoden SelectMethod som innehåller sorteringsvillkoren. |
| Filtrering | FilterExpression Ange egenskapen till ett filtreringsuttryck och lägg till eventuella parametrar i FilterParameters samlingen för att filtrera data när Select metoden anropas. Metoden som anges av egenskapen SelectMethod måste returnera en DataSet eller DataTable. |
| Paging | Datakällans växling stöds om SelectMethod metoden innehåller parametrar för det maximala antalet poster som ska hämtas och indexet för den första posten som ska hämtas. Namnen på dessa parametrar måste anges i MaximumRowsParameterName egenskaperna och StartRowIndexParameterName . En databunden kontroll kan utföra växlingen, även om ObjectDataSource kontrollen inte stöder växling direkt i den metod som anges av SelectMethod egenskapen. Kravet för att den databundna kontrollen ska kunna göra detta är att den metod som anges av SelectMethod egenskapen returnerar ett objekt som implementerar ICollection gränssnittet. |
| Uppdatera | UpdateMethod Ange egenskapen till namnet på den affärsobjektmetod som uppdaterar data och inkludera eventuella nödvändiga parametrar i UpdateParameters samlingen. |
| Tas bort | DeleteMethod Ange egenskapen till namnet på affärsobjektmetoden eller funktionen som tar bort data och inkludera eventuella nödvändiga parametrar i DeleteParameters samlingen. |
| Infoga | InsertMethod Ange egenskapen till namnet på den affärsobjektmetod eller -funktion som infogar data och inkludera eventuella nödvändiga parametrar i InsertParameters samlingen. |
| Caching |
EnableCaching Ange egenskapen till trueoch CacheDuration egenskaperna och CacheExpirationPolicy enligt det cachelagringsbeteende som du vill använda för dina cachelagrade data. |
Note
När du använder ObjectDataSource klassen för att uppdatera eller infoga data konverteras inte strängar som anges i klienten automatiskt från klientkulturformatet till serverkulturformatet. Klientkulturen kan till exempel ange DD/MM/ÅÅÅÅ som datumformat, och datumformatet på servern kan vara MM/DD/ÅÅÅÅ. I så fall skulle den 5 oktober 2009 föras in i en TextBox kontroll som 5/10/2009 men skulle tolkas som 10 maj 2009. Den 15 oktober 2009 skulle anges som den 15 oktober 2009 och avvisas som ett ogiltigt datum.
Datavy
Precis som med alla kontroller ObjectDataSource för datakällor är kontrollen associerad med en datakällas vyklass.
ObjectDataSource Kontrollen är det gränssnitt som sidutvecklaren använder för att arbeta med data, men ObjectDataSourceView klassen är det gränssnitt som databundna kontroller fungerar med. Dessutom ObjectDataSourceView beskriver klassen funktionerna i datakällans kontroll och utför det faktiska arbetet. Kontrollen ObjectDataSource har bara en associerad ObjectDataSourceView, och den heter DefaultViewalltid .
ObjectDataSourceView Objektet exponeras av GetView metoden, men många av dess egenskaper och metoder omsluts och exponeras direkt av ObjectDataSource kontrollen. I bakgrunden ObjectDataSourceView utför objektet alla dataåtgärder, inklusive hämtning, infogning, uppdatering, borttagning, filtrering och sortering av data. Mer information finns i ObjectDataSourceView.
Använda LINQ till SQL
Du kan använda ObjectDataSource kontrollen med en LINQ till SQL-klass. För att göra det anger TypeName du egenskapen till namnet på datakontextklassen. Du anger SelectMethodockså metoderna , UpdateMethod, InsertMethodoch DeleteMethod till metoderna i datakontextklassen som utför motsvarande åtgärder. Du måste skapa en händelsehanterare för händelsen för ObjectDisposing att avbryta disponering av datakontextklassen. Det här steget är nödvändigt eftersom LINQ till SQL stöder uppskjuten ObjectDataSource körning, medan kontrollen försöker ta bort datakontexten efter åtgärden Välj. Mer information om hur du skapar LINQ till SQL-klasser finns i How to: Create LINQ to SQL Classes in a Web Project. Ett exempel på hur du avbryter disponering av en datakontextklass finns i ObjectDisposing händelsen.
Använda Entity Framework
Du kan också använda ObjectDataSource kontrollen med Entity Framework. Mer information finns i Använda Entity Framework och ObjectDataSource-kontrollen.
Deklarativ syntax
<asp:ObjectDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
ConflictDetection="OverwriteChanges|CompareAllValues"
ConvertNullToDBNull="True|False"
DataObjectTypeName="string"
DeleteMethod="string"
EnableCaching="True|False"
EnablePaging="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FilterExpression="string"
ID="string"
InsertMethod="string"
MaximumRowsParameterName="string"
OldValuesParameterFormatString="string"
OnDataBinding="DataBinding event handler"
OnDeleted="Deleted event handler"
OnDeleting="Deleting event handler"
OnDisposed="Disposed event handler"
OnFiltering="Filtering event handler"
OnInit="Init event handler"
OnInserted="Inserted event handler"
OnInserting="Inserting event handler"
OnLoad="Load event handler"
OnObjectCreated="ObjectCreated event handler"
OnObjectCreating="ObjectCreating event handler"
OnObjectDisposing="ObjectDisposing event handler"
OnPreRender="PreRender event handler"
OnSelected="Selected event handler"
OnSelecting="Selecting event handler"
OnUnload="Unload event handler"
OnUpdated="Updated event handler"
OnUpdating="Updating event handler"
runat="server"
SelectCountMethod="string"
SelectMethod="string"
SkinID="string"
SortParameterName="string"
SqlCacheDependency="string"
StartRowIndexParameterName="string"
TypeName="string"
UpdateMethod="string"
Visible="True|False"
>
<DeleteParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</DeleteParameters>
<FilterParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</FilterParameters>
<InsertParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</InsertParameters>
<SelectParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</SelectParameters>
<UpdateParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</UpdateParameters>
</asp:ObjectDataSource>
Konstruktorer
| Name | Description |
|---|---|
| ObjectDataSource() |
Initierar en ny instans av ObjectDataSource klassen. |
| ObjectDataSource(String, String) |
Initierar en ny instans av ObjectDataSource klassen med det angivna typnamnet och namnet på datahämtningsmetoden. |
Egenskaper
| Name | Description |
|---|---|
| Adapter |
Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control) |
| AppRelativeTemplateSourceDirectory |
Hämtar eller anger den programrelativa virtuella katalogen PageUserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control) |
| BindingContainer |
Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control) |
| CacheDuration |
Hämtar eller anger hur lång tid, i sekunder, som datakällans kontroll cachelagrar data som hämtas av SelectMethod egenskapen. |
| CacheExpirationPolicy |
Hämtar eller anger förfallobeteendet för cachen som i kombination med varaktigheten beskriver beteendet för cachen som datakällans kontroll använder. |
| CacheKeyDependency |
Hämtar eller anger ett användardefinierat nyckelberoende som är länkat till alla datacacheobjekt som skapas av datakällkontrollen. |
| ChildControlsCreated |
Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control) |
| ClientID |
Hämtar serverkontrollidentifieraren som genereras av ASP.NET. (Ärvd från DataSourceControl) |
| ClientIDMode |
Den här egenskapen används inte för datakällans kontroller. (Ärvd från DataSourceControl) |
| ClientIDSeparator |
Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control) |
| ConflictDetection |
Hämtar eller anger ett värde som avgör om bara de nya värdena skickas till |
| Context |
Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control) |
| Controls |
Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från DataSourceControl) |
| ConvertNullToDBNull |
Hämtar eller anger ett värde som anger om de Parameter värden som skickas till en uppdaterings-, infognings- eller borttagningsåtgärd automatiskt konverteras från |
| DataItemContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control) |
| DataKeysContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control) |
| DataObjectTypeName |
Hämtar eller anger namnet på en klass som ObjectDataSource kontrollen använder för en parameter i en uppdaterings-, infognings- eller borttagningsåtgärd i stället för att skicka enskilda värden från den databundna kontrollen. |
| DeleteMethod |
Hämtar eller anger namnet på den metod eller funktion som ObjectDataSource kontrollen anropar för att ta bort data. |
| DeleteParameters |
Hämtar den parametersamling som innehåller de parametrar som används av DeleteMethod metoden. |
| DesignMode |
Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control) |
| EnableCaching |
Hämtar eller anger ett värde som anger om ObjectDataSource kontrollen har datacachelagring aktiverat. |
| EnablePaging |
Hämtar eller anger ett värde som anger om datakällans kontroll stöder växling via den uppsättning data som den hämtar. |
| EnableTheming |
Hämtar ett värde som anger om den här kontrollen stöder teman. (Ärvd från DataSourceControl) |
| EnableViewState |
Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control) |
| Events |
Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control) |
| FilterExpression |
Hämtar eller anger ett filtreringsuttryck som används när den metod som anges av SelectMethod egenskapen anropas. |
| FilterParameters |
Hämtar en samling parametrar som är associerade med valfria parameterplatshållare i strängen FilterExpression . |
| HasChildViewState |
Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control) |
| ID |
Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control) |
| IdSeparator |
Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control) |
| InsertMethod |
Hämtar eller anger namnet på den metod eller funktion som ObjectDataSource kontrollen anropar för att infoga data. |
| InsertParameters |
Hämtar den parametersamling som innehåller de parametrar som används av egenskapen InsertMethod . |
| IsChildControlStateCleared |
Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control) |
| IsTrackingViewState |
Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control) |
| IsViewStateEnabled |
Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control) |
| LoadViewStateByID |
Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control) |
| MaximumRowsParameterName |
Hämtar eller anger namnet på parametern för datahämtningsmetod för affärsobjekt som används för att ange antalet poster som ska hämtas för stöd för datakällans växling. |
| NamingContainer |
Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control) |
| OldValuesParameterFormatString |
Hämtar eller anger en formatsträng som ska tillämpas på namnen på parametrarna för ursprungliga värden som skickas till |
| Page |
Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control) |
| Parent |
Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control) |
| ParsingCulture |
Hämtar ett eller anger ett värde som anger vilken kulturinformation som används vid konvertering av strängvärden till faktiska egenskapstyper för att konstruera ett objekt av den typ som anges av DataObjectTypeName. |
| RenderingCompatibility |
Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control) |
| SelectCountMethod |
Hämtar eller anger namnet på den metod eller funktion som ObjectDataSource kontrollen anropar för att hämta ett radantal. |
| SelectMethod |
Hämtar eller anger namnet på den metod eller funktion som ObjectDataSource kontrollen anropar för att hämta data. |
| SelectParameters |
Hämtar en samling parametrar som används av den metod som anges av SelectMethod egenskapen. |
| Site |
Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control) |
| SkinID |
Får huden att applicera på DataSourceControl kontrollen. (Ärvd från DataSourceControl) |
| SortParameterName |
Hämtar eller anger namnet på det affärsobjekt som parametern SelectMethod använde för att ange ett sorteringsuttryck för stöd för datakällans sortering. |
| SqlCacheDependency |
Hämtar eller anger en semikolonavgränsad sträng som anger vilka databaser och tabeller som ska användas för Microsoft SQL Server cacheberoende. |
| StartRowIndexParameterName |
Hämtar eller anger namnet på datahämtningsmetodparametern som används för att ange värdet för identifieraren för den första posten som ska hämtas för stöd för datakällans växling. |
| TemplateControl |
Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control) |
| TemplateSourceDirectory |
Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control) |
| TypeName |
Hämtar eller anger namnet på den klass som ObjectDataSource objektet representerar. |
| UniqueID |
Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control) |
| UpdateMethod |
Hämtar eller anger namnet på den metod eller funktion som ObjectDataSource kontrollen anropar för att uppdatera data. |
| UpdateParameters |
Hämtar den parametersamling som innehåller de parametrar som används av metoden som anges av UpdateMethod egenskapen. |
| ValidateRequestMode |
Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control) |
| ViewState |
Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control) |
| ViewStateIgnoresCase |
Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control) |
| ViewStateMode |
Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control) |
| Visible |
Hämtar eller anger ett värde som anger om kontrollen visas visuellt. (Ärvd från DataSourceControl) |
Metoder
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Anropas efter att en underordnad kontroll har lagts till i ControlsControl objektets samling. (Ärvd från Control) |
| AddParsedSubObject(Object) |
Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control) |
| ApplyStyleSheetSkin(Page) |
Tillämpar de formategenskaper som definieras i sidformatmallen på kontrollen. (Ärvd från DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| BuildProfileTree(String, Boolean) |
Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control) |
| ClearCachedClientID() |
Anger det cachelagrade ClientID värdet till |
| ClearChildControlState() |
Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildState() |
Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildViewState() |
Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearEffectiveClientIDMode() |
Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control) |
| CreateChildControls() |
Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control) |
| CreateControlCollection() |
Skapar en samling för att lagra underordnade kontroller. (Ärvd från DataSourceControl) |
| DataBind() |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Control) |
| DataBind(Boolean) |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control) |
| DataBindChildren() |
Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control) |
| Delete() |
Utför en borttagningsåtgärd genom att anropa metoden som identifieras av DeleteMethod egenskapen med alla parametrar som finns i DeleteParameters samlingen. |
| Dispose() |
Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control) |
| EndRenderTracing(TextWriter, Object) |
Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| EnsureChildControls() |
Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control) |
| EnsureID() |
Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindControl(String, Int32) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna |
| FindControl(String) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna |
| Focus() |
Anger indatafokus till kontrollen. (Ärvd från DataSourceControl) |
| GetDesignModeState() |
Hämtar designtidsdata för en kontroll. (Ärvd från Control) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetRouteUrl(Object) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(String, Object) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetUniqueIDRelativeTo(Control) |
Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control) |
| GetView(String) |
Hämtar den namngivna datakällans vy som är associerad med datakällans kontroll. |
| GetViewNames() |
Hämtar en samling namn som representerar listan över visningsobjekt som är associerade med ObjectDataSource objektet. |
| HasControls() |
Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från DataSourceControl) |
| HasEvents() |
Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control) |
| Insert() |
Utför en infogningsåtgärd genom att anropa den metod som identifieras av InsertMethod egenskapen och eventuella parametrar i InsertParameters samlingen. |
| IsLiteralContent() |
Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control) |
| LoadControlState(Object) |
Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control) |
| LoadViewState(Object) |
Läser in kontrollens tidigare sparade vytillstånd ObjectDataSource . |
| MapPathSecure(String) |
Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnBubbleEvent(Object, EventArgs) |
Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control) |
| OnDataBinding(EventArgs) |
Genererar händelsen DataBinding . (Ärvd från Control) |
| OnInit(EventArgs) |
Lägger till en LoadComplete händelsehanterare på sidan som innehåller ObjectDataSource kontrollen. |
| OnLoad(EventArgs) |
Genererar händelsen Load . (Ärvd från Control) |
| OnPreRender(EventArgs) |
Genererar händelsen PreRender . (Ärvd från Control) |
| OnUnload(EventArgs) |
Genererar händelsen Unload . (Ärvd från Control) |
| OpenFile(String) |
Hämtar en Stream som används för att läsa en fil. (Ärvd från Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Genererar händelsen DataSourceChanged . (Ärvd från DataSourceControl) |
| RemovedControl(Control) |
Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control) |
| Render(HtmlTextWriter) |
Skickar serverkontrollinnehåll till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control) |
| RenderChildren(HtmlTextWriter) |
Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control) |
| RenderControl(HtmlTextWriter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från DataSourceControl) |
| ResolveAdapter() |
Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control) |
| ResolveClientUrl(String) |
Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control) |
| ResolveUrl(String) |
Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control) |
| SaveControlState() |
Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control) |
| SaveViewState() |
Sparar kontrollens ObjectDataSource tillstånd. |
| Select() |
Hämtar data från den underliggande datalagringen genom att anropa metoden som identifieras av SelectMethod egenskapen med parametrarna SelectParameters i samlingen. |
| SetDesignModeState(IDictionary) |
Anger designtidsdata för en kontroll. (Ärvd från Control) |
| SetRenderMethodDelegate(RenderMethod) |
Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control) |
| SetTraceData(Object, Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| SetTraceData(Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TrackViewState() |
Spårar ändringar i visningstillståndet ObjectDataSource i kontrollen så att de kan lagras i StateBag objektet. |
| Update() |
Utför en uppdateringsåtgärd genom att anropa metoden som identifieras av UpdateMethod egenskapen och eventuella parametrar som finns i UpdateParameters samlingen. |
Händelser
| Name | Description |
|---|---|
| DataBinding |
Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control) |
| Deleted |
Inträffar när en Delete() åtgärd har slutförts. |
| Deleting |
Inträffar före en Delete() åtgärd. |
| Disposed |
Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control) |
| Filtering |
Inträffar före en filteråtgärd. |
| Init |
Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control) |
| Inserted |
Inträffar när en Insert() åtgärd har slutförts. |
| Inserting |
Inträffar före en Insert() åtgärd. |
| Load |
Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control) |
| ObjectCreated |
Inträffar efter att objektet som identifieras av egenskapen TypeName har skapats. |
| ObjectCreating |
Inträffar innan objektet som identifieras av egenskapen TypeName skapas. |
| ObjectDisposing |
Inträffar innan objektet som identifieras av egenskapen TypeName tas bort. |
| PreRender |
Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control) |
| Selected |
Inträffar när en Select() åtgärd har slutförts. |
| Selecting |
Inträffar före en Select() åtgärd. |
| Unload |
Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control) |
| Updated |
Inträffar när en Update() åtgärd har slutförts. |
| Updating |
Inträffar före en Update() åtgärd. |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control) |
| IControlDesignerAccessor.GetDesignModeState() |
En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control) |
| IControlDesignerAccessor.UserData |
En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control) |
| IDataBindingsAccessor.DataBindings |
En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control) |
| IDataBindingsAccessor.HasDataBindings |
En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control) |
| IDataSource.DataSourceChanged |
Inträffar när en datakällas kontroll har ändrats på ett sätt som påverkar databundna kontroller. (Ärvd från DataSourceControl) |
| IDataSource.GetView(String) |
Hämtar det namngivna DataSourceView objektet som är associerat med DataSourceControl kontrollen. Vissa datakällakontroller stöder endast en vy, medan andra stöder mer än en. (Ärvd från DataSourceControl) |
| IDataSource.GetViewNames() |
Hämtar en samling namn som representerar listan över DataSourceView objekt som är associerade med DataSourceControl kontrollen. (Ärvd från DataSourceControl) |
| IExpressionsAccessor.Expressions |
En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control) |
| IExpressionsAccessor.HasExpressions |
En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control) |
| IListSource.ContainsListCollection |
Anger om datakällans kontroll är associerad med en eller flera listor med data. (Ärvd från DataSourceControl) |
| IListSource.GetList() |
Hämtar en lista över datakällans kontroller som kan användas som källor till listor med data. (Ärvd från DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control) |
Tilläggsmetoder
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen. |
| FindFieldTemplate(Control, String) |
Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer. |
| FindMetaTable(Control) |
Returnerar metatabellobjektet för den innehållande datakontrollen. |
| GetDefaultValues(IDataSource) |
Hämtar insamlingen av standardvärdena för den angivna datakällan. |
| GetMetaTable(IDataSource) |
Hämtar metadata för en tabell i det angivna datakällans objekt. |
| TryGetMetaTable(IDataSource, MetaTable) |
Avgör om tabellmetadata är tillgängliga. |
