AccessDataSource 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 do Microsoft Access para uso com controles associados a dados.
public ref class AccessDataSource : System::Web::UI::WebControls::SqlDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.AccessDataSource))]
public class AccessDataSource : System.Web.UI.WebControls.SqlDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.AccessDataSource))>]
type AccessDataSource = class
inherit SqlDataSource
Public Class AccessDataSource
Inherits SqlDataSource
- Herança
- Atributos
Exemplos
O exemplo de código a seguir demonstra um cenário comum de exibição e atualização com o controle GridView. A propriedade SelectCommand é definida como uma consulta SQL apropriada e os dados do banco de dados Northwind são exibidos no controle GridView. Como uma propriedade UpdateCommand também é especificada e a propriedade AutoGenerateEditButton está definida como true
, você pode editar e atualizar os registros sem código adicional. O controle GridView manipula a adição de parâmetros à coleção UpdateParameters; o controle GridView passa os valores de parâmetro para os objetos BoundField primeiro, seguidos pelos valores de campos especificados pela propriedade DataKeyNames. O GridView chama o método Update automaticamente. Se você quiser ordenar os parâmetros, especifique explicitamente uma coleção UpdateParameters no AccessDataSource.
<%@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:accessdatasource
id="AccessDataSource1"
runat="server"
datasourcemode="DataSet"
datafile="~/App_Data/Northwind.mdb"
selectcommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
updatecommand="Update Employees SET FirstName=?,LastName=?,Title=? WHERE EmployeeID=@EmployeeID">
</asp:accessdatasource>
<asp:gridview
id="GridView1"
runat="server"
autogeneratecolumns="False"
datakeynames="EmployeeID"
autogenerateeditbutton="True"
datasourceid="AccessDataSource1">
<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:accessdatasource
id="AccessDataSource1"
runat="server"
datasourcemode="DataSet"
datafile="~/App_Data/Northwind.mdb"
selectcommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
updatecommand="Update Employees SET FirstName=?,LastName=?,Title=? WHERE EmployeeID=@EmployeeID">
</asp:accessdatasource>
<asp:gridview
id="GridView1"
runat="server"
autogeneratecolumns="False"
datakeynames="EmployeeID"
autogenerateeditbutton="True"
datasourceid="AccessDataSource1">
<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>
Comentários
A classe AccessDataSource é um controle de fonte de dados que funciona com bancos de dados do Microsoft Access. Assim como sua classe base, SqlDataSource, o controle AccessDataSource usa consultas SQL para executar a recuperação de dados.
Uma das características exclusivas do controle AccessDataSource é que você não define a propriedade ConnectionString. Tudo o que você precisa fazer é definir o local do arquivo access (.mdb) na propriedade DataFile e o AccessDataSource cuida da conexão subjacente com o banco de dados. Você deve colocar bancos de dados do Access no diretório App_Data do site e referenciá-los por um caminho relativo (por exemplo, ~/App_Data/Northwind.mdb
). Esse local oferece segurança adicional para arquivos de dados, pois eles não serão atendidos se forem solicitados diretamente pelo navegador da Web do cliente.
A classe AccessDataSource não dá suporte à conexão com bancos de dados do Access protegidos por um nome de usuário ou senha, pois você não pode definir a propriedade ConnectionString. Se o banco de dados do Access estiver protegido por um nome de usuário ou senha, use o controle SqlDataSource para se conectar a ele para que você possa especificar uma cadeia de conexão completa.
Você associa controles associados a dados a um AccessDataSource usando a propriedade DataSourceID
do controle associado a dados. Para obter mais informações sobre como associar um controle associado a dados a controles de fonte de dados, consulte Associação a dados usando um controle da fonte de dados.
Como o controle AccessDataSource é específico para apenas um produto de banco de dados, ele sempre usa o mesmo provedor - o provedor de dados .NET System.Data.OleDb. Por esse motivo, a propriedade ProviderName é somente leitura. Ao usar o provedor de System.Data.OleDb, a ordem dos parâmetros em uma instrução SQL parametrizada é significativa; as consultas SQL parametrizadas especificadas nas propriedades SelectCommand, UpdateCommand, InsertCommande DeleteCommand devem corresponder à ordem de qualquer objeto Parameter que estejam na coleção de parâmetros correspondente. Se nenhuma coleção de parâmetros for especificada no AccessDataSource, a ordem dos parâmetros fornecidos para essas operações deverá corresponder à ordem na qual elas aparecem na instrução SQL subjacente. Para obter mais informações, consulte Usando parâmetros com o controle SqlDataSource.
O controle AccessDataSource dá suporte ao mesmo comportamento de cache que sua classe base dá suporte. Use o cache para aumentar o desempenho das páginas que usam o controle AccessDataSource. Para obter mais informações sobre o cache da fonte de dados, consulte Armazenar dados em cache usando controles de fonte de dados.
A tabela a seguir descreve os recursos do controle AccessDataSource.
Capacidade | Requisitos |
---|---|
Classificação | Defina a propriedade DataSourceMode com o valor DataSet. |
Filtragem | Defina a propriedade FilterExpression como uma expressão de filtragem usada para filtrar os dados quando o método Select for chamado. |
Paginação | O AccessDataSource não dá suporte a operações de paginação diretas em um banco de dados do Access. Um controle associado a dados, como o GridView, poderá passar a página sobre os itens retornados pelo AccessDataSource, se a propriedade DataSourceMode estiver definida como o valor DataSet. |
Atualização | Defina a propriedade UpdateCommand como uma instrução SQL usada para atualizar dados. Essa instrução normalmente é parametrizada. |
Emendar | Defina a propriedade DeleteCommand como uma instrução SQL usada para excluir dados. Essa instrução normalmente é parametrizada. |
Inserir | Defina a propriedade InsertCommand como uma instrução SQL usada para inserir dados. Essa instrução normalmente é parametrizada. |
Cache | Defina a propriedade DataSourceMode como o valor DataSet, a propriedade EnableCaching para true e as propriedades CacheDuration e CacheExpirationPolicy de acordo com o comportamento de cache desejado para seus dados armazenados em cache. |
Assim como acontece com todos os controles de fonte de dados, o controle AccessDataSource está associado a uma classe de exibição de fonte de dados fortemente tipada. Assim como o controle AccessDataSource estende o controle SqlDataSource, a classe AccessDataSourceView estende a classe SqlDataSourceView. A classe AccessDataSourceView substitui alguns dos métodos SqlDataSourceView para usar o provedor de dados .NET System.Data.OleDb.
Não há nenhuma renderização visual do controle AccessDataSource; é implementado como um controle para habilitar a persistência declarativa e permitir, opcionalmente, a participação no gerenciamento de estado. Como resultado, você não pode definir propriedades que dão suporte a recursos visuais, como as propriedades EnableTheming e SkinID.
Sintaxe declarativa
<asp:AccessDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
CancelSelectOnNullParameter="True|False"
ConflictDetection="OverwriteChanges|CompareAllValues"
DataFile="uri"
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"
runat="server"
SelectCommand="string"
SelectCommandType="Text|StoredProcedure"
SkinID="string"
SortParameterName="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:AccessDataSource>
Construtores
AccessDataSource() |
Inicializa uma nova instância da classe AccessDataSource. |
AccessDataSource(String, String) |
Inicializa uma nova instância da classe AccessDataSource com o caminho do arquivo de dados especificado e comando Selecionar. |
Propriedades
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 objeto Page 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 método Select(DataSourceSelectArguments). (Herdado de SqlDataSource) |
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. (Herdado de SqlDataSource) |
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. (Herdado de SqlDataSource) |
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 coleção SelectParameters é 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 propriedade ClientID. (Herdado de Control) |
ConflictDetection |
Obtém ou define o valor que indica como o controle SqlDataSource executa atualizações e exclui quando os dados em uma linha no banco de dados subjacente são alterados durante o tempo da operação. (Herdado de SqlDataSource) |
ConnectionString |
Obtém a cadeia de conexão usada para se conectar ao banco de dados do Microsoft Access. |
Context |
Obtém o objeto HttpContext associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control) |
Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de DataSourceControl) |
DataFile |
Obtém ou define o local do arquivo de .mdb do Microsoft Access. |
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 controle SqlDataSource usa para buscar dados. (Herdado de SqlDataSource) |
DeleteCommand |
Obtém ou define a cadeia de caracteres SQL que o controle SqlDataSource usa para excluir dados do banco de dados subjacente. (Herdado de SqlDataSource) |
DeleteCommandType |
Obtém ou define um valor que indica se o texto na propriedade DeleteCommand é uma instrução SQL ou o nome de um procedimento armazenado. (Herdado de SqlDataSource) |
DeleteParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade DeleteCommand do objeto SqlDataSourceView associado ao controle SqlDataSource. (Herdado de SqlDataSource) |
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 SqlDataSource tem o cache de dados habilitado. (Herdado de SqlDataSource) |
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. Essa propriedade é somente leitura. (Herdado de Control) |
FilterExpression |
Obtém ou define uma expressão de filtragem que é aplicada quando o método Select(DataSourceSelectArguments) é chamado. (Herdado de SqlDataSource) |
FilterParameters |
Obtém uma coleção de parâmetros associados a quaisquer espaços reservados de parâmetro que estejam na cadeia de caracteres FilterExpression. (Herdado de SqlDataSource) |
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 controle SqlDataSource usa para inserir dados no banco de dados subjacente. (Herdado de SqlDataSource) |
InsertCommandType |
Obtém ou define um valor que indica se o texto na propriedade InsertCommand é uma instrução SQL ou o nome de um procedimento armazenado. (Herdado de SqlDataSource) |
InsertParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade InsertCommand do objeto SqlDataSourceView associado ao controle SqlDataSource. (Herdado de SqlDataSource) |
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 valor de propriedade ID. (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 Delete() ou Update(). (Herdado de SqlDataSource) |
Page |
Obtém uma referência à instância de Page 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 o nome do provedor de dados .NET que o controle AccessDataSource usa para se conectar a um banco de dados do Microsoft Access. |
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 controle SqlDataSource usa para recuperar dados do banco de dados subjacente. (Herdado de SqlDataSource) |
SelectCommandType |
Obtém ou define um valor que indica se o texto na propriedade SelectCommand é uma consulta SQL ou o nome de um procedimento armazenado. (Herdado de SqlDataSource) |
SelectParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade SelectCommand do objeto SqlDataSourceView associado ao controle SqlDataSource. (Herdado de SqlDataSource) |
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 controle DataSourceControl. (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. (Herdado de SqlDataSource) |
SqlCacheDependency |
A propriedade SqlCacheDependency substitui a propriedade SqlCacheDependency. |
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 do 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 controle SqlDataSource usa para atualizar dados no banco de dados subjacente. (Herdado de SqlDataSource) |
UpdateCommandType |
Obtém ou define um valor que indica se o texto na propriedade UpdateCommand é uma instrução SQL ou o nome de um procedimento armazenado. (Herdado de SqlDataSource) |
UpdateParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade UpdateCommand do controle SqlDataSourceView associado ao controle SqlDataSource. (Herdado de SqlDataSource) |
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 objeto StateBag 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
AddedControl(Control, Int32) |
Chamado depois que um controle filho é adicionado à coleção Controls do objeto Control. (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 ControlCollection do controle do 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 entrega à propriedade Trace a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control) |
ClearCachedClientID() |
Define o valor de ClientID armazenado em 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 propriedade ClientIDMode da instância de controle atual e de qualquer controle filho para 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 evento DataBinding. (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 cadeia de caracteres SQL DeleteCommand e todos os parâmetros que estão na coleção DeleteParameters. (Herdado de SqlDataSource) |
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 |
FindControl(String) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro |
Focus() |
Define o foco de entrada para o controle. (Herdado de DataSourceControl) |
GetDbProviderFactory() |
Recupera um objeto DbProviderFactory associado ao provedor de dados .NET identificado pela propriedade ProviderName. |
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 propriedade UniqueID 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. (Herdado de SqlDataSource) |
GetViewNames() |
Obtém uma coleção de nomes que representa a lista de objetos de exibição associados ao controle SqlDataSource. (Herdado de SqlDataSource) |
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 cadeia de caracteres SQL InsertCommand e todos os parâmetros que estão na coleção InsertParameters. (Herdado de SqlDataSource) |
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 método SaveControlState(). (Herdado de Control) |
LoadViewState(Object) |
Carrega o estado das propriedades no controle SqlDataSource que precisam ser persistentes. (Herdado de SqlDataSource) |
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) |
Gera o evento DataBinding. (Herdado de Control) |
OnInit(EventArgs) |
Adiciona um manipulador de eventos LoadComplete ao controle Page que contém o controle SqlDataSource. (Herdado de SqlDataSource) |
OnLoad(EventArgs) |
Gera o evento Load. (Herdado de Control) |
OnPreRender(EventArgs) |
Gera o evento PreRender. (Herdado de Control) |
OnUnload(EventArgs) |
Gera 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) |
Gera o evento DataSourceChanged. (Herdado de DataSourceControl) |
RemovedControl(Control) |
Chamado depois que um controle filho é removido da coleção Controls do objeto Control. (Herdado de Control) |
Render(HtmlTextWriter) |
Envia o conteúdo do controle do servidor para um objeto HtmlTextWriter fornecido, 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 HtmlTextWriter fornecido, 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 HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
RenderControl(HtmlTextWriter) |
O servidor de saída controla o conteúdo para um objeto HtmlTextWriter fornecido 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 controle SqlDataSource. (Herdado de SqlDataSource) |
Select(DataSourceSelectArguments) |
Recupera dados do banco de dados subjacente usando a cadeia de caracteres SQL SelectCommand e quaisquer parâmetros que estejam na coleção SelectParameters. (Herdado de SqlDataSource) |
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 controle SqlDataSource para que as alterações possam ser armazenadas no objeto StateBag para o controle. (Herdado de SqlDataSource) |
Update() |
Executa uma operação de atualização usando a cadeia de caracteres SQL UpdateCommand e todos os parâmetros que estão na coleção UpdateParameters. (Herdado de SqlDataSource) |
Eventos
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. (Herdado de SqlDataSource) |
Deleting |
Ocorre antes de uma operação de exclusão. (Herdado de SqlDataSource) |
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. (Herdado de SqlDataSource) |
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. (Herdado de SqlDataSource) |
Inserting |
Ocorre antes de uma operação de inserção. (Herdado de SqlDataSource) |
Load |
Ocorre quando o controle do servidor é carregado no objeto Page. (Herdado de Control) |
PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
Selected |
Ocorre quando uma operação de recuperação de dados é concluída. (Herdado de SqlDataSource) |
Selecting |
Ocorre antes de uma operação de recuperação de dados. (Herdado de SqlDataSource) |
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. (Herdado de SqlDataSource) |
Updating |
Ocorre antes de uma operação de atualização. (Herdado de SqlDataSource) |
Implantações explícitas de interface
IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, consulte ControlBuilder. (Herdado de Control) |
IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, consulte GetDesignModeState(). (Herdado de Control) |
IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, consulte SetDesignModeState(IDictionary). (Herdado de Control) |
IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, consulte SetOwnerControl(Control). (Herdado de Control) |
IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, consulte UserData. (Herdado de Control) |
IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, consulte DataBindings. (Herdado de Control) |
IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse 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 DataSourceView nomeado associado ao controle DataSourceControl. 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 objetos DataSourceView associados ao controle DataSourceControl. (Herdado de DataSourceControl) |
IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, consulte Expressions. (Herdado de Control) |
IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse 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 desse membro, consulte AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
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. |
Aplica-se a
Confira também
- SqlDataSource
- Parameter
- System.Data.OleDb
- controles do servidor Web de fonte de dados