ObjectDataSource.Select Método
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.
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.IEnumerablePublic Function Select () As IEnumerableRetornos
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.
