LinqDataSource.Selecting Zdarzenie

Definicja

Występuje przed operacją pobierania danych.Occurs before a data-retrieval operation.

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 pokazuje procedurę obsługi zdarzeń dla Selecting zdarzenia.The following example shows an event handler for the Selecting event. Program obsługi tworzy zapytanie, które pobiera wartości z tablicy wartości ciągu na stronie sieci Web.The handler creates a query that retrieves values from an array of string values in the Web page.

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

Poniższy przykład pokazuje, jak przypisać Result Właściwość do obiektu, który jest zwracany z metody, która reprezentuje procedurę składowaną.The following example shows how to assign the Result property to the object that is returned from a method that represents a stored procedure.

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ż Selecting zdarzenie, aby wykonać następujące zadania:Handle the Selecting event in order to perform the following tasks:

  • Modyfikuj parametry pobierania danych.Modify parameters for data retrieval.

  • Wygeneruj zapytanie programowo.Generate the query programmatically.

  • Zmodyfikuj wartości w celu sortowania lub stronicowania.Modify the values for sorting or paging.

  • Wykonaj niestandardowe sortowanie lub stronicowanie.Perform custom sorting or paging.

  • Anuluj operację pobierania danych.Cancel the data-retrieval operation.

LinqDataSourceSelectEventArgsObiekt, który jest przesyłany do obsługi zdarzeń dla tego zdarzenia, zawiera parametry dla operacji pobierania danych.The LinqDataSourceSelectEventArgs object that is passed to event handlers for this event contains the parameters for the data-retrieval operation. Parametry w programie obsługi zdarzeń można modyfikować Selecting przed wykonaniem zapytania lub można utworzyć nowy zestaw wyników i przypisać go do Result właściwości.You can modify the parameters in the Selecting event handler before the query executes, or you can create a new result set and assign that to the Result property.

Możliwość implementacji niestandardowego sortowania lub stronicowania w obsłudze dla tego zdarzenia może być ograniczona przez formant, który jest powiązany z LinqDataSource .Your ability to implement custom sorting or paging in handlers for this event might be limited by the control that is bound to the LinqDataSource. Na przykład po kliknięciu nagłówka kolumny GridView kontrolki kontrolka wykonuje automatyczne sortowanie, które może przesłonić dowolną kolejność ustanowioną w programie obsługi zdarzeń.For example, when the column header of a GridView control is clicked, the control performs automatic sorting which might override whatever order you establish in the event handler.

Jeśli wyjątek jest zgłaszany w procedurze obsługi zdarzeń dla Selecting zdarzenia, należy obsłużyć wyjątek w tym obsłudze zdarzeń.If an exception is thrown in an event handler for the Selecting event, you must handle the exception in that event handler. Wyjątek nie zostanie przesłany do procedury obsługi zdarzeń dla Selected zdarzenia (przez Exception Właściwość LinqDataSourceStatusEventArgs obiektu).The exception will not be passed to an event handler for the Selected event (through the Exception property of the LinqDataSourceStatusEventArgs object). ExceptionWłaściwość zawiera tylko wyjątki, które są zgłaszane po Selecting zdarzeniu.The Exception property contains only the exceptions that are thrown after the Selecting event.

Dotyczy