Занятие 8: Создание фильтра данных

Статья
09/10/2013

После добавления к родительскому отчету операции детализации следующий шаг состоит в создании фильтра данных для таблицы данных, которая определена в дочернем отчете.

Для детализированного отчета можно создать фильтр на основе таблицы или фильтр с запросом. На этом занятии приведены указания по обоим вариантам.

Фильтр на основе таблицы

Для реализации фильтра на основе таблицы необходимо выполнить следующие задачи.

Добавить критерий фильтра к табликсу в дочернем отчете.
Создать функцию, которая выбирает нефильтрованные данные из таблицы PurchaseOrderDetail.
Добавить обработчик событий, который связывает таблицу данных PurchaseOrderDetail с дочерним отчетом.

Добавление критерия фильтра к табликсу в дочернем отчете

Откройте дочерний отчет.
Выберите заголовок столбца в табликсе, щелкните правой кнопкой мыши выделенную серым цветом ячейку, которая отображается над заголовком столбца, и щелкните Свойства табликса.
Откройте страницу Фильтры и выберите Добавить.
В поле Выражение выберите ProductID из раскрывающегося списка. Это столбец, к которому применяется фильтр.
В раскрывающемся списке Оператор щелкните оператор равенства (=).
Нажмите кнопку выражения рядом с полем Значение, щелкните Параметры в области Категория, а затем дважды щелкните productid в области Значения. Поле Задание выражения для значения теперь должно содержать выражение, аналогичное =Parameters!productid.Value.
В диалоговом окне Свойства табликса нажмите кнопку ОК, затем нажмите кнопку ОК еще раз.
Сохраните RDLC-файл.

Создание функции, которая выбирает нефильтрованные данные из таблицы PurchaseOrderDetail

В обозревателе решений разверните Default.aspx, затем дважды щелкните Default.aspx.cs.
Создайте новую функцию, которая принимает параметр productid типа Integer, возвращает объект datatable и выполняет следующие действия.
1. Создание экземпляра набора данных DataSet2, который был создан на шаге 2 в Занятие 4: Определение подключения к данным и таблицы данных для дочернего отчета.
2. Создание подключения к базе данных SqlServer для выполнения запроса, который определен в разделе Занятие 4. Определение подключения к данным и таблицы данных для дочернего отчета.
3. Запрос возвратит нефильтрованные данные.
4. Заполнение экземпляра набора данных нефильтрованными данными путем выполнения запроса.
5. Возврат таблицы данных PurchaseOrderDetail.
  
  Функция будет иметь примерно такой вид, как показано ниже. (Этот пример приведен только для справки. Для выборки необходимых данных для дочернего отчета можно применять любой подход.)
  
  Обязательно укажите ссылки на пространства имен System.Data и System.Data.SqlClient.
```
/// <summary>
    /// Function to query PurchaseOrderDetail table, fetch the
    /// unfiltered data and bind it with the Child report
    /// </summary>
    /// <returns>A dataTable of type PurchaseOrderDetail</returns>
    private DataTable GetPurchaseOrderDetail()
    {
        try
        {
            //Create the instance for the typed dataset, DataSet2 which will 
            //hold the [PurchaseOrderDetail] table details.
            //The dataset was created as part of the tutorial in Step 4.
            DataSet2 ds = new DataSet2();
 
            //Create a SQL Connection to the AdventureWorks2008 database using Windows Authentication.
            using (SqlConnection sqlconn = new SqlConnection("Data Source=.;Initial Catalog=Adventureworks;Integrated Security=SSPI"))
            {
                //Building the dynamic query with the parameter ProductID.
                SqlDataAdapter adap = new SqlDataAdapter("SELECT PurchaseOrderID, PurchaseOrderDetailID, OrderQty, ProductID, ReceivedQty, RejectedQty, StockedQty FROM Purchasing.PurchaseOrderDetail ", sqlconn);
                //Executing the QUERY and fill the dataset with the PurchaseOrderDetail table data.
                adap.Fill(ds, "PurchaseOrderDetail");
            }
 
            //Return the PurchaseOrderDetail table for the Report Data Source.
            return ds.PurchaseOrderDetail;
        }
        catch
        {
            throw;
        }
    }
```

Добавление обработчика событий, который связывает таблицу данных PurchaseOrderDetail с дочерним отчетом

Откройте страницу Default.aspx.
Щелкните правой кнопкой мыши элемент управления ReportViewer, затем выберите Свойства.
На странице Свойства щелкните значок События.
Дважды щелкните событие Детализация.

Это приведет к добавлению раздела обработчика событий в код, который выглядит так, как в приведенном ниже блоке.
```
    protected void ReportViewer1_Drillthrough(object sender, Microsoft.Reporting.WebForms.DrillthroughEventArgs e)
    {
    }
```

Завершите подготовку обработчика событий. Он должен включать следующие функции.

Выборка ссылки на объект дочернего отчета из параметра DrillthroughEventArgs.
Вызов функции GetPurchaseOrderDetail

