SqlDataSource Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um banco de dados SQL para controles associados a dados.
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- Herança
- Derivado
- Atributos
Exemplos
Esta seção contém quatro exemplos de código:
O primeiro exemplo de código demonstra como exibir dados do SQL Server em um GridView controle usando sintaxe declarativa.
O segundo exemplo de código demonstra como exibir dados de um banco de dados compatível com ODBC em um GridView controle usando sintaxe declarativa.
O terceiro exemplo de código demonstra como exibir e atualizar dados em um GridView controle.
O quarto exemplo de código demonstra como exibir e atualizar dados em um DropDownList controle.
Observação
Estes exemplos mostram como usar a sintaxe declarativa para acesso a dados. Para obter informações sobre como acessar dados usando código em vez de marcação, consulte Acessando dados no Visual Studio.
O exemplo de código a seguir demonstra como usar um SqlDataSource controle declarativamente para recuperar dados do SQL Server e exibi-los em um GridView controle.
<%@ 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>
O exemplo de código a seguir demonstra como usar um SqlDataSource controle declarativamente para recuperar dados de um banco de dados compatível com ODBC e exibi-los em um GridView controle. A ProviderName propriedade é o nome do Provedor de Dados do .NET Framework para ODBC, que é 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>
O exemplo de código a seguir demonstra um cenário comum de exibição e atualização com o GridView controle. Assim como nos exemplos anteriores, os dados do banco de dados Northwind são exibidos no GridView controle. Além disso, como uma UpdateCommand propriedade é especificada e a AutoGenerateEditButton propriedade é definida como true, você pode editar e atualizar os registros sem código adicional. O GridView controle manipula automaticamente a UpdateParameters adição de parâmetros à coleção e chama o Update método quando o botão Atualizar no GridView controle é clicado.
<%@ 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>
O exemplo de código a seguir demonstra um cenário comum de exibição e atualização com os controles e TextBox a DropDownList exibição. O DropDownList controle não adiciona automaticamente parâmetros de atualização à UpdateParameters coleção nem chama o Update método, portanto, você deve fazer isso. Os parâmetros de atualização são especificados declarativamente e você pode adicionar um manipulador de eventos para executar a Update operação quando um evento é acionado.
Importante
Este exemplo inclui uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.
<%@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>
Comentários
Neste tópico:
Introdução
O controle da SqlDataSource fonte de dados representa dados em um banco de dados relacional SQL para controles associados a dados. Você pode usar o SqlDataSource controle em conjunto com um controle associado a dados para recuperar dados de um banco de dados relacional e exibir, editar e classificar dados em uma página da Web com pouco ou nenhum código.
Conexões de Dados
Para se conectar a um banco de dados, você deve definir a ConnectionString propriedade como uma cadeia de conexão válida. É SqlDataSource possível dar suporte a qualquer banco de dados relacional SQL que possa ser conectado ao uso de um provedor de ADO.NET, como o SqlClientprovedor , OleDbou OdbcOracleClient o provedor. Para obter informações sobre como proteger cadeias de conexão, consulte Como proteger cadeias de conexão ao usar controles de fonte de dados.
Para recuperar dados de um banco de dados subjacente, defina a SelectCommand propriedade com uma consulta SQL. Se o banco de dados SqlDataSource associado a ele der suporte a procedimentos armazenados, você poderá definir a SelectCommand propriedade como o nome de um procedimento armazenado. A consulta SQL especificada também pode ser uma consulta parametrizada. Você pode adicionar Parameter objetos associados a uma consulta parametrizada à SelectParameters coleção. Para obter mais informações sobre consultas SQL parametrizadas e sua sintaxe, consulte Como usar parâmetros com controles de fonte de dados para filtragem.
O SqlDataSource controle recupera dados sempre que o Select método é chamado. Esse método fornece acesso programático ao método especificado por SelectMethod propriedade. O Select método é chamado automaticamente por controles associados ao quando seu SqlDataSourceDataBind método é chamado. Se você definir a DataSourceID propriedade de um controle associado a dados, o controle será automaticamente associado aos dados da fonte de dados, conforme necessário. Definir a DataSourceID propriedade é o método recomendado para associar um ObjectDataSource controle a um controle associado a dados. Como alternativa, você pode usar a DataSource propriedade, mas deve chamar explicitamente o DataBind método do controle associado a dados. Alguns exemplos de controles associados a dados que podem ser usados SqlDataSource são DataGrid, DetailsViewe DataListDropDownList. Você pode chamar o Select método programaticamente a qualquer momento para recuperar dados do banco de dados subjacente.
Em cenários declarativos e programáticos de ASP.NET, você pode definir a DataSourceID propriedade do controle associado a dados para a ID do SqlDataSource controle. Você também pode atribuir uma instância da SqlDataSource classe à DataSource propriedade do controle associado a dados. Para obter mais informações sobre como associar controle associado a dados a controles de fonte de dados, consulte ASP.NET Opções de Acesso a Dados.
Executando operações de dados
Dependendo dos recursos do produto de banco de dados subjacente e da configuração da instância da classe, você pode executar operações de SqlDataSource dados, como atualizações, inserções e exclusões. Para executar essas operações de dados, defina o texto de comando apropriado e todos os parâmetros associados para a operação que você deseja executar. Por exemplo, para uma operação de atualização, defina a UpdateCommand propriedade como uma cadeia de caracteres SQL ou o nome de um procedimento armazenado e adicione todos os UpdateParameters parâmetros necessários à coleção. A atualização é executada quando o Update método é chamado explicitamente pelo código ou automaticamente por um controle associado a dados. O mesmo padrão geral é seguido para Delete e Insert operações.
As consultas e os comandos SQL que você usa nas SelectCommandUpdateCommandInsertCommandpropriedades e DeleteCommand nas propriedades podem ser parametrizados. Isso significa que a consulta ou o comando pode usar espaços reservados em vez de valores literais e associar os espaços reservados a variáveis definidas pelo aplicativo ou pelo usuário. Você pode associar parâmetros em consultas SQL a variáveis de sessão, valores que são passados na cadeia de caracteres de consulta para uma página do Web Forms, os valores de propriedade de outros controles de servidor e muito mais. Para obter mais informações sobre como usar parâmetros em consultas SQL com o SqlDataSource, consulte Como usar parâmetros com controles de fonte de dados para filtragem e uso de parâmetros com o controle SqlDataSource.
Observação
Por padrão, se um dos parâmetros for null quando você executar um Select comando, nenhum dado será retornado e nenhuma exceção será gerada. Você pode alterar esse comportamento definindo a CancelSelectOnNullParameter propriedade como false.
Provedor de dados
Por padrão, o SqlDataSource controle funciona com o Provedor de Dados do .NET Framework para SQL Server, mas SqlDataSource não é específico do Microsoft SQL Server. Você pode conectar o SqlDataSource controle a qualquer produto de banco de dados para o qual há um provedor de ADO.NET gerenciado. Quando usado com o System.Data.OleDb provedor, ele SqlDataSource pode trabalhar com qualquer banco de dados compatível com OLE DB. Quando usado com o System.Data.Odbc provedor, ele SqlDataSource pode ser usado com qualquer driver E banco de dados ODBC, incluindo IBM DB2, MySQL e PostgreSQL. Quando usado com o System.Data.OracleClient provedor, ele SqlDataSource pode trabalhar com bancos de dados Oracle 8.1.7 e posteriores. A lista de provedores permitidos é registrada na DbProviderFactories seção do arquivo de configuração, no arquivo Machine.config ou Web.config. Para obter mais informações, consulte Selecionar dados usando o controle SqlDataSource.
Armazenamento em cache
Se você exibir dados em sua página usando um SqlDataSource controle, poderá aumentar o desempenho da página usando os recursos de cache de dados do controle da fonte de dados. O cache reduz a carga de processamento nos servidores de banco de dados em detrimento da memória no servidor Web; na maioria dos casos, essa é uma boa troca. Os SqlDataSource dados são armazenados em cache automaticamente quando a EnableCaching propriedade é definida true e a CacheDuration propriedade é definida como o número de segundos que o cache armazena dados antes que a entrada de cache seja descartada. Você também pode especificar um CacheExpirationPolicy valor opcional e um valor opcional SqlCacheDependency .
Recursos Adicionais
O SqlDataSource fornece recursos adicionais, conforme listado na tabela a seguir.
| Capacidade | Requisitos |
|---|---|
| Armazenamento em cache | Defina a DataSourceMode propriedade como o DataSet valor, a EnableCaching propriedade como truee as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache desejado para seus dados armazenados em cache. |
| Excluindo | Defina a DeleteCommand propriedade como uma instrução SQL usada para excluir dados. Essa instrução normalmente é parametrizada. |
| Filtragem | Defina a DataSourceMode propriedade como o DataSet valor. Defina a FilterExpression propriedade como uma expressão de filtragem usada para filtrar os dados quando o Select método for chamado. |
| Inserindo | Defina a InsertCommand propriedade como uma instrução SQL usada para inserir dados. Essa instrução normalmente é parametrizada. |
| Paging | No momento, não há suporte para o SqlDataSource, no entanto, alguns controles associados a dados, como GridView, dão suporte à paginação quando você define a DataSourceMode propriedade como o DataSet valor. |
| Selecionar | Defina a SelectCommand propriedade como uma instrução SQL usada para recuperar dados. |
| Classificação | Defina a propriedade DataSourceMode como DataSet. |
| Atualização | Defina a UpdateCommand propriedade como uma instrução SQL usada para atualizar dados. Essa instrução normalmente é parametrizada. |
Exibição da fonte de dados
Assim como acontece com todos os controles da fonte de dados, o SqlDataSource controle é associado a uma classe de exibição de fonte de dados. O SqlDataSource controle tem apenas um associado SqlDataSourceViewe é sempre nomeado Table.
Não há nenhuma renderização visual do SqlDataSource controle; ele é implementado como um controle para que você possa criá-lo declarativamente e, opcionalmente, permitir que ele participe do gerenciamento de estado. Como resultado, não SqlDataSource há suporte para recursos visuais, como os fornecidos pela propriedade ou SkinID pela EnableTheming propriedade.
Sintaxe declarativa
<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>
Construtores
| Nome | Description |
|---|---|
| SqlDataSource() |
Inicializa uma nova instância da classe SqlDataSource. |
| SqlDataSource(String, String, String) |
Inicializa uma nova instância da SqlDataSource classe com a cadeia de conexão especificada e o comando Selecionar. |
| SqlDataSource(String, String) |
Inicializa uma nova instância da SqlDataSource classe com a cadeia de conexão especificada e o comando Selecionar. |
Propriedades
| Nome | Description |
|---|---|
| Adapter |
Obtém o adaptador específico do navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control) |
| BindingContainer |
Obtém o controle que contém a associação de dados desse controle. (Herdado de Control) |
| CacheDuration |
Obtém ou define o período de tempo, em segundos, em que o controle da fonte de dados armazena em cache os dados recuperados pelo Select(DataSourceSelectArguments) método. |
| CacheExpirationPolicy |
Obtém ou define o comportamento de expiração do cache que, quando combinado com a duração, descreve o comportamento do cache que o controle da fonte de dados usa. |
| CacheKeyDependency |
Obtém ou define uma dependência de chave definida pelo usuário que está vinculada a todos os objetos de cache de dados criados pelo controle da fonte de dados. Todos os objetos de cache expiram explicitamente quando a chave expirou. |
| CancelSelectOnNullParameter |
Obtém ou define um valor que indica se uma operação de recuperação de dados é cancelada quando qualquer parâmetro contido na SelectParameters coleção é avaliado como |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o identificador de controle do servidor gerado pelo ASP.NET. (Herdado de DataSourceControl) |
| ClientIDMode |
Essa propriedade não é usada para controles de fonte de dados. (Herdado de DataSourceControl) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control) |
| ConflictDetection |
Obtém ou define o valor que indica como o SqlDataSource controle executa atualizações e exclusões quando os dados em uma linha no banco de dados subjacente são alterados durante o tempo da operação. |
| ConnectionString |
Obtém ou define a cadeia de conexão específica do provedor ADO.NET que o SqlDataSource controle usa para se conectar a um banco de dados subjacente. |
| Context |
Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de DataSourceControl) |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control) |
| DataSourceMode |
Obtém ou define o modo de recuperação de dados que o SqlDataSource controle usa para buscar dados. |
| DeleteCommand |
Obtém ou define a cadeia de caracteres SQL que o SqlDataSource controle usa para excluir dados do banco de dados subjacente. |
| DeleteCommandType |
Obtém ou define um valor que indica se o texto na DeleteCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado. |
| DeleteParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela DeleteCommand propriedade do SqlDataSourceView objeto associado ao SqlDataSource controle. |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| EnableCaching |
Obtém ou define um valor que indica se o controle tem o SqlDataSource cache de dados habilitado. |
| EnableTheming |
Obtém um valor que indica se esse controle dá suporte a temas. (Herdado de DataSourceControl) |
| EnableViewState |
Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| FilterExpression |
Obtém ou define uma expressão de filtragem que é aplicada quando o Select(DataSourceSelectArguments) método é chamado. |
| FilterParameters |
Obtém uma coleção de parâmetros associados a quaisquer espaços reservados de parâmetro que estejam na FilterExpression cadeia de caracteres. |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| InsertCommand |
Obtém ou define a cadeia de caracteres SQL que o SqlDataSource controle usa para inserir dados no banco de dados subjacente. |
| InsertCommandType |
Obtém ou define um valor que indica se o texto na InsertCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado. |
| InsertParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela InsertCommand propriedade do SqlDataSourceView objeto associado ao SqlDataSource controle. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| OldValuesParameterFormatString |
Obtém ou define uma cadeia de caracteres de formato a ser aplicada aos nomes de todos os parâmetros que são passados para o método ou Update() para o Delete() método. |
| Page |
Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control) |
| ProviderName |
Obtém ou define o nome do provedor de dados do .NET Framework que o SqlDataSource controle usa para se conectar a uma fonte de dados subjacente. |
| RenderingCompatibility |
Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| SelectCommand |
Obtém ou define a cadeia de caracteres SQL que o SqlDataSource controle usa para recuperar dados do banco de dados subjacente. |
| SelectCommandType |
Obtém ou define um valor que indica se o texto na SelectCommand propriedade é uma consulta SQL ou o nome de um procedimento armazenado. |
| SelectParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela SelectCommand propriedade do SqlDataSourceView objeto associado ao SqlDataSource controle. |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém a pele a ser aplicada ao DataSourceControl controle. (Herdado de DataSourceControl) |
| SortParameterName |
Obtém ou define o nome de um parâmetro de procedimento armazenado usado para classificar dados recuperados quando a recuperação de dados é executada usando um procedimento armazenado. |
| SqlCacheDependency |
Obtém ou define uma cadeia de caracteres delimitada por ponto-e-vírgula que indica quais bancos de dados e tabelas usar para a dependência de cache do Microsoft SQL Server. |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control) |
| UniqueID |
Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control) |
| UpdateCommand |
Obtém ou define a cadeia de caracteres SQL que o SqlDataSource controle usa para atualizar dados no banco de dados subjacente. |
| UpdateCommandType |
Obtém ou define um valor que indica se o texto na UpdateCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado. |
| UpdateParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade do UpdateCommandSqlDataSourceView controle associado ao SqlDataSource controle. |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor que indica se o controle é exibido visualmente. (Herdado de DataSourceControl) |
Métodos
| Nome | Description |
|---|---|
| AddedControl(Control, Int32) |
Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor armazenado em ClientID cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle do servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria uma coleção para armazenar controles filho. (Herdado de DataSourceControl) |
| CreateDataSourceView(String) |
Cria um objeto de exibição de fonte de dados associado ao controle da fonte de dados. |
| DataBind() |
Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| Delete() |
Executa uma operação de exclusão usando a DeleteCommand cadeia de caracteres SQL e todos os parâmetros que estão na DeleteParameters coleção. |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String, Int32) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado |
| FindControl(String) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada para o controle. (Herdado de DataSourceControl) |
| GetDbProviderFactory() |
Retorna o DbProviderFactory objeto associado ao provedor de ADO.NET que é identificado pela ProviderName propriedade. |
| GetDesignModeState() |
Obtém dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control) |
| GetView(String) |
Obtém a exibição de fonte de dados nomeada associada ao controle da fonte de dados. |
| GetViewNames() |
Obtém uma coleção de nomes que representa a lista de objetos de exibição associados ao SqlDataSource controle. |
| HasControls() |
Determina se o controle do servidor contém controles filho. (Herdado de DataSourceControl) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control) |
| Insert() |
Executa uma operação de inserção usando a InsertCommand cadeia de caracteres SQL e todos os parâmetros que estão na InsertParameters coleção. |
| IsLiteralContent() |
Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método. (Herdado de Control) |
| LoadViewState(Object) |
Carrega o estado das propriedades no SqlDataSource controle que precisam ser persistentes. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Adiciona um LoadComplete manipulador de eventos ao Page controle que contém o SqlDataSource controle. |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de Control) |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Aciona o evento DataSourceChanged. (Herdado de DataSourceControl) |
| RemovedControl(Control) |
Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia o conteúdo do controle do servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de DataSourceControl) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que é utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Salva o estado de exibição atual do SqlDataSource controle. |
| Select(DataSourceSelectArguments) |
Recupera dados do banco de dados subjacente usando a SelectCommand cadeia de caracteres SQL e todos os parâmetros que estão na SelectParameters coleção. |
| SetDesignModeState(IDictionary) |
Define dados de tempo de design para um controle. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Controla as alterações de estado de exibição no SqlDataSource controle para que as alterações possam ser armazenadas no StateBag objeto do controle. |
| Update() |
Executa uma operação de atualização usando a UpdateCommand cadeia de caracteres SQL e todos os parâmetros que estão na UpdateParameters coleção. |
Eventos
| Nome | Description |
|---|---|
| DataBinding |
Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control) |
| Deleted |
Ocorre quando uma operação de exclusão é concluída. |
| Deleting |
Ocorre antes de uma operação de exclusão. |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Filtering |
Ocorre antes de uma operação de filtro. |
| Init |
Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control) |
| Inserted |
Ocorre quando uma operação de inserção é concluída. |
| Inserting |
Ocorre antes de uma operação de inserção. |
| Load |
Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control) |
| PreRender |
Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control) |
| Selected |
Ocorre quando uma operação de recuperação de dados é concluída. |
| Selecting |
Ocorre antes de uma operação de recuperação de dados. |
| Unload |
Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control) |
| Updated |
Ocorre quando uma operação de atualização é concluída. |
| Updating |
Ocorre antes de uma operação de atualização. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição deste membro, consulte UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control) |
| IDataSource.DataSourceChanged |
Ocorre quando um controle da fonte de dados é alterado de uma maneira que afeta controles associados a dados. (Herdado de DataSourceControl) |
| IDataSource.GetView(String) |
Obtém o objeto nomeado DataSourceView associado ao DataSourceControl controle. Alguns controles de fonte de dados dão suporte a apenas uma exibição, enquanto outros dão suporte a mais de uma. (Herdado de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtém uma coleção de nomes, representando a lista de DataSourceView objetos associados ao DataSourceControl controle. (Herdado de DataSourceControl) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control) |
| IListSource.ContainsListCollection |
Indica se o controle da fonte de dados está associado a uma ou mais listas de dados. (Herdado de DataSourceControl) |
| IListSource.GetList() |
Obtém uma lista de controles de fonte de dados que podem ser usados como fontes de listas de dados. (Herdado de DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| Nome | Description |
|---|---|
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados para o controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatável para o controle de dados que contém. |
| GetDefaultValues(IDataSource) |
Obtém a coleção dos valores padrão para a fonte de dados especificada. |
| GetMetaTable(IDataSource) |
Obtém os metadados de uma tabela no objeto de fonte de dados especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
