LinqDataSourceSelectEventArgs Klasse

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Stellt Daten für das Selecting-Ereignis bereit.

public ref class LinqDataSourceSelectEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceSelectEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceSelectEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceSelectEventArgs
Inherits CancelEventArgs

Vererbung

Object

EventArgs

CancelEventArgs

LinqDataSourceSelectEventArgs

Beispiele

Das folgende Beispiel zeigt, wie die Result -Eigenschaft auf das Ergebnis einer Suche festgelegt wird, die mithilfe von LINQ (Language-Integrated Query) durchgeführt wird.

protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
{
    ExampleDataContext exampleContext = new ExampleDataContext();
    
    e.Result = from p in exampleContext.Products 
         where p.Category == "Beverages"
         select new {
           ID = p.ProductID,
           Name = p.Name
         };
}

Protected Sub LinqDataSource_Selecting(sender As Object, e As LinqDataSourceSelectEventArgs)
    Dim exampleContext As New ExampleDataContext()

    e.Result = From p In exampleContext.Products Where p.Category = "Beverages"
               Select New With { _
                    Key .ID = p.ProductID, _
                    Key .Name = p.Name _
    }
End Sub

Das folgende Beispiel zeigt, wie die Result -Eigenschaft auf ein Array von Zeichenfolgenwerten festgelegt wird, das auf der Webseite definiert ist.

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

Hinweise

Das LinqDataSourceSelectEventArgs -Objekt wird an Ereignishandler für das Selecting -Ereignis des LinqDataSource -Steuerelements übergeben. Sie verwenden das LinqDataSourceSelectEventArgs -Objekt, um manuell anzugeben, welche Daten zurückgegeben werden und wie die Daten sortiert und ausgelagert werden, wenn sie zurückgegeben werden. Sie können den Klauseln GroupBy, OrderBy, OrderGroupsBy, Select und Where mithilfe der GroupByParametersAuflistungen , OrderByParameters, OrderGroupsByParameters, SelectParametersund programmgesteuert Parameter hinzufügen oder WhereParameters entfernen.

Mit Result der -Eigenschaft können Sie das Datenobjekt ändern, das für die Abfrage verwendet wird. Wenn Sie der Result -Eigenschaft ein -Objekt zuweisen, wird dieses Objekt für Abfragen anstelle des in der TableName -Eigenschaft des LinqDataSource -Steuerelements angegebenen Objekts verwendet.

Mit Arguments der Eigenschaft können Sie anpassen, wie zurückgegebene Daten sortiert und ausgelagert werden. Das datengebundene Steuerelement übergibt Sortier- und Pagingeigenschaften durch die Arguments -Eigenschaft. Wenn Sie das Sortieren oder Paging manuell behandeln müssen, legen Sie die AutoSort -Eigenschaft oder AutoPage -Eigenschaft des LinqDataSource -Steuerelements auf fest false. Anschließend können Sie die angepasste Abfrage zum Sortieren oder Paging in einem Handler für das Selecting Ereignis ausführen.

Wenn die RetrieveTotalRowCount Eigenschaft auf truefestgelegt ist, müssen Sie einen Wert für die TotalRowCount Eigenschaft zurückgeben.

Konstruktoren

LinqDataSourceSelectEventArgs(DataSourceSelectArguments, IDictionary<String, Object>, IOrderedDictionary, IDictionary<String,Object>, IDictionary<String, Object>, IDictionary<String,Object>)

Initialisiert eine neue Instanz der LinqDataSourceSelectEventArgs-Klasse.

Eigenschaften

Arguments	Ruft Werte ab, die bestimmen, wie die Daten zurückgegeben werden.
Cancel	Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest. (Geerbt von CancelEventArgs)
GroupByParameters	Ruft die Auflistung von Parametern ab, die zum Erstellen der GroupBy-Klausel verwendet werden.
OrderByParameters	Ruft die Auflistung von Parametern ab, die zum Erstellen der OrderBy-Klausel verwendet werden.
OrderGroupsByParameters	Ruft die Auflistung der Parameter ab, die zum Erstellen der Klausel verwendet werden, die die Sortierung der gruppierten Daten angibt.
Result	Ruft das in der Datenabfrage verwendete Datenobjekt ab oder legt dieses fest.
SelectParameters	Ruft die Auflistung von Parametern ab, die zum Erstellen der Select-Klausel verwendet werden.
WhereParameters	Ruft die Auflistung von Parametern ab, die zum Erstellen der Where-Klausel verwendet werden.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• LinqDataSource