LinqDataSourceSelectEventArgs LinqDataSourceSelectEventArgs LinqDataSourceSelectEventArgs LinqDataSourceSelectEventArgs Class

Definition

Stellt Daten für das Selecting-Ereignis bereit.Provides data for the Selecting event.

public ref class LinqDataSourceSelectEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceSelectEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceSelectEventArgs = class
    inherit CancelEventArgs
Public Class LinqDataSourceSelectEventArgs
Inherits CancelEventArgs
Vererbung
LinqDataSourceSelectEventArgsLinqDataSourceSelectEventArgsLinqDataSourceSelectEventArgsLinqDataSourceSelectEventArgs

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Result -Eigenschaft auf das Ergebnis einer Suche festgelegt wird, die mithilfe von Language-Integrated Query (LINQ) durchgeführt wurde.The following example shows how to set the Result property to the result of a search made by using language-integrated query (LINQ).

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

Im folgenden Beispiel wird gezeigt, wie die Result -Eigenschaft auf ein Array von Zeichen folgen Werten festgelegt wird, die auf der Webseite definiert sind.The following example shows how to set the Result property to an array of string values that is defined 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

Hinweise

Das LinqDataSourceSelectEventArgs -Objekt wird für das Selecting -Ereignis des LinqDataSource -Steuer Elements an Ereignishandler übermittelt.The LinqDataSourceSelectEventArgs object is passed to event handlers for the Selecting event of the LinqDataSource control. Sie verwenden das LinqDataSourceSelectEventArgs -Objekt, um manuell anzugeben, welche Daten zurückgegeben werden, und wie die Daten bei der Rückgabe sortiert und per Pager sortiert werden.You use the LinqDataSourceSelectEventArgs object to manually specify what data is returned, and how the data is sorted and paged when it is returned. GroupByParametersSie können mithilfe der- OrderGroupsByParameters, OrderByParameters SelectParameters-,-,-und- WhereParameters Auflistungen Parameter in den Klauseln GroupBy, OrderBy, OrderGroupsBy, SELECT und WHERE Programm gesteuert hinzufügen oder entfernen.You can programmatically add or remove parameters to the GroupBy, OrderBy, OrderGroupsBy, Select, and Where clauses by using the GroupByParameters, OrderByParameters, OrderGroupsByParameters, SelectParameters, and WhereParameters collections.

Mit Result der-Eigenschaft können Sie das Datenobjekt ändern, das für die Abfrage verwendet wird.The Result property enables you to change the data object that is used for the query. Wenn Sie der Result -Eigenschaft ein-Objekt zuweisen, wird dieses Objekt anstelle des-Objekts, das in der TableName -Eigenschaft des LinqDataSource -Steuer Elements angegeben ist, für-Abfragen verwendet.If you assign an object to the Result property, that object will be used for queries instead of the object specified in the TableName property of the LinqDataSource control.

Mithilfe Arguments der-Eigenschaft können Sie anpassen, wie die zurückgegebenen Daten sortiert und ausgelagert werden.The Arguments property enables you to customize how returned data is sorted and paged. Das Daten gebundene Steuerelement übergibt Sortier-und Pagingeigenschaften durch Arguments die-Eigenschaft.The data-bound control passes sorting and paging properties through the Arguments property. Wenn Sie das Sortieren oder Paging manuell durchführen müssen, legen AutoSort Sie die AutoPage -Eigenschaft oder LinqDataSource die- falseEigenschaft des-Steuer Elements auf fest.If you have to manually handle sorting or paging, set the AutoSort property or AutoPage property of the LinqDataSource control to false. Sie können dann die angepasste Abfrage zum Sortieren oder Paging in einem Handler für das Selecting -Ereignis ausführen.You can then perform the customized query for sorting or paging in a handler for the Selecting event.

Wenn die RetrieveTotalRowCount -Eigenschaft auf truefestgelegt ist, müssen Sie einen Wert für TotalRowCount die-Eigenschaft zurückgeben.If the RetrieveTotalRowCount property is set to true, you must return a value for the TotalRowCount property.

Konstruktoren

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

Initialisiert eine neue Instanz der LinqDataSourceSelectEventArgs-Klasse.Initializes a new instance of the LinqDataSourceSelectEventArgs class.

Eigenschaften

Arguments Arguments Arguments Arguments

Ruft Werte ab, die bestimmen, wie die Daten zurückgegeben werden.Gets values that determine how the data is returned.

Cancel Cancel Cancel Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
GroupByParameters GroupByParameters GroupByParameters GroupByParameters

Ruft die Auflistung von Parametern ab, die zum Erstellen der GroupBy-Klausel verwendet werden.Gets the collection of parameters that is used to create the GroupBy clause.

OrderByParameters OrderByParameters OrderByParameters OrderByParameters

Ruft die Auflistung von Parametern ab, die zum Erstellen der OrderBy-Klausel verwendet werden.Gets the collection of parameters that is used to create the OrderBy clause.

OrderGroupsByParameters OrderGroupsByParameters OrderGroupsByParameters OrderGroupsByParameters

Ruft die Auflistung der Parameter ab, die zum Erstellen der Klausel verwendet werden, die die Sortierung der gruppierten Daten angibt.Gets the collection of parameters that are used to create the clause that specifies how grouped data is sorted.

Result Result Result Result

Ruft das in der Datenabfrage verwendete Datenobjekt ab oder legt dieses fest.Gets or sets the data object that is used in the data query.

SelectParameters SelectParameters SelectParameters SelectParameters

Ruft die Auflistung von Parametern ab, die zum Erstellen der Select-Klausel verwendet werden.Gets the collection of parameters that is used to create the Select clause.

WhereParameters WhereParameters WhereParameters WhereParameters

Ruft die Auflistung von Parametern ab, die zum Erstellen der Where-Klausel verwendet werden.Gets the collection of parameters that is used to create the Where clause.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch