Partilhar via


LinqDataSource Classe

Definição

Permite o uso do LINQ (Consulta Integrada à Linguagem) em uma página da Web do ASP.NET por meio do texto de marcação para recuperar e modificar dados de um objeto de dados.

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource
public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource
Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource
Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource
Herança
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir mostra um LinqDataSource controle que recupera dados de uma classe de entidade chamada Products. A classe de entidade poderia ter sido gerada usando o Designer O/R ou o utilitário SqlMetal.exe. A Where propriedade é definida para retornar apenas registros que têm um valor na Price propriedade maior que 50. Um GridView controle é associado ao LinqDataSource controle para exibir os dados.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

O exemplo a seguir mostra um LinqDataSource controle que permite que os usuários atualizem, excluam e insiram registros na fonte de dados. Um DetailsView controle é associado ao LinqDataSource controle e permite que os usuários vejam e modifiquem os dados. Observe que nenhum comando SQL é necessário para selecionar, atualizar, excluir ou inserir os registros.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

O exemplo a seguir mostra um manipulador de eventos para o Selecting evento que define o objeto de dados com base em um valor na página da Web.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}
Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

O exemplo a seguir mostra um LinqDataSource controle configurado para agrupar por duas colunas. A Key propriedade faz referência a um objeto que tem duas propriedades, ProductCategory e Color. O objeto representado por It é renomeado (com alias) para Products. O objeto renomeado Products contém uma coleção de registros individuais em um agrupamento. Cada instância conterá todas as colunas da Products tabela.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>
<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

O exemplo a seguir mostra dois ListView controles que exibem os dados do LinqDataSource controle no exemplo anterior. Um ListView controle exibe os dados agrupados e o outro ListView exibe os nomes individuais de produtos que pertencem a esse grupo. A propriedade do DataSource controle associado a dados aninhado é definida Productscomo , que é o alias do It objeto.

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>
<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Comentários

Neste tópico:

Introdução

Language-Integrated Query (LINQ) é uma sintaxe de consulta que define um conjunto de operadores de consulta que permitem que operações de passagem, filtro e projeção sejam expressas de maneira declarativa em qualquer . Linguagem de programação baseada em NET. O objeto de dados pode ser uma coleção de dados na memória ou um objeto que representa dados de um banco de dados. Você pode recuperar ou modificar os dados sem precisar escrever comandos SQL para cada operação.

O LinqDataSource controle permite que você use LINQ em uma página da Web ASP.NET definindo propriedades no texto de marcação. O LinqDataSource controle usa LINQ to SQL para gerar automaticamente os comandos de dados. Para obter mais informações sobre LINQ to SQL, consulte LINQ to SQL.

Ao recuperar dados de uma coleta de dados na memória, você define a ContextTypeName propriedade como a classe que contém a coleta de dados. Defina a TableName propriedade como a propriedade ou o campo que retorna a coleta de dados. Por exemplo, você pode ter uma classe chamada Person que contém uma propriedade chamada FavoriteCities que retorna uma matriz de valores de cadeia de caracteres. Nesse caso, defina a propriedade como Person e defina a TableName propriedade como FavoriteCities.ContextTypeName

Ao consultar um banco de dados, você deve primeiro criar classes de entidade que representam o banco de dados e suas tabelas. Você pode usar a Object Relational Designer ou o utilitário SqlMetal.exe para gerar essas classes. Em seguida, defina a ContextTypeName propriedade como a classe que representa o banco de dados e defina a TableName propriedade como a propriedade que representa a tabela de banco de dados.

Ordem de operações

O LinqDataSource controle aplica operações de dados na seguinte ordem:

  1. Onde (especifique quais registros de dados retornar).

  2. Ordenar por (classificar).

  3. Agrupar por (agregar registros de dados que compartilham valores).

  4. Ordenar Grupos por (classificar dados agrupados).

  5. Selecione (especifique quais campos ou propriedades retornar).

  6. Classificação automática (classificar registros de dados por uma propriedade selecionada pelo usuário).

  7. Página automática (recupere um subconjunto de registros de dados que foram selecionados pelo usuário).

Você pode adicionar condições à Where propriedade para filtrar os registros de dados retornados de uma consulta. Se a Where propriedade não estiver definida, o LinqDataSource controle recuperará todos os registros do objeto de dados.

