ObjectDataSource.Select Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Recupera dados do armazenamento de dados subjacente chamando o método identificado pela propriedade SelectMethod com os parâmetros na coleção SelectParameters.

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

Retornos

IEnumerable

Uma lista IEnumerable de linhas de dados.

Exemplos

Para obter um exemplo de código, consulte ObjectDataSource.

Comentários

O método especificado pode ter qualquer assinatura de método, mas deve retornar ou ser derivado de um dos tipos listados na tabela a seguir para o ObjectDataSource controle chamá-lo com êxito.

Tipo de retorno Ação
IEnumerable O IEnumerable é retornado pelo Select método .
DataTable Um DataView é criado usando o DataTable e retornado pelo Select método .
DataView O DataView é retornado pelo Select método .
DataSet O primeiro DataTable do DataSet é extraído e um DataView é criado e retornado pelo Select método .
Object O objeto é encapsulado em uma coleção de um elemento IEnumerable e retornado pelo Select método .

O método identificado pela SelectMethod propriedade pode ser um método de instância ou um static método (Shared no Visual Basic). Se for um método de instância, o objeto de negócios será criado e destruído sempre que o método especificado pela SelectMethod propriedade for chamado, exceto que a mesma instância será usada para chamar o método especificado pela SelectMethod propriedade e o método especificado pela SelectCountMethod propriedade . O Select método retorna uma IEnumerable interface . No entanto, para habilitar cenários de cache e filtragem, o valor retornado deve ser um DataSet objeto . Embora a DataSet classe não implemente a IEnumerable interface , o ObjectDataSource controle extrai automaticamente o controle padrão DataView , que implementa o IEnumerable.

Antes que a Select operação seja executada, o OnSelecting método é chamado para acionar o Selecting evento. Você pode manipular o Selecting evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma Select operação. Para executar uma operação de recuperação de dados, o ObjectDataSourceView objeto usa reflexão para criar uma instância do objeto que é identificada pela TypeName propriedade . Em seguida, ele chama o método identificado pela SelectMethod propriedade , usando quaisquer propriedades associadas SelectParameters . Após a conclusão da Select operação, o OnSelected método é chamado para acionar o Selected evento. Você pode manipular o Selected evento para examinar quaisquer valores retornados, parâmetros de saída e exceções e executar qualquer pós-processamento.

Se a SelectMethod propriedade retornar um DataSetobjeto , DataTableou DataView e o cache estiver habilitado, o recuperará dados ObjectDataSource de e salvará dados no cache durante a Select operação. O cache é criado, descartado ou atualizado com base no comportamento de cache especificado pela combinação das CacheDuration propriedades e CacheExpirationPolicy .

Se a SelectMethod propriedade retornar um DataSet objeto ou DataTable e uma FilterExpression propriedade tiver sido especificada, ela será avaliada com quaisquer propriedades fornecidas FilterParameters e o filtro resultante será aplicado à lista de dados durante a Select operação.

O Select método delega para o Select método do ObjectDataSourceView associado ao ObjectDataSource controle .

Para obter mais informações sobre mesclagem de parâmetros, tempo de vida do objeto e resolução de método, consulte SelectMethod.

Controles de Associação de Dados

Quando o ObjectDataSource controle está associado a um controle associado a dados, como o GridView controle , não é necessário chamar o método do Select código da página. Em Select vez disso, o método é invocado diretamente pelo controle associado a dados.

Aplica-se a

Confira também