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 SelectMethod propriedade com os parâmetros na SelectParameters coleção.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableRetornos
Uma IEnumerable lista 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 que o controle a ObjectDataSource chame com êxito.
| Tipo de retorno | Ação |
|---|---|
| IEnumerable | O IEnumerable é retornado pelo Select método. |
| DataTable | Um DataView é criado usando o DataTable método e retornado pelo Select método. |
| DataView | O DataView é retornado pelo Select método. |
| DataSet | O primeiro DataTable é 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 é identificado 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 objeto e cache estiver habilitado, os ObjectDataSource dados serão recuperados e salvarão 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 propriedades e do CacheDuration cache CacheExpirationPolicy .
Se a SelectMethod propriedade retornar um DataSet objeto ou DataTable um objeto 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 ao Select método associado ObjectDataSourceView ao ObjectDataSource controle.
Para obter mais informações sobre mesclagem de parâmetros, tempo de vida do objeto e resolução do método, consulte SelectMethod.
Controles de Data-Bound
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.