Ordenando dados

Use a OrderBy propriedade para especificar os nomes das propriedades dos dados retornados pelos quais classificar.

Observação

Quando você usa o LinqDataSource controle com SQL Server 2000 ou SQL Server Compact 3.5 e a AutoPage propriedade é definida truecomo , você deve fornecer um valor na OrderBy propriedade . Por padrão, a AutoPage propriedade é true. Se você atribuir um valor à Select propriedade , também deverá incluir todas as colunas de identidade na lista de propriedades retornadas na consulta.

Agrupar dados

Use a GroupBy propriedade para especificar quais propriedades são usadas para consolidar registros de dados que têm os mesmos valores. Ao agrupar dados, você pode incluir Key e It, que são propriedades criadas dinamicamente, na Select propriedade . A Key propriedade refere-se aos valores na propriedade ou propriedades que foram usadas para agrupar os dados. Por exemplo, se você agrupar por uma propriedade chamada Category, a Key propriedade conterá todos os valores exclusivos na Category propriedade . A It propriedade refere-se a uma coleção de registros individuais em um agrupamento de dados. Você pode iterar sobre a It propriedade para recuperar os registros individuais que foram consolidados na operação de agrupamento. Por exemplo, se você agrupar por uma propriedade chamada Category, a It propriedade conterá todos os registros individuais que compartilham um valor comum na Category propriedade .

Use a OrderGroupsBy propriedade para especificar as propriedades a serem usadas para classificar os dados agrupados. Quando você agrupa dados, a OrderBy propriedade especifica como os registros individuais dentro dos dados agrupados são classificados.

Por padrão, o LinqDataSource controle recupera valores para todas as propriedades de um objeto de dados. Use a Select propriedade para especificar quais propriedades retornar se quiser trabalhar com um subconjunto de propriedades disponíveis. A operação Selecionar é aplicada após as operações Where, Order By e Group By. Portanto, se você criar um nome com alias em uma cláusula Select, o alias não estará disponível nas outras cláusulas.

Modificações de dados

Você pode especificar se as modificações de dados estão habilitadas usando as EnableDeletepropriedades , EnableInserte EnableUpdate . A interface do usuário para modificar dados de um LinqDataSource controle normalmente é fornecida por meio de um controle associado a dados, como um DetailsView controle . Além de definir EnableDelete, EnableInsertou EnableUpdate como true, as seguintes condições são necessárias para habilitar modificações automáticas de dados:

Você pode restringir quais propriedades são exibidas em um controle associado a dados de duas maneiras. Você pode definir a Select propriedade como um subconjunto de propriedades ou definir os campos para um controle associado a dados adicionando DataControlField controles. No entanto, se você definir a Select propriedade, isso significa que as operações automáticas de atualização, inserção e exclusão não podem ser habilitadas. Se você quiser habilitar modificações automáticas de dados enquanto trabalha com um subconjunto de propriedades disponíveis, não defina a Select propriedade . Em vez disso, recupere todas as propriedades do objeto de dados e gerencie quais são exibidas usando o controle associado a dados. Ao usar o DetailsView controle ou o GridView controle , você também deve definir as AutoGenerateRows propriedades ou AutoGenerateColumns como false. Isso impede que o controle associado a dados inclua automaticamente botões para editar e excluir os dados. Todos os valores que não são exibidos no controle associado a dados são armazenados no estado de exibição. Eles são passados inalterados para a fonte de dados quando a atualização de dados é executada.

Avaliando valores em tempo de execução

Se você precisar avaliar valores em tempo de execução para ordenar, filtrar ou agrupar valores, poderá adicionar parâmetros às WhereParameterscoleções , GroupByParametersOrderGroupsByParameters, ou OrderByParameters .

Se você quiser especificar valores padrão, poderá adicionar parâmetros à InsertParameters coleção.

Se você quiser examinar ou modificar valores antes que a operação de dados seja executada, poderá manipular os Deletingeventos , Inserting, Selectingou Updating . Você também pode manipular esses eventos para cancelar a operação de dados ou examinar erros de validação que ocorreram quando você define propriedades na classe de dados com base na entrada do usuário.