Привязка таблицы данных PurchaseOrderDetail к соответствующему источнику данных отчета.

Код обработчика событий в законченном виде будет выглядеть следующим образом.

Обязательно укажите ссылки на пространство имен Microsoft.Reporting.WebForms.

protected void ReportViewer1_Drillthrough(object sender, Microsoft.Reporting.WebForms.DrillthroughEventArgs e)
    {
        try
        {
             //Get the instance of the Target report, in our case the JumpReport.rdlc.
            LocalReport report = (LocalReport)e.Report;
 
             //Binding the DataTable to the Child report dataset.
            //The name DataSet1 which can be located from, 
            //Go to Design view of Child.rdlc, Click View menu -> Report Data
            //You'll see this name under DataSet2.
            report.DataSources.Add(new ReportDataSource("DataSet1", GetPurchaseOrderDetail()));
        }
        catch (Exception ex)
        {
            Response.Write(ex.Message);
        }
    }

Сохраните файл.

Фильтр с запросом

Для реализации фильтра с запросом необходимо выполнить следующие задачи.

Создание функции, которая выбирает фильтрованные данные из таблицы PurchaseOrderDetail.
Добавление обработчика событий, который получает значения параметров и привязывает таблицу данных PurchaseOrdeDetail к дочернему отчету.

Создание функции, которая выбирает фильтрованные данные из таблицы PurchaseOrderDetail

В обозревателе решений разверните Default.aspx, затем дважды щелкните Default.aspx.cs.
Создайте новую функцию, которая принимает параметр productid типа Integer, возвращает объект datatable и выполняет следующие действия.
1. Создание экземпляра набора данных DataSet2, который был создан на шаге 2 в Занятие 4: Определение подключения к данным и таблицы данных для дочернего отчета.
2. Создание подключения к базе данных SqlServer для выполнения запроса, определенного в разделе Занятие 4. Определение подключения к данным и таблицы данных для дочернего отчета.
3. Запрос должен включать параметр productid для обеспечения фильтрации возвращаемых данных с учетом значения ProductID, выбранного в родительском отчете.
4. Заполнение экземпляра набора данных фильтрованными данными путем выполнения запроса.
5. Возврат таблицы данных PurchaseOrderDetail.
  
  Функция будет иметь примерно такой вид, как показано ниже. (Этот пример приведен только для справки. Для выборки необходимых данных для дочернего отчета можно применять любой подход.)
  
  Обязательно укажите ссылки на пространства имен System.Data и System.Data.SqlClient.
```
/// <summary>
    /// Function to query PurchaseOrderDetail table and filter the
    /// data for a specific ProductID selected in the Parent report.
    /// </summary>
    /// <param name="productid">Parameter passed from the Parent report to filter data.</param>
    /// <returns>A dataTable of type PurchaseOrderDetail</returns>
    private DataTable GetPurchaseOrderDetail(int productid)
    {
        try
        {
            //Create the instance for the typed dataset, DataSet2 which will 
            //hold the [PurchaseOrderDetail] table details.
            //The dataset was created as part of the tutorial in Step 4.
            DataSet2 ds = new DataSet2();
 
            //Create a SQL Connection to the AdventureWorks2008 database using Windows Authentication.
            using (SqlConnection sqlconn = new SqlConnection("Data Source=.;Initial Catalog=Adventureworks;Integrated Security=SSPI"))
            {
                //Building the dynamic query with the parameter ProductID.
                SqlDataAdapter adap = new SqlDataAdapter("SELECT PurchaseOrderID, PurchaseOrderDetailID, OrderQty, ProductID, ReceivedQty, RejectedQty, StockedQty FROM Purchasing.PurchaseOrderDetail where ProductID = " + productid, sqlconn);
                //Executing the QUERY and fill the dataset with the PurchaseOrderDetail table data.
                adap.Fill(ds, "PurchaseOrderDetail");
            }
 
            //Return the PurchaseOrderDetail table for the Report Data Source.
            return ds.PurchaseOrderDetail;
        }
        catch
        {
            throw;
        }
    }
```

Добавление обработчика событий, который получает значения параметров и связывает таблицу данных PurchaseOrdeDetail с дочерним отчетом

Откройте страницу Default.aspx.
Щелкните правой кнопкой мыши элемент управления ReportViewer, затем выберите Свойства.
На панели Свойства щелкните значок События.
Дважды щелкните событие Детализация.

Это приведет к добавлению раздела с обработчиком событий в код, который будет выглядеть примерно так.
```
    protected void ReportViewer1_Drillthrough(object sender, Microsoft.Reporting.WebForms.DrillthroughEventArgs e)
    {
    }
```

Завершите подготовку обработчика событий. Он должен выполнять следующие функции.

Выборка ссылки на объект дочернего отчета из параметра DrillthroughEventArgs.
Получение списка параметров дочернего отчета из имеющегося объекта дочернего отчета.
Итерация в коллекции параметров и выборка значения для параметра ProductID, переданного из родительского отчета.
Вызов функции GetPurchaseOrderDetail и передача значения для параметра ProductID.