LinqDataSource.Selecting Ereignis

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Tritt vor einem Datenabrufvorgang ein.

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)

Ereignistyp

EventHandler<LinqDataSourceSelectEventArgs>

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das Selecting Ereignis. Der Handler erstellt eine Abfrage, die Werte aus einem Array von Zeichenfolgenwerten auf der Webseite abruft.

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

Das folgende Beispiel zeigt, wie die Result -Eigenschaft dem Objekt zugewiesen wird, das von einer Methode zurückgegeben wird, die eine gespeicherte Prozedur darstellt.

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

Hinweise

Behandeln Sie das Selecting Ereignis, um die folgenden Aufgaben auszuführen:

Ändern von Parametern für den Datenabruf.
Generieren Sie die Abfrage programmgesteuert.
Ändern Sie die Werte für das Sortieren oder Paging.
Führen Sie benutzerdefinierte Sortierung oder Paging aus.
Abbrechen des Datenabrufvorgangs.

Das LinqDataSourceSelectEventArgs -Objekt, das an Ereignishandler für dieses Ereignis übergeben wird, enthält die Parameter für den Datenabrufvorgang. Sie können die Parameter im Selecting Ereignishandler ändern, bevor die Abfrage ausgeführt wird, oder Sie können ein neues Resultset erstellen und es der Result -Eigenschaft zuweisen.

Ihre Fähigkeit, benutzerdefinierte Sortierung oder Paging in Handlern für dieses Ereignis zu implementieren, kann durch das -Steuerelement eingeschränkt werden, das an das LinqDataSourcegebunden ist. Wenn beispielsweise auf die Spaltenüberschrift eines GridView Steuerelements geklickt wird, führt das Steuerelement eine automatische Sortierung durch, die die reihenfolge überschreibt, die Sie im Ereignishandler festlegen.

Wenn eine Ausnahme in einem Ereignishandler für das Selecting Ereignis ausgelöst wird, müssen Sie die Ausnahme in diesem Ereignishandler behandeln. Die Ausnahme wird nicht an einen Ereignishandler für das Selected Ereignis übergeben (über die Exception -Eigenschaft des LinqDataSourceStatusEventArgs -Objekts). Die Exception -Eigenschaft enthält nur die Ausnahmen, die nach dem Selecting Ereignis ausgelöst werden.

Gilt für:

Freigeben über