Para examinar valores após a conclusão da operação de dados, manipule os Deletedeventos , InsertedSelected, ou Updated .

Trabalhando com procedimentos armazenados

Use o LinqDataSource controle para recuperar dados de um procedimento armazenado criando um manipulador de eventos para o Selecting evento. No manipulador de eventos, você chama o método na classe de contexto de dados que representa o procedimento armazenado e define o resultado como a Result propriedade do LinqDataSourceSelectEventArgs objeto . Se você quiser habilitar operações automáticas de atualização, inserção e exclusão para os dados, o tipo retornado do método deverá corresponder ao tipo especificado na TableName propriedade . Para obter mais informações sobre como criar métodos de contexto de dados, consulte Como criar métodos DataContext mapeados para procedimentos armazenados e funções (O/R Designer).

Sintaxe declarativa

<asp:LinqDataSource  
    AutoGenerateOrderByClause="True|False"  
    AutoGenerateWhereClause="True|False"  
    AutoPage="True|False"  
    AutoSort="True|False"  
    ContextTypeName="string"  
    EnableDelete="True|False"  
    EnableInsert="True|False"  
    EnableTheming="True|False"  
    EnableUpdate="True|False"  
    EnableViewState="True|False"  
    GroupBy="string"  
    ID="string"  
    OnContextCreated="ContextCreated event handler"  
    OnContextCreating="ContextCreating event handler"  
    OnContextDisposing="ContextDisposing event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed 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"  
    OrderBy="string"  
    runat="server"  
    Select="string"  
    SkinID="string"  
    StoreOriginalValuesInViewState="True|False"  
    TableName="string"  
    Visible="True|False"  
    Where="string"  
>  
        <GroupByParameters />  
        <InsertParameters />  
        <OrderByParameters />  
        <SelectParameters />  
        <WhereParameters />  
</asp:LinqDataSource>  

Construtores

LinqDataSource()

Inicializa uma nova instância da classe LinqDataSource.

Propriedades

Adapter

Obtém o adaptador específico de navegador para o controle.

(Herdado de Control)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.

(Herdado de Control)
AutoGenerateOrderByClause

Obtém ou define um valor que indica se o controle LinqDataSource cria dinamicamente uma cláusula Order By com base nos valores na coleção OrderByParameters.

AutoGenerateWhereClause

Obtém ou define um valor que indica se o controle LinqDataSource cria dinamicamente uma cláusula Where com base nos valores na coleção WhereParameters.

AutoPage

Obtém ou define um valor que indica se o controle LinqDataSource dá suporte à navegação por meio de seções nos dados no tempo de execução.

AutoSort

Obtém ou define um valor que indica se o controle LinqDataSource dá suporte à classificação dos dados no tempo de execução.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.

(Herdado de Control)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.

(Herdado de Control)
ClientID

Obtém o identificador de controle de 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)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.

(Herdado de Control)
ContextTypeName

Obtém ou define o nome do tipo que contém a propriedade cujo valor tem os dados que você deseja recuperar.

Controls

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.

