LinqDataSource.Selecting Zdarzenie

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Extensions.dll

Występuje przed operacją pobierania danych.

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) 

Typ zdarzenia

EventHandler<LinqDataSourceSelectEventArgs>

Przykłady

Poniższy przykład przedstawia procedurę obsługi zdarzeń dla Selecting zdarzenia. Procedura obsługi tworzy zapytanie, które pobiera wartości z tablicy wartości ciągów na stronie sieci 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

W poniższym przykładzie pokazano, jak przypisać Result właściwość do obiektu zwróconego z metody reprezentującej procedurę składowaną.

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();  
}  

Uwagi

Obsłuż zdarzenie Selecting , aby wykonać następujące zadania:

• Modyfikowanie parametrów pobierania danych.

• Programowe generowanie zapytania.

• Zmodyfikuj wartości sortowania lub stronicowania.

• Sortowanie niestandardowe lub stronicowanie.

• Anuluj operację pobierania danych.

Obiekt LinqDataSourceSelectEventArgs przekazywany do procedur obsługi zdarzeń dla tego zdarzenia zawiera parametry operacji pobierania danych. Parametry programu Selecting obsługi zdarzeń można zmodyfikować przed wykonaniem zapytania lub utworzyć nowy zestaw wyników i przypisać go do Result właściwości .

Możliwość zaimplementowania niestandardowego sortowania lub stronicowania w programach obsługi dla tego zdarzenia może być ograniczona przez kontrolkę powiązaną z elementem LinqDataSource. Na przykład po kliknięciu nagłówka GridView kolumny kontrolki kontrolka wykonuje automatyczne sortowanie, które może zastąpić dowolną kolejność ustanowienia w procedurze obsługi zdarzeń.

Jeśli wyjątek jest zgłaszany w procedurze obsługi zdarzeń dla Selecting zdarzenia, należy obsłużyć wyjątek w tej procedurze obsługi zdarzeń. Wyjątek nie zostanie przekazany do programu obsługi zdarzeń dla Selected zdarzenia (za pośrednictwem Exception właściwości LinqDataSourceStatusEventArgs obiektu). Właściwość Exception zawiera tylko wyjątki, które są zgłaszane po zdarzeniu Selecting .