LinqDataSource.Selecting Événement

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Se produit avant une opération de récupération de données.

public:
 event EventHandler<System::Web::UI::WebControls::LinqDataSourceSelectEventArgs ^> ^ Selecting;

public event EventHandler<System.Web.UI.WebControls.LinqDataSourceSelectEventArgs> Selecting;

member this.Selecting : EventHandler<System.Web.UI.WebControls.LinqDataSourceSelectEventArgs> 

Public Custom Event Selecting As EventHandler(Of LinqDataSourceSelectEventArgs) 

Type d'événement

EventHandler<LinqDataSourceSelectEventArgs>

Exemples

L’exemple suivant montre un gestionnaire d’événements pour l’événement Selecting . Le gestionnaire crée une requête qui récupère des valeurs à partir d’un tableau de valeurs de chaîne dans la page 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

L’exemple suivant montre comment affecter la Result propriété à l’objet retourné à partir d’une méthode qui représente une procédure stockée.

Protected Sub LinqDataSource_Selecting(ByVal sender As Object, _  
        ByVal e As LinqDataSourceSelectEventArgs)  
    Dim exampleContext As ExampleDataContext = New ExampleDataContext()  
    e.Result = exampleContext.GetRegisteredCustomers()  
End Sub  

protected void LinqDataSource_Selecting(object sender,   
        LinqDataSourceSelectEventArgs e)  
{  
    ExampleDataContext exampleContext = new ExampleDataContext();  
    e.Result = exampleContext.GetRegisteredCustomers();  
}  

Remarques

Gérez l’événement Selecting afin d’effectuer les tâches suivantes :

• Modifiez les paramètres pour la récupération des données.

• Générez la requête par programmation.

• Modifiez les valeurs pour le tri ou la pagination.

• Effectuez un tri ou une pagination personnalisés.

• Annulez l’opération de récupération des données.

L’objet LinqDataSourceSelectEventArgs passé aux gestionnaires d’événements pour cet événement contient les paramètres de l’opération de récupération des données. Vous pouvez modifier les paramètres dans le Selecting gestionnaire d’événements avant l’exécution de la requête, ou vous pouvez créer un jeu de résultats et l’affecter à la Result propriété .

Votre capacité à implémenter un tri ou une pagination personnalisés dans les gestionnaires de cet événement peut être limitée par le contrôle lié au LinqDataSource. Par exemple, lorsque l’on clique sur l’en-tête de colonne d’un GridView contrôle, le contrôle effectue un tri automatique qui peut remplacer n’importe quel ordre que vous établissez dans le gestionnaire d’événements.

Si une exception est levée dans un gestionnaire d’événements pour l’événement Selecting , vous devez gérer l’exception dans ce gestionnaire d’événements. L’exception ne sera pas passée à un gestionnaire d’événements pour l’événement Selected (via la Exception propriété de l’objet LinqDataSourceStatusEventArgs ). La Exception propriété contient uniquement les exceptions levées après l’événement Selecting .