(Herdado de DataSourceControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.

(Herdado de Control)
DeleteParameters

Essa propriedade não é usada pela classe LinqDataSource.

DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
EnableDelete

Obtém ou define um valor que indica se os registros de dados podem ser excluídos por meio do controle LinqDataSource.

EnableInsert

Obtém ou define um valor que indica se os registros de dados podem ser inseridos por meio do controle LinqDataSource.

EnableObjectTracking

Obtém ou define o valor que indica se as alterações ao objeto de contexto de dados são acompanhadas.

EnableTheming

Obtém um valor que indica se esse controle dá suporte a temas.

(Herdado de DataSourceControl)
EnableUpdate

Obtém ou define um valor que indica se os registros de dados podem ser atualizados por meio do controle LinqDataSource.

EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.

(Herdado de Control)
EntitySetName

Obtém ou define o nome da propriedade ou campo no objeto de fonte de dados que representa uma coleção de dados.

(Herdado de ContextDataSource)
EntityTypeName

Obtém ou define o nome do tipo criado para uma operação de inserção, exclusão ou atualização.

(Herdado de ContextDataSource)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
GroupBy

Obtém ou define um valor que especifica quais propriedades são usadas para agrupar os dados recuperados.

GroupByParameters

Obtém a coleção de parâmetros usados para criar a cláusula Group by.

HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.

(Herdado de Control)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
InsertParameters

Obtém a coleção de parâmetros usados durante uma operação de inserção.

IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.

(Herdado de Control)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no 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 do carregamento do estado de exibição por ID em vez do índice.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.

(Herdado de Control)
OrderBy

Obtém ou define um valor que especifica quais campos são usados para ordenar os dados recuperados.

OrderByParameters

Obtém a coleção de parâmetros usados para criar a cláusula Order By.

OrderGroupsBy

Obtém ou define os campos que são usados para ordenar dados agrupados.

OrderGroupsByParameters

Obtém a coleção de parâmetros usados para criar a cláusula Order Groups By.

Page

Obtém uma referência para a instância Page que contém o controle de servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.

(Herdado de Control)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
Select

Obtém ou define as propriedades e os valores calculados que são incluídos nos dados recuperados.

SelectParameters

Obtém a coleção de parâmetros usados durante uma operação de recuperação de dados.

Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.

(Herdado de Control)
SkinID

Obtém a capa a ser aplicada ao controle DataSourceControl.

(Herdado de DataSourceControl)
StoreOriginalValuesInViewState

Obtém ou define um valor que indica se os dados da fonte de dados devem ser armazenados em estado de exibição para certificar-se de que os dados não sejam alterados por outro processo antes de serem atualizados ou excluídos.

TableName

Obtém ou define o nome da propriedade ou campo na classe de contexto de dados que representa uma coleção de dados.

TemplateControl

Obtém ou define uma referência ao modelo que contém este 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, qualificado segundo a hierarquia, para o controle de servidor.

(Herdado de Control)
UpdateParameters

Esta coleção não é usada pela classe LinqDataSource.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para 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 deste controle.

(Herdado de Control)
Visible

Obtém ou define um valor indicando se o controle é exibido visualmente.

(Herdado de DataSourceControl)
Where

Obtém ou define um valor que especifica quais condições devem ser verdadeiras para um registro ser incluído nos dados recuperados.

WhereParameters

Obtém a coleção de parâmetros usados para criar a cláusula Where.

Métodos

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.

(Herdado de Control)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.

(Herdado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de 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 de servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.

(Herdado de Control)
CreateChildControls()

Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização.

(Herdado de Control)
CreateControlCollection()

Cria uma coleção para armazenar controles filho.

(Herdado de DataSourceControl)
CreateQueryableView()

Retorna uma exibição que pode ser consultada.

CreateView()

Cria uma nova instância da classe LinqDataSourceView que está associada a este controle.

DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.

(Herdado de Control)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e 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(IDictionary, IDictionary)

Executa uma operação de exclusão.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, 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)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

(Herdado de DataSourceControl)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

(Herdado de Control)
Focus()

Define o foco de entrada para o controle.

(Herdado de DataSourceControl)
GetDesignModeState()

Obtém os 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)

Retorna a exibição da fonte de dados associada ao objeto LinqDataSource.

GetView(String)

Obtém a exibição da fonte de dados associada ao objeto QueryableDataSource.

(Herdado de QueryableDataSource)
GetViewNames()

Retorna uma coleção de nomes que representa a lista de objetos de exibição associados ao controle LinqDataSource.

GetViewNames()

Obtém uma coleção de nomes que representa exibições associadas ao controle QueryableDataSource.

(Herdado de QueryableDataSource)
HasControls()

Determina se o controle de servidor contém algum controle filho.

(Herdado de DataSourceControl)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.

(Herdado de Control)
Insert(IDictionary)

Executa uma operação de inserção.

IsLiteralContent()

Determina se o controle de servidor contém apenas o 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 dos valores no controle LinqDataSource que deve ser persistente.

LoadViewState(Object)

Carrega o estado dos valores no controle QueryableDataSource que deve ser persistente.

(Herdado de QueryableDataSource)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.

(Herdado de Control)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnInit(EventArgs)

Inicializa o objeto LinqDataSource.

OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnPreRender(EventArgs)

Aciona o evento PreRender.

(Herdado de Control)
OnUnload(EventArgs)

Aciona o evento Unload.

OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.

(Herdado de Control)
RaiseDataSourceChangedEvent(EventArgs)

Aciona o evento DataSourceChanged.

(Herdado de DataSourceControl)
RaiseViewChanged()

Chama o método OnDataSourceViewChanged(EventArgs) da classe DataSourceView.

(Herdado de QueryableDataSource)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.

(Herdado de Control)
Render(HtmlTextWriter)

Envia o conteúdo do controle de servidor a 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)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

(Herdado de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

(Herdado de Control)
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 possa ser usada no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.

(Herdado de Control)
SaveViewState()

Salva o estado de exibição atual do controle LinqDataSource.

SaveViewState()

Salva o estado de exibição atual do controle QueryableDataSource.

(Herdado de QueryableDataSource)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Acompanha as alterações de estado de exibição feitas ao controle LinqDataSource, de modo que as alterações possam ser armazenadas no objeto StateBag para o controle.

TrackViewState()

Controla as alterações de estado de exibição no controle QueryableDataSource, de modo as alterações possam ser armazenadas no objeto StateBag para o controle.

(Herdado de QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Executa uma operação de atualização.

UpdateParameterVales()

Atualiza os valores de parâmetros que foram alterados desde a solicitação anterior.

(Herdado de QueryableDataSource)

Eventos

ContextCreated

Ocorre após a criação de uma instância do objeto de tipo de contexto.

ContextCreating

Ocorre depois da criação de uma instância do objeto de tipo de contexto.

ContextDisposing

Ocorre antes de descartar o objeto de tipo de contexto.

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.

(Herdado de Control)
Deleted

Ocorre quando uma operação de exclusão for encerrada.

Deleting

Ocorre antes de uma operação de exclusão.

Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do 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 controle de servidor é carregado no objeto Page.

(Herdado de Control)
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.

(Herdado de Control)
QueryCreated

Ocorre quando uma consulta é adicionada a ou removida de um controle de fonte de dados.

(Herdado de QueryableDataSource)
Selected

Ocorre quando uma operação de recuperação de dados está concluída.

Selecting

Ocorre antes de uma operação de recuperação de dados.

Unload

Ocorre quando o controle de servidor é descarregado da memória.

(Herdado de Control)
Updated

Ocorre quando uma operação de atualização foi concluída.

Updating

Ocorre antes de uma operação de atualização.

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.

(Herdado de Control)
IDataSource.DataSourceChanged

Ocorre quando um controle de fonte de dados foi alterado de forma que afeta controles associados a dados.

(Herdado de DataSourceControl)
IDataSource.GetView(String)

Obtém um 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, que representa a lista de objetos DataSourceView associados ao controle DataSourceControl.

(Herdado de DataSourceControl)
IDynamicDataSource.ContextType

Para obter uma descrição desse membro, confira IDynamicDataSource.

IDynamicDataSource.EntitySetName

Para obter uma descrição desse membro, confira IDynamicDataSource.

IDynamicDataSource.Exception

Para obter uma descrição desse membro, confira IDynamicDataSource.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

(Herdado de Control)
IListSource.ContainsListCollection

Indica se o controle de 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, confira AddParsedSubObject(Object).

(Herdado de Control)

Métodos de Extensão

ExpandDynamicWhereParameters(IDynamicDataSource)

Expande os filtros dinâmicos em parâmetros Where que são utilizáveis pela fonte de dados.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.

GetDefaultValues(IDataSource)

Obtém a coleção de valores padrão para a fonte de dados especificada.

GetMetaTable(IDataSource)

Obtém os metadados para uma tabela no objeto de fonte de dados especificado.

GetTable(IDynamicDataSource)

Retorna o objeto MetaTable associado ao controle de fonte de dados especificado.

LoadWith<TEntity>(LinqDataSource)

Define o valor DataLoadOptions de uma fonte de dados LINQ-to-SQL para forçar todas as entidades de chave estrangeira a serem carregadas.

LoadWithForeignKeys(LinqDataSource, Type)

Define o valor DataLoadOptions de uma fonte de dados LINQ-to-SQL para forçar todas as entidades de chave estrangeira a serem carregadas.

TryGetMetaTable(IDataSource, MetaTable)

Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também