DataSourceView.ExecuteSelect(DataSourceSelectArguments) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Ruft eine Liste der Daten aus dem zugrunde liegenden Datenspeicher ab.

protected public:
 abstract System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);

protected internal abstract System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);

abstract member ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable

Protected Friend MustOverride Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parameter

arguments

DataSourceSelectArguments

Ein DataSourceSelectArguments, das zum Anfordern von Datenvorgängen verwendet wird, die über allgemeine Datenabrufvorgänge hinausgehen.

Gibt zurück

IEnumerable

Eine IEnumerable-Liste der Daten aus dem zugrunde liegenden Datenspeicher.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ExecuteSelect -Methode in einer Klasse überschrieben wird, die die DataSourceView -Klasse erweitert. Öffnet CsvDataSourceView eine durch Trennzeichen getrennte Wertdatei (.csv), analysiert sie Zeile für Zeile und erstellt ein DataTable Objekt und ein DataView Objekt, um die Daten im Arbeitsspeicher zu speichern. Schließlich wird ein Sortierausdruck angewendet, wenn er vom DataSourceSelectArguments Objekt bereitgestellt wird, und das DataView Objekt wird als IEnumerable instance zurückgegeben. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataSourceView-Klasse bereitgestellt wird.

// Get data from the underlying data source.
// Build and return a DataView, regardless of mode.
protected override IEnumerable ExecuteSelect(DataSourceSelectArguments selectArgs) {
    IEnumerable dataList = null;
    // Open the .csv file.
    if (File.Exists(this.SourceFile)) {
        DataTable data = new DataTable();

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(this.SourceFile)) {
            // Parse the line
            string s = "";
            string[] dataValues;
            DataColumn col;

            // Do the following to add schema.
            dataValues = sr.ReadLine().Split(',');
            // For each token in the comma-delimited string, add a column
            // to the DataTable schema.
            foreach (string token in dataValues) {
                col = new DataColumn(token,typeof(string));
                data.Columns.Add(col);
            }

            // Do not add the first row as data if the CSV file includes column names.
            if (! IncludesColumnNames)
                data.Rows.Add(CopyRowData(dataValues, data.NewRow()));

            // Do the following to add data.
            while ((s = sr.ReadLine()) != null) {
                dataValues = s.Split(',');
                data.Rows.Add(CopyRowData(dataValues, data.NewRow()));
            }
        }
        data.AcceptChanges();
        DataView dataView = new DataView(data);
        if (!string.IsNullOrEmpty(selectArgs.SortExpression)) {
            dataView.Sort = selectArgs.SortExpression;
        }
        dataList = dataView;
    }
    else {
        throw new System.Configuration.ConfigurationErrorsException("File not found, " + this.SourceFile);
    }

    if (null == dataList) {
        throw new InvalidOperationException("No data loaded from data source.");
    }

    return dataList;
}

private DataRow CopyRowData(string[] source, DataRow target) {
    try {
        for (int i = 0;i < source.Length;i++) {
            target[i] = source[i];
        }
    }
    catch (System.IndexOutOfRangeException) {
        // There are more columns in this row than
        // the original schema allows.  Stop copying
        // and return the DataRow.
        return target;
    }
    return target;
}

' Get data from the underlying data source.
' Build and return a DataView, regardless of mode.
Protected Overrides Function ExecuteSelect(selectArgs As DataSourceSelectArguments) _
 As System.Collections.IEnumerable
   Dim dataList As IEnumerable = Nothing
   ' Open the .csv file.
   If File.Exists(Me.SourceFile) Then
      Dim data As New DataTable()

      ' Open the file to read from.
      Dim sr As StreamReader = File.OpenText(Me.SourceFile)

      Try
         ' Parse the line
         Dim dataValues() As String
         Dim col As DataColumn

         ' Do the following to add schema.
         dataValues = sr.ReadLine().Split(","c)
         ' For each token in the comma-delimited string, add a column
         ' to the DataTable schema.
         Dim token As String
         For Each token In dataValues
            col = New DataColumn(token, System.Type.GetType("System.String"))
            data.Columns.Add(col)
         Next token

         ' Do not add the first row as data if the CSV file includes column names.
         If Not IncludesColumnNames Then
            data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
         End If

         ' Do the following to add data.
         Dim s As String
         Do
            s = sr.ReadLine()
            If Not s Is Nothing Then
                dataValues = s.Split(","c)
                data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
            End If
         Loop Until s Is Nothing

      Finally
         sr.Close()
      End Try

      data.AcceptChanges()
      Dim dataView As New DataView(data)
      If Not selectArgs.SortExpression Is String.Empty Then
          dataView.Sort = selectArgs.SortExpression
      End If
      dataList = dataView
   Else
      Throw New System.Configuration.ConfigurationErrorsException("File not found, " + Me.SourceFile)
   End If

   If dataList is Nothing Then
      Throw New InvalidOperationException("No data loaded from data source.")
   End If

   Return dataList
End Function 'ExecuteSelect


Private Function CopyRowData([source]() As String, target As DataRow) As DataRow
   Try
      Dim i As Integer
      For i = 0 To [source].Length - 1
         target(i) = [source](i)
      Next i
   Catch iore As IndexOutOfRangeException
      ' There are more columns in this row than
      ' the original schema allows.  Stop copying
      ' and return the DataRow.
      Return target
   End Try
   Return target
End Function 'CopyRowData

Hinweise

Die ExecuteSelect -Methode wird aufgerufen, um Daten aus dem zugrunde liegenden Datenspeicher abzurufen und als IEnumerable Objekt zurückzugeben. Alle Datenquellensteuerelemente unterstützen den Datenabruf aus dem zugrunde liegenden Datenspeicher, auch wenn andere Vorgänge wie Einfügen und Sortieren nicht unterstützt werden. Da ein datengebundenes Steuerelement als Ergebnis eines Ereignisses oder DataBind Eines Methodenaufrufs jederzeit eine DataSourceChanged Liste von Daten anfordern kann, muss der Datenabruf bei Bedarf ausgeführt werden.

Weitere Informationen

• CanSort