SqlDataSource Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma base de dados SQL para controlos vinculados 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 secção contém quatro exemplos de código:
O primeiro exemplo de código demonstra como mostrar dados de SQL Server num controlo GridView usando sintaxe declarativa.
O segundo exemplo de código demonstra como mostrar dados de uma base de dados compatível com ODBC num GridView controlo usando sintaxe declarativa.
O terceiro exemplo de código demonstra como mostrar e atualizar dados num GridView controlo.
O quarto exemplo de código demonstra como mostrar e atualizar dados num DropDownList controlo.
Note
Estes exemplos mostram como usar a sintaxe declarativa para o acesso a dados. Para informações sobre como aceder a dados usando código em vez de marcação, veja Aceder a dados em Visual Studio.
O exemplo de código seguinte demonstra como usar um controlo SqlDataSource de forma declarativa para recuperar dados de SQL Server e exibi-los num controlo GridView.
<%@ 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 seguinte demonstra como usar um SqlDataSource controlo de forma declarativa para recuperar dados de uma base de dados compatível com ODBC e exibi-los num GridView controlo. A propriedade ProviderName é o nome da Data Provider 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 seguinte exemplo de código demonstra um cenário comum de visualização e atualização com o GridView controlo. Tal como nos exemplos anteriores, os dados da base de dados Northwind são exibidos no GridView controlo. Além disso, porque uma UpdateCommand propriedade está especificada e a AutoGenerateEditButton propriedade está definida para true, pode editar e atualizar os registos sem código adicional. O GridView controlo gere automaticamente a adição de parâmetros à UpdateParameters coleção e chama o Update método quando o botão Atualizar no GridView controlo é 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 seguinte demonstra um cenário comum de exibição e atualização com os DropDownList controlos e.TextBox O DropDownList controlo não adiciona automaticamente parâmetros de atualização à UpdateParameters coleção nem chama o Update método, por isso deve fazê-lo. Os parâmetros de atualização são especificados de forma declarativa e pode adicionar um gestor de eventos para realizar a Update operação quando um evento é levantado.
Important
Este exemplo inclui uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
<%@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>
Observações
Neste tópico:
Introduction
O SqlDataSource controlo de fonte de dados representa dados numa base de dados relacional SQL para controlos ligados a dados. Pode usar o SqlDataSource controlo em conjunto com um controlo encadernado por dados para recuperar dados de uma base de dados relacional e para exibir, editar e ordenar dados numa página Web com pouco ou nenhum código.
Ligações de Dados
Para se ligar a uma base de dados, deve definir a propriedade ConnectionString para um cadeia de ligação válido. O SqlDataSource pode suportar qualquer base de dados relacional SQL que possa ser ligada através de um fornecedor ADO.NET, como o fornecedor SqlClient, OleDb, Odbc ou OracleClient. Para informações sobre como proteger cadeias de ligação, veja Como: Strings de Ligação Segura ao Usar Controlos de Fonte de Dados.
Para recuperar dados de uma base de dados subjacente, defina a SelectCommand propriedade com uma consulta SQL. Se a base de dados a que SqlDataSource está associada suportar procedimentos armazenados, pode definir a SelectCommand propriedade para o nome de um procedimento armazenado. A consulta SQL que especificas também pode ser uma consulta parametrizada. Pode adicionar Parameter objetos associados a uma consulta parametrizada à SelectParameters coleção. Para mais informações sobre consultas SQL parametrizadas e a sua sintaxe, consulte Utilização de Parâmetros com Controlo de Fonte de Dados para Filtragem.
O SqlDataSource controlo recupera dados sempre que o Select método é chamado. Este método fornece acesso programático ao método especificado pela SelectMethod propriedade. O Select método é automaticamente chamado por controlos que estão ligados ao SqlDataSource quando o seu DataBind método é chamado. Se definir a DataSourceID propriedade de um controlo data-bound, o controlo vincula-se automaticamente aos dados da fonte de dados, conforme necessário. Definir a DataSourceID propriedade é o método recomendado para ligar um ObjectDataSource controlo a um controlo ligado a dados. Alternativamente, pode usar a DataSource propriedade, mas depois deve chamar explicitamente o DataBind método do controlo data-bound. Alguns exemplos de controlos ligados a dados que podem usar SqlDataSource são DataGrid, DetailsView, DataList, e DropDownList. Pode chamar o Select método programaticamente a qualquer momento para recuperar dados da base de dados subjacente.
Em cenários declarativos e programáticos ASP.NET, pode definir a propriedade DataSourceID do controlo data-bound para o ID do controlo SqlDataSource. Também pode atribuir uma instância da SqlDataSource classe à DataSource propriedade do controlo data-bound. Para mais informações sobre ligar controlo de dados vinculado a controlos de fonte de dados, veja ASP.NET Opções de Acesso a Dados.
Realização de Operações de Dados
Dependendo das capacidades do produto de base de dados subjacente e da configuração da instância da SqlDataSource classe, pode realizar operações de dados, como atualizações, inserções e eliminações. Para realizar estas operações de dados, defina o texto do comando apropriado e quaisquer parâmetros associados para a operação que pretende realizar. Por exemplo, para uma operação de atualização, defina a UpdateCommand propriedade para uma string SQL ou o nome de um procedimento armazenado e adicione quaisquer parâmetros necessários à UpdateParameters coleção. A atualização é realizada quando o Update método é chamado, seja explicitamente pelo seu código ou automaticamente por um controlo ligado a dados. Segue-se o mesmo padrão geral para Delete as operações e Insert and.
As consultas e comandos SQL que usas nas SelectCommandpropriedades , UpdateCommand, InsertCommand, e DeleteCommand podem ser parametrizados. Isto significa que a consulta ou comando pode usar marcadores de posição em vez de valores literais e vincular esses marcadores a variáveis definidas pela aplicação ou pelo utilizador. Pode associar parâmetros em consultas SQL a variáveis de Sessão, valores que são passados na string de consulta de uma página Web Forms, valores de propriedades de outros controlos de servidor, e mais. Para mais informações sobre como usar parâmetros em consultas SQL com o SqlDataSource, veja Utilização de Parâmetros com Controlo de Fonte de Dados para Filtragem e Utilização de Parâmetros com o Controlo SqlDataSource.
Note
Por defeito, se um dos parâmetros for null quando executas um Select comando, nenhum dado será devolvido nem será lançada nenhuma exceção. Pode alterar este comportamento definindo a CancelSelectOnNullParameter propriedade para false.
Provedor de dados
Por defeito, o controlo SqlDataSource funciona com o Data Provider do .NET Framework para SQL Server, mas SqlDataSource não é específico de Microsoft SQL Server. Pode ligar o controlo SqlDataSource a qualquer produto de base de dados para o qual exista um fornecedor de ADO.NET gerido. Quando usado com o System.Data.OleDb fornecedor, pode SqlDataSource funcionar com qualquer base de dados compatível com OLE DB. Quando usado com o System.Data.Odbc fornecedor, pode SqlDataSource ser usado com qualquer driver e base de dados ODBC, incluindo IBM DB2, MySQL e PostgreSQL. Quando usado com o System.Data.OracleClient fornecedor, pode SqlDataSource funcionar com bases de dados Oracle 8.1.7 e posteriores. A lista de fornecedores permitidos está registada na DbProviderFactories secção do ficheiro de configuração, seja no ficheiro Machine.config ou Web.config. Para mais informações, consulte Seleção de Dados Usando o Controlo SqlDataSource.
Caching
Se mostrar dados na sua página usando um SqlDataSource controlo, pode aumentar o desempenho da página utilizando as capacidades de cache de dados do controlo de código-fonte de dados. A cache reduz a carga de processamento nos servidores de base de dados à custa da memória no servidor Web; Na maioria dos casos, esta é uma boa troca. O SqlDataSource cache automaticamente armazena dados quando a EnableCaching propriedade é definida como true e a CacheDuration propriedade é definida para o número de segundos em que a cache armazena dados antes de a entrada da cache ser descartada. Também pode especificar um CacheExpirationPolicy valor e um valor opcional SqlCacheDependency .
Funcionalidades Adicionais
Fornece SqlDataSource capacidades adicionais, conforme listado na tabela seguinte.
| Capability | Requirements |
|---|---|
| Caching | Defina a DataSourceMode propriedade para o DataSet valor, a EnableCaching propriedade para true, e as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache que pretende para os seus dados em cache. |
| Apagar | Defina a DeleteCommand propriedade para uma instrução SQL usada para eliminar dados. Esta afirmação é tipicamente parametrizada. |
| Filtragem | Defina a DataSourceMode propriedade para o DataSet valor. Defina a FilterExpression propriedade para uma expressão de filtragem usada para filtrar os dados quando o Select método é chamado. |
| Inserção | Defina a InsertCommand propriedade para uma instrução SQL usada para inserir dados. Esta afirmação é tipicamente parametrizada. |
| Paging | Atualmente não é suportado pelo SqlDataSource, no entanto, alguns controlos data-bound, como GridView, suportam paginação quando se define a DataSourceMode propriedade para o DataSet valor. |
| Seleção | Defina a SelectCommand propriedade como uma instrução SQL usada para recuperar dados. |
| Ordenação | Defina a propriedade DataSourceMode como DataSet. |
| Atualização | Defina a UpdateCommand propriedade para uma instrução SQL usada para atualizar dados. Esta afirmação é tipicamente parametrizada. |
Vista da Fonte de Dados
Como em todos os controlos de fonte de dados, o controlo SqlDataSource está associado a uma classe de vista de fonte de dados. O SqlDataSource controlo tem apenas um associado SqlDataSourceView, e é sempre chamado Table.
Não existe uma representação visual do SqlDataSource controlo; é implementado como um controlo para que possa criá-lo declarativamente e, opcionalmente, para permitir que participe na gestão do estado. Como resultado, o SqlDataSource não suporta características visuais, como as fornecidas pela EnableTheming propriedade ou.SkinID
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
| Name | Description |
|---|---|
| SqlDataSource() |
Inicializa uma nova instância da SqlDataSource classe. |
| SqlDataSource(String, String, String) |
Inicializa uma nova instância da classe SqlDataSource com o comando cadeia de ligação e Select especificados. |
| SqlDataSource(String, String) |
Inicializa uma nova instância da classe SqlDataSource com o comando cadeia de ligação e Select especificados. |
Propriedades
| Name | Description |
|---|---|
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| CacheDuration |
Obtém ou define o tempo, em segundos, que o controlo de fonte de dados armazena em cache os dados que são recuperados pelo Select(DataSourceSelectArguments) método. |
| CacheExpirationPolicy |
Obtém ou define o comportamento de expiração da cache que, quando combinado com a duração, descreve o comportamento da cache que o controlo de fonte de dados utiliza. |
| CacheKeyDependency |
Obtém ou define uma dependência de chave definida pelo utilizador que está ligada a todos os objetos de cache de dados criados pelo controlo de fonte de dados. Todos os objetos de cache ficam explicitamente expirados quando a chave expira. |
| 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 avalia para |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o identificador de controlo do servidor gerado pelo ASP.NET. (Herdado de DataSourceControl) |
| ClientIDMode |
Esta propriedade não é usada para controlos de fonte de dados. (Herdado de DataSourceControl) |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| ConflictDetection |
Recebe ou define o valor que indica como o controlo SqlDataSource realiza atualizações e eliminações quando dados numa linha na base de dados subjacente mudam durante o tempo da operação. |
| ConnectionString |
Obtém ou define a cadeia de ligação específica do fornecedor ADO.NET que o controlo SqlDataSource usa para se ligar a uma base de dados subjacente. |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de DataSourceControl) |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataSourceMode |
Obtém ou define o modo de recuperação de dados que o SqlDataSource controlo usa para obter dados. |
| DeleteCommand |
Obtém ou define a string SQL que o SqlDataSource controlo usa para eliminar dados da base de dados subjacente. |
| DeleteCommandType |
Recebe 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 controlo. |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| EnableCaching |
Recebe ou define um valor que indica se o controlo SqlDataSource tem a cache de dados ativada. |
| EnableTheming |
Recebe um valor que indica se este controlo suporta temas. (Herdado de DataSourceControl) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| FilterExpression |
Recebe 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 marcadores de parâmetros que estejam na FilterExpression string. |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| InsertCommand |
Obtém ou define a string SQL que o SqlDataSource controlo usa para inserir dados na base de dados subjacente. |
| InsertCommandType |
Recebe 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 controlo. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| OldValuesParameterFormatString |
Obtém ou define uma cadeia de formatos para aplicar aos nomes de quaisquer parâmetros que sejam passados ao Delete() método ou.Update() |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| ProviderName |
Obtém ou define o nome do fornecedor de dados .NET Framework que o controlo SqlDataSource usa para se ligar a uma fonte de dados subjacente. |
| RenderingCompatibility |
Recebe 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 string SQL que o SqlDataSource controlo usa para recuperar dados da base de dados subjacente. |
| SelectCommandType |
Recebe 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 controlo. |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Faz com que a pele se aplique ao DataSourceControl controlo. (Herdado de DataSourceControl) |
| SortParameterName |
Recebe ou define o nome de um parâmetro de procedimento armazenado que é usado para ordenar os dados recuperados quando a recuperação de dados é realizada usando um procedimento armazenado. |
| SqlCacheDependency |
Obtém ou define uma cadeia delimitada por ponto e vírgula que indica quais bases de dados e tabelas usar para a dependência da cache do Microsoft SQL Server. |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| UpdateCommand |
Obtém ou define a string SQL que o SqlDataSource controlo usa para atualizar dados na base de dados subjacente. |
| UpdateCommandType |
Recebe 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 UpdateCommand propriedade do SqlDataSourceView controlo associado ao SqlDataSource controlo. |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| Visible |
Recebe ou define um valor que indica se o controlo é visualmente exibido. (Herdado de DataSourceControl) |
Métodos
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria uma coleção para armazenar controlos filhos. (Herdado de DataSourceControl) |
| CreateDataSourceView(String) |
Cria um objeto de vista de fonte de dados associado ao controlo de fonte de dados. |
| DataBind() |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control) |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| Delete() |
Realiza uma operação de eliminação usando a DeleteCommand string SQL e quaisquer parâmetros que estejam na DeleteParameters coleção. |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controlos 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 no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada no controlo. (Herdado de DataSourceControl) |
| GetDbProviderFactory() |
Devolve o objeto DbProviderFactory que está associado ao fornecedor ADO.NET identificado pela propriedade ProviderName. |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetHashCode() |
Serve como função de hash predefinida. (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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| GetView(String) |
Obtém a vista da fonte de dados nomeada associada ao controlo de fonte de dados. |
| GetViewNames() |
Obtém uma coleção de nomes que representam a lista de objetos de vista associados ao SqlDataSource controlo. |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de DataSourceControl) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| Insert() |
Executa uma operação de inserção usando a InsertCommand string SQL e quaisquer parâmetros que estejam na InsertParameters coleção. |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control) |
| LoadViewState(Object) |
Carrega o estado das propriedades no SqlDataSource controlo que precisam de ser mantidas. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Eleva o DataBinding evento. (Herdado de Control) |
| OnInit(EventArgs) |
Adiciona um LoadComplete gestor de eventos ao Page controlo que contém o SqlDataSource controlo. |
| OnLoad(EventArgs) |
Eleva o Load evento. (Herdado de Control) |
| OnPreRender(EventArgs) |
Eleva o PreRender evento. (Herdado de Control) |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Eleva o DataSourceChanged evento. (Herdado de DataSourceControl) |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de DataSourceControl) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Guarda o estado atual de visualização do SqlDataSource controlo. |
| Select(DataSourceSelectArguments) |
Recupera dados da base de dados subjacente usando a SelectCommand string SQL e quaisquer parâmetros que estejam na SelectParameters coleção. |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Acompanha as alterações no estado da vista do SqlDataSource controlo para que as alterações possam ser armazenadas no StateBag objeto do controlo. |
| Update() |
Realiza uma operação de atualização usando a UpdateCommand string SQL e quaisquer parâmetros que estejam na UpdateParameters coleção. |
evento
| Name | Description |
|---|---|
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| Deleted |
Ocorre quando uma operação de eliminação foi concluída. |
| Deleting |
Ocorre antes de uma operação de eliminação. |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Filtering |
Ocorre antes de uma operação de filtragem. |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| Inserted |
Ocorre quando uma operação de inserção foi concluída. |
| Inserting |
Ocorre antes de uma operação de inserção. |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| Selected |
Ocorre quando uma operação de recuperação de dados foi concluída. |
| Selecting |
Ocorre antes de uma operação de recuperação de dados. |
| Unload |
Ocorre quando o controlo 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. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para uma descrição deste elemento, veja UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para uma descrição deste elemento, veja DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control) |
| IDataSource.DataSourceChanged |
Ocorre quando um controlo de fonte de dados mudou de forma a afetar os controlos vinculados aos dados. (Herdado de DataSourceControl) |
| IDataSource.GetView(String) |
Obtém o objeto nomeado DataSourceView associado ao DataSourceControl controlo. Alguns controlos de fonte de dados suportam apenas uma vista, enquanto outros suportam mais do que uma. (Herdado de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtém uma coleção de nomes, representando a lista de DataSourceView objetos associados ao DataSourceControl controlo. (Herdado de DataSourceControl) |
| IExpressionsAccessor.Expressions |
Para uma descrição deste elemento, veja Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control) |
| IListSource.ContainsListCollection |
Indica se o controlo de fonte de dados está associado a uma ou mais listas de dados. (Herdado de DataSourceControl) |
| IListSource.GetList() |
Obtém uma lista de controlos de fonte de dados que podem ser usados como fontes de listas de dados. (Herdado de DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control) |
Métodos da Extensão
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo 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 fonte de dados especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |