SqlDataSource Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje databázi SQL k ovládacím prvkům vázaným na data.
public ref class SqlDataSource : System::Web::UI::DataSourceControl[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))]
public class SqlDataSource : System.Web.UI.DataSourceControl[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))>]
type SqlDataSource = class
inherit DataSourceControlPublic Class SqlDataSource
Inherits DataSourceControl- Dědičnost
- Odvozené
- Atributy
Příklady
Tato část obsahuje čtyři příklady kódu:
První příklad kódu ukazuje, jak zobrazit data z SQL Serveru v ovládacím GridView prvku pomocí deklarativní syntaxe.
Druhý příklad kódu ukazuje, jak zobrazit data z databáze kompatibilní s rozhraním ODBC v ovládacím GridView prvku pomocí deklarativní syntaxe.
Třetí příklad kódu ukazuje, jak zobrazit a aktualizovat data v ovládacím GridView prvku.
Čtvrtý příklad kódu ukazuje, jak zobrazit a aktualizovat data v ovládacím DropDownList prvku.
Poznámka:
Tyto příklady ukazují, jak používat deklarativní syntaxi pro přístup k datům. Informace o přístupu k datům pomocí kódu místo značek najdete v tématu Přístup k datům v sadě Visual Studio.
Následující příklad kódu ukazuje, jak pomocí SqlDataSource ovládacího prvku deklarativní načíst data z SQL Serveru a zobrazit je v ovládacím GridView prvku.
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
DataSourceMode="DataReader"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
DataSourceMode="DataReader"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
Následující příklad kódu ukazuje, jak pomocí SqlDataSource ovládacího prvku deklarativní načíst data z databáze kompatibilní s rozhraním ODBC a zobrazit je v ovládacím GridView prvku. Vlastnost ProviderName je název zprostředkovatele dat rozhraní .NET Framework pro ROZHRANÍ ODBC, což je System.Data.Odbc.
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<!-- This example uses a Northwind database that is hosted by an ODBC-compliant
database. To run this sample, create an ODBC DSN to any database that hosts
the Northwind database, including Microsoft SQL Server or Microsoft Access,
change the name of the DSN in the ConnectionString, and view the page.
-->
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ProviderName="System.Data.Odbc"
DataSourceMode="DataReader"
ConnectionString="dsn=myodbc3dsn;"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
<%@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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<!-- This example uses a Northwind database that is hosted by an ODBC-compliant
database. To run this sample, create an ODBC DSN to any database that hosts
the Northwind database, including Microsoft SQL Server or Microsoft Access,
change the name of the DSN in the ConnectionString, and view the page.
-->
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ProviderName="System.Data.Odbc"
DataSourceMode="DataReader"
ConnectionString="dsn=myodbc3dsn;"
SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
DataSourceID="SqlDataSource1">
</asp:GridView>
</form>
</body>
</html>
Následující příklad kódu ukazuje běžný scénář zobrazení a aktualizace s ovládacím GridView prvku. Stejně jako v předchozích příkladech se data z databáze Northwind zobrazují v ovládacím GridView prvku. Kromě toho, protože je zadána UpdateCommand vlastnost a AutoGenerateEditButton vlastnost je nastavena na true, můžete upravovat a aktualizovat záznamy bez dalšího kódu. Ovládací GridView prvek automaticky zpracovává přidávání parametrů do UpdateParameters kolekce a volá metodu Update při kliknutí na tlačítko Aktualizovat v ovládacím GridView prvku.
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
DataSourceMode="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
AutoGenerateColumns="False"
DataKeyNames="EmployeeID"
AutoGenerateEditButton="True"
DataSourceID="SqlDataSource1">
<columns>
<asp:BoundField HeaderText="First Name" DataField="FirstName" />
<asp:BoundField HeaderText="Last Name" DataField="LastName" />
<asp:BoundField HeaderText="Title" DataField="Title" />
</columns>
</asp:GridView>
</form>
</body>
</html>
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
DataSourceMode="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
</asp:SqlDataSource>
<asp:GridView
id="GridView1"
runat="server"
AutoGenerateColumns="False"
DataKeyNames="EmployeeID"
AutoGenerateEditButton="True"
DataSourceID="SqlDataSource1">
<columns>
<asp:BoundField HeaderText="First Name" DataField="FirstName" />
<asp:BoundField HeaderText="Last Name" DataField="LastName" />
<asp:BoundField HeaderText="Title" DataField="Title" />
</columns>
</asp:GridView>
</form>
</body>
</html>
Následující příklad kódu ukazuje běžný scénář zobrazení a aktualizace s ovládacími DropDownList prvky.TextBox Ovládací DropDownList prvek automaticky nepřidá aktualizační parametry do UpdateParameters kolekce ani volání Update metody, takže to musíte udělat. Parametry aktualizace jsou zadány deklarativním způsobem a můžete přidat obslužnou rutinu události k provedení Update operace při vyvolání události.
Důležité
Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.
<%@Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void On_Click(Object source, EventArgs e) {
try {
SqlDataSource1.Update();
}
catch (Exception except) {
// Handle the Exception.
}
Label2.Text="The record was updated successfully!";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
<UpdateParameters>
<asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
<asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
</UpdateParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataValueField="EmployeeID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<br />
<asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
AssociatedControlID="TextBox1" />
<asp:TextBox id="TextBox1" runat="server" />
<asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />
<br /><asp:Label id="Label2" runat="server" Text="" />
</form>
</body>
</html>
<%@Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
Try
SqlDataSource1.Update()
Catch except As Exception
' Handle the Exception.
End Try
Label2.Text="The record was updated successfully!"
End Sub 'On_Click
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
<UpdateParameters>
<asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
<asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
</UpdateParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataValueField="EmployeeID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<br />
<asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
AssociatedControlID="TextBox1" />
<asp:TextBox id="TextBox1" runat="server" />
<asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />
<br /><asp:Label id="Label2" runat="server" Text="" />
</form>
</body>
</html>
Poznámky
V tomto tématu:
Introduction
Ovládací SqlDataSource prvek zdroje dat představuje data v relační databázi SQL s ovládacími prvky vázanými na data. Ovládací prvek můžete použít SqlDataSource ve spojení s ovládacím prvku vázaném na data k načtení dat z relační databáze a k zobrazení, úpravě a řazení dat na webové stránce s malým nebo žádným kódem.
Datová připojení
Pokud se chcete připojit k databázi, musíte vlastnost nastavit ConnectionString na platný připojovací řetězec. Může SqlDataSource podporovat jakoukoli relační databázi SQL, ke které lze připojit pomocí poskytovatele ADO.NET, jako je například SqlClient, OleDb, Odbcnebo OracleClient zprostředkovatel. Informace o tom, jak zabezpečit připojovací řetězce, naleznete v tématu Postupy: Zabezpečení připojovacích řetězců při použití ovládacích prvků zdroje dat.
Pokud chcete načíst data z podkladové databáze, nastavte SelectCommand vlastnost pomocí dotazu SQL. Pokud databáze, ke které je přidružena SqlDataSource , podporuje uložené procedury, můžete vlastnost nastavit SelectCommand na název uložené procedury. Zadaným dotazem SQL může být také parametrizovaný dotaz. Do kolekce můžete přidat Parameter objekty, které jsou přidružené k parametrizovanému SelectParameters dotazu. Další informace o parametrizovaných dotazech SQL a jejich syntaxi naleznete v tématu Použití parametrů s ovládacími prvky zdroje dat pro filtrování.
Ovládací SqlDataSource prvek načte data při každém Select zavolání metody. Tato metoda poskytuje programový přístup k metodě, která je určena SelectMethod vlastností. Metoda Select je automaticky volána ovládacími prvky, které jsou vázány na SqlDataSource při DataBind jejich zavolání metody. Pokud nastavíte DataSourceID vlastnost ovládacího prvku vázaného na data, ovládací prvek se podle potřeby automaticky sváže s daty ze zdroje dat.
DataSourceID Nastavení vlastnosti je doporučená metoda pro vytvoření vazby ObjectDataSource ovládacího prvku na ovládací prvek svázaný s daty. Alternativně můžete použít DataSource vlastnost, ale pak musíte explicitně volat DataBind metodu ovládacího prvku vázaného na data. Příklady ovládacích prvků vázaných na data, které lze použít SqlDataSource , jsou DataGrid, DetailsView, DataLista DropDownList. Metodu Select můžete volat programově a načíst data z podkladové databáze.
Ve scénářích deklarativních a programových ASP.NET můžete nastavit DataSourceID vlastnost ovládacího prvku vázaného na data na ID SqlDataSource ovládacího prvku. Instanci třídy můžete také přiřadit SqlDataSource vlastnosti DataSource ovládacího prvku vázaného na data. Další informace o vazbě ovládacího prvku vázaného na data s ovládacími prvky zdroje dat najdete v tématu ASP.NET Možnosti přístupu k datům.
Provádění operací s daty
V závislosti na možnostech podkladového databázového produktu a konfiguraci instance SqlDataSource třídy můžete provádět datové operace, jako jsou aktualizace, vložení a odstranění. Chcete-li provést tyto datové operace, nastavte odpovídající text příkazu a všechny přidružené parametry pro operaci, kterou chcete provést. Například pro operaci aktualizace nastavte UpdateCommand vlastnost na řetězec SQL nebo název uložené procedury a přidejte do kolekce všechny požadované parametry UpdateParameters . Aktualizace se provádí při Update zavolání metody, a to buď explicitně vaším kódem, nebo automaticky ovládacím prvku vázaném na data. Stejný obecný vzor se používá pro Delete operace a Insert operace.
Dotazy a příkazy SQL, které používáte v parametru SelectCommand, InsertCommandUpdateCommanda DeleteCommand vlastnosti lze parametrizovat. To znamená, že dotaz nebo příkaz může místo hodnot literálů používat zástupné symboly a svázat zástupné symboly s proměnnými definovanými aplikací nebo uživatelem. Parametry v dotazech SQL můžete svázat s proměnnými relace, hodnotami předávanými v řetězci dotazu pro stránku webových formulářů, hodnotami vlastností jiných serverových ovládacích prvků a dalšími prvky. Další informace o použití parametrů v dotazech SQL s ovládacími SqlDataSourceprvky zdroje dat naleznete v tématu Použití parametrů s ovládacími prvky zdroje dat pro filtrování a použití parametrů s ovládacím prvku SqlDataSource.
Poznámka:
Ve výchozím nastavení platí, že pokud je některý z parametrů null při spuštění Select příkazu, nebudou vrácena žádná data a nebude vyvolán žádná výjimka. Toto chování můžete změnit nastavením CancelSelectOnNullParameter vlastnosti na falsehodnotu .
Zprostředkovatel dat
Ve výchozím nastavení SqlDataSource ovládací prvek funguje se zprostředkovatelem dat rozhraní .NET Framework pro SQL Server, ale SqlDataSource není specifický pro Microsoft SQL Server. Ovládací prvek můžete připojit SqlDataSource k libovolnému databázovému produktu, pro který je spravovaný poskytovatel ADO.NET. Při použití s System.Data.OleDb poskytovatelem SqlDataSource může pracovat s libovolnou databází kompatibilní s OLE DB. Při použití s System.Data.Odbc poskytovatelem SqlDataSource se dá použít s libovolným ovladačem ODBC a databází, včetně IBM DB2, MySQL a PostgreSQL. Při použití s System.Data.OracleClient poskytovatelem SqlDataSource může pracovat s databázemi Oracle 8.1.7 a novějšími. Seznam povolených zprostředkovatelů je registrován v DbProviderFactories části konfiguračního souboru, a to buď v Machine.config, nebo Web.config souboru. Další informace naleznete v tématu Výběr dat pomocí ovládacího prvku SqlDataSource.
Cacheování
Pokud na stránce zobrazíte data pomocí SqlDataSource ovládacího prvku, můžete zvýšit výkon stránky pomocí možností ukládání dat do mezipaměti ovládacího prvku zdroje dat. Ukládání do mezipaměti snižuje zatížení zpracování databázových serverů na úkor paměti na webovém serveru; ve většině případů je to dobrý kompromis. Automaticky SqlDataSource ukládá data do mezipaměti, když EnableCaching je vlastnost nastavena true a CacheDuration vlastnost je nastavena na počet sekund, po které mezipaměť ukládá data před zahozením položky mezipaměti. Můžete také zadat CacheExpirationPolicy a volitelnou SqlCacheDependency hodnotu.
Další funkce
Poskytuje SqlDataSource další možnosti, jak je uvedeno v následující tabulce.
| Schopnost | Požadavky |
|---|---|
| Cacheování |
DataSourceMode Nastavte vlastnost na DataSet hodnotu, EnableCaching vlastnost na truea CacheDuration vlastnosti podle CacheExpirationPolicy chování ukládání do mezipaměti, které chcete použít pro data uložená v mezipaměti. |
| Odstranit | DeleteCommand Nastavte vlastnost na příkaz SQL použitý k odstranění dat. Tento příkaz je obvykle parametrizován. |
| Filtrování | DataSourceMode Nastavte vlastnost na DataSet hodnotu. FilterExpression Nastavte vlastnost na filtrovací výraz použitý k filtrování dat při Select zavolání metody. |
| Vkládání | InsertCommand Nastavte vlastnost na příkaz SQL použitý k vložení dat. Tento příkaz je obvykle parametrizován. |
| Paging | Ovládací prvky vázané na SqlDataSourcedata nejsou aktuálně podporovány, například GridView, podporují stránkování při nastavení DataSourceMode vlastnosti na DataSet hodnotu. |
| Vybírání | SelectCommand Nastavte vlastnost na příkaz SQL, který se používá k načtení dat. |
| Řazení | Nastavte vlastnost DataSourceMode na DataSet. |
| Aktualizace | UpdateCommand Nastavte vlastnost na příkaz SQL použitý k aktualizaci dat. Tento příkaz je obvykle parametrizován. |
Zobrazení zdroje dat
Stejně jako u všech ovládacích prvků SqlDataSource zdroje dat je ovládací prvek přidružený ke třídě zobrazení zdroje dat. Ovládací SqlDataSource prvek má pouze jednu přidruženou SqlDataSourceViewa vždy má název Table.
Neexistuje žádné vizuální vykreslování SqlDataSource ovládacího prvku; je implementováno jako ovládací prvek, abyste ho mohli vytvořit deklarativním způsobem a volitelně, aby se mohl účastnit správy stavů. V důsledku toho nepodporuje vizuální funkce, jako jsou ty, SqlDataSource které poskytuje EnableTheming nebo SkinID vlastnost.
Deklarativní syntaxe
<asp:SqlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
CancelSelectOnNullParameter="True|False"
ConflictDetection="OverwriteChanges|CompareAllValues"
ConnectionString="string"
DataSourceMode="DataReader|DataSet"
DeleteCommand="string"
DeleteCommandType="Text|StoredProcedure"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FilterExpression="string"
ID="string"
InsertCommand="string"
InsertCommandType="Text|StoredProcedure"
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"
OnPreRender="PreRender event handler"
OnSelected="Selected event handler"
OnSelecting="Selecting event handler"
OnUnload="Unload event handler"
OnUpdated="Updated event handler"
OnUpdating="Updating event handler"
ProviderName="string|System.Data.Odbc|System.Data.OleDb|
System.Data.OracleClient|System.Data.SqlClient|
Microsoft.SqlServerCe.Client"
runat="server"
SelectCommand="string"
SelectCommandType="Text|StoredProcedure"
SkinID="string"
SortParameterName="string"
SqlCacheDependency="string"
UpdateCommand="string"
UpdateCommandType="Text|StoredProcedure"
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:SqlDataSource>
Konstruktory
| Name | Description |
|---|---|
| SqlDataSource() |
Inicializuje novou instanci SqlDataSource třídy. |
| SqlDataSource(String, String, String) |
Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu Select. |
| SqlDataSource(String, String) |
Inicializuje novou instanci třídy pomocí zadaného připojovacího SqlDataSource řetězce a příkazu Select. |
Vlastnosti
| Name | Description |
|---|---|
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control) |
| CacheDuration |
Získá nebo nastaví dobu v sekundách, že řízení zdrojů dat ukládá data načtená metodou Select(DataSourceSelectArguments) do mezipaměti. |
| CacheExpirationPolicy |
Získá nebo nastaví chování vypršení platnosti mezipaměti, které v kombinaci s dobou trvání popisuje chování mezipaměti, kterou používá řízení zdrojů dat. |
| CacheKeyDependency |
Získá nebo nastaví uživatelsky definovanou závislost klíče, která je propojena se všemi objekty mezipaměti dat vytvořenými ovládacím prvek zdroje dat. Při vypršení platnosti klíče jsou explicitně ukončeny všechny objekty mezipaměti. |
| CancelSelectOnNullParameter |
Získá nebo nastaví hodnotu určující, zda je operace načítání dat zrušena, když se vyhodnotí jakýkoli parametr obsažený v SelectParameters kolekci |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClientID |
Získá identifikátor ovládacího prvku serveru vygenerovaný ASP.NET. (Zděděno od DataSourceControl) |
| ClientIDMode |
Tato vlastnost se nepoužívá pro ovládací prvky zdroje dat. (Zděděno od DataSourceControl) |
| ClientIDSeparator |
Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| ConflictDetection |
Získá nebo nastaví hodnotu určující, jak SqlDataSource ovládací prvek provádí aktualizace a odstraní, když se data v řádku v podkladové databázi změní v době operace. |
| ConnectionString |
Získá nebo nastaví připojovací řetězec specifický pro ADO.NET zprostředkovatele, který SqlDataSource ovládací prvek používá pro připojení k podkladové databázi. |
| Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
| Controls |
ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od DataSourceControl) |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DataSourceMode |
Získá nebo nastaví režim načítání dat, který SqlDataSource ovládací prvek používá k načtení dat. |
| DeleteCommand |
Získá nebo nastaví řetězec SQL, který SqlDataSource ovládací prvek používá k odstranění dat z podkladové databáze. |
| DeleteCommandType |
Získá nebo nastaví hodnotu určující, zda text ve DeleteCommand vlastnosti je příkaz SQL nebo název uložené procedury. |
| DeleteParameters |
Získá kolekci parametrů obsahující parametry, které jsou používány DeleteCommand vlastností z SqlDataSourceView objektu, který je přidružen k SqlDataSource ovládacího prvku. |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| EnableCaching |
Získá nebo nastaví hodnotu určující, zda SqlDataSource má ovládací prvek povoleno ukládání dat do mezipaměti. |
| EnableTheming |
Získá hodnotu určující, zda tento ovládací prvek podporuje motivy. (Zděděno od DataSourceControl) |
| EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| FilterExpression |
Získá nebo nastaví filtrovací výraz, který se použije při Select(DataSourceSelectArguments) zavolání metody. |
| FilterParameters |
Získá kolekci parametrů, které jsou přidruženy k libovolným zástupným symbolům parametrů, které jsou v řetězci FilterExpression . |
| HasChildViewState |
Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| InsertCommand |
Získá nebo nastaví řetězec SQL, který SqlDataSource ovládací prvek používá k vložení dat do podkladové databáze. |
| InsertCommandType |
Získá nebo nastaví hodnotu určující, zda text ve InsertCommand vlastnosti je příkaz SQL nebo název uložené procedury. |
| InsertParameters |
Získá kolekci parametrů obsahující parametry, které jsou používány InsertCommand vlastností z SqlDataSourceView objektu, který je přidružen k SqlDataSource ovládacího prvku. |
| IsChildControlStateCleared |
Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| OldValuesParameterFormatString |
Získá nebo nastaví formátovací řetězec použít na názvy všech parametrů, které jsou předány Delete() do nebo Update() metody. |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| ProviderName |
Získá nebo nastaví název zprostředkovatele dat rozhraní .NET Framework, který SqlDataSource ovládací prvek používá pro připojení k podkladovému zdroji dat. |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| SelectCommand |
Získá nebo nastaví řetězec SQL, který SqlDataSource ovládací prvek používá k načtení dat z podkladové databáze. |
| SelectCommandType |
Získá nebo nastaví hodnotu určující, zda text ve SelectCommand vlastnosti je dotaz SQL nebo název uložené procedury. |
| SelectParameters |
Získá kolekci parametrů obsahující parametry, které jsou používány SelectCommand vlastností z SqlDataSourceView objektu, který je přidružen k SqlDataSource ovládacího prvku. |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá kůži, která se použije na DataSourceControl ovládací prvek. (Zděděno od DataSourceControl) |
| SortParameterName |
Získá nebo nastaví název parametru uložené procedury, který se používá k řazení načtených dat při načítání dat pomocí uložené procedury. |
| SqlCacheDependency |
Získá nebo nastaví řetězec oddělený středníkem, který označuje, které databáze a tabulky se mají použít pro závislost mezipaměti Microsoft SQL Serveru. |
| TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
| TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| UpdateCommand |
Získá nebo nastaví řetězec SQL, který SqlDataSource ovládací prvek používá k aktualizaci dat v podkladové databázi. |
| UpdateCommandType |
Získá nebo nastaví hodnotu určující, zda text ve UpdateCommand vlastnosti je příkaz SQL nebo název uložené procedury. |
| UpdateParameters |
Získá kolekci parametrů obsahující parametry, které jsou používány UpdateCommand vlastností z SqlDataSourceView ovládacího prvku, který je přidružen k SqlDataSource ovládacího prvku. |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu určující, zda je ovládací prvek vizuálně zobrazen. (Zděděno od DataSourceControl) |
Metody
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
| AddParsedSubObject(Object) |
Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CreateChildControls() |
Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control) |
| CreateControlCollection() |
Vytvoří kolekci pro ukládání podřízených ovládacích prvků. (Zděděno od DataSourceControl) |
| CreateDataSourceView(String) |
Vytvoří objekt zobrazení zdroje dat přidružený ke správě zdroje dat. |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| Delete() |
Provede operaci odstranění pomocí DeleteCommand řetězce SQL a všech parametrů, které jsou v kolekci DeleteParameters . |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus na ovládací prvek. (Zděděno od DataSourceControl) |
| GetDbProviderFactory() |
DbProviderFactory Vrátí objekt, který je přidružen k ADO.NET zprostředkovatel, který je identifikován vlastnostíProviderName. |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control) |
| GetView(String) |
Získá pojmenované zobrazení zdroje dat, které je přidruženo ke správě zdroje dat. |
| GetViewNames() |
Získá kolekci názvů představující seznam objektů zobrazení, které jsou přidruženy k ovládacímu SqlDataSource prvku. |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od DataSourceControl) |
| HasEvents() |
Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| Insert() |
Provede operaci vložení pomocí InsertCommand řetězce SQL a všech parametrů, které jsou v kolekci InsertParameters . |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control) |
| LoadViewState(Object) |
Načte stav vlastností v ovládacím SqlDataSource prvku, který je potřeba zachovat. |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control) |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnInit(EventArgs) |
Přidá obslužnou rutinu LoadCompletePage události do ovládacího prvku, který obsahuje SqlDataSource ovládací prvek. |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. (Zděděno od Control) |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá použité ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
DataSourceChanged Vyvolá událost. (Zděděno od DataSourceControl) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Odešle obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od DataSourceControl) |
| ResolveAdapter() |
Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží aktuální stav SqlDataSource zobrazení ovládacího prvku. |
| Select(DataSourceSelectArguments) |
Načte data z podkladové databáze pomocí SelectCommand řetězce SQL a všech parametrů, které jsou v kolekci SelectParameters . |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Sleduje změny SqlDataSource stavu zobrazení ovládacího prvku, aby změny mohly být uloženy v objektu StateBag ovládacího prvku. |
| Update() |
Provede operaci aktualizace pomocí UpdateCommand řetězce SQL a všech parametrů, které jsou v kolekci UpdateParameters . |
Událost
| Name | Description |
|---|---|
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| Deleted |
Nastane po dokončení operace odstranění. |
| Deleting |
Nastane před operací odstranění. |
| Disposed |
Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control) |
| Filtering |
Nastane před operací filtru. |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Inserted |
Nastane po dokončení operace vložení. |
| Inserting |
Nastane před operací vložení. |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Selected |
Nastane, když se dokončí operace načítání dat. |
| Selecting |
Nastane před operací načítání dat. |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
| Updated |
Nastane po dokončení operace aktualizace. |
| Updating |
Nastane před operací aktualizace. |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control) |
| IControlDesignerAccessor.UserData |
Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control) |
| IDataBindingsAccessor.DataBindings |
Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control) |
| IDataBindingsAccessor.HasDataBindings |
Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control) |
| IDataSource.DataSourceChanged |
Nastane, když se ovládací prvek zdroje dat změnil způsobem, který ovlivňuje ovládací prvky vázané na data. (Zděděno od DataSourceControl) |
| IDataSource.GetView(String) |
Získá pojmenovaný DataSourceView objekt přidružený k ovládacímu DataSourceControl prvku. Některé ovládací prvky zdroje dat podporují jenom jedno zobrazení, zatímco jiné podporují více než jedno. (Zděděno od DataSourceControl) |
| IDataSource.GetViewNames() |
Získá kolekci názvů představující seznam objektů přidružených DataSourceView k ovládacímu DataSourceControl prvku. (Zděděno od DataSourceControl) |
| IExpressionsAccessor.Expressions |
Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control) |
| IExpressionsAccessor.HasExpressions |
Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control) |
| IListSource.ContainsListCollection |
Určuje, jestli je ovládací prvek zdroje dat přidružený k jednomu nebo více seznamům dat. (Zděděno od DataSourceControl) |
| IListSource.GetList() |
Získá seznam ovládacích prvků zdroje dat, které lze použít jako zdroje seznamů dat. (Zděděno od DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control) |
Metody rozšíření
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| GetDefaultValues(IDataSource) |
Získá kolekci výchozích hodnot pro zadaný zdroj dat. |
| GetMetaTable(IDataSource) |
Získá metadata pro tabulku v zadaném objektu zdroje dat. |
| TryGetMetaTable(IDataSource, MetaTable) |
Určuje, zda jsou k dispozici metadata tabulky. |
