Привязка данных ADO.NET

Использование ObjectDataSource для вставки и удаления записей

Аналогичным образом можно задействовать и другие оставшиеся методы нашего пользовательского класса EmployeeDB, имеющие параметры:

• public int InsertEmployee(EmployeeDetails emp) {...}
• public void DeleteEmployee(int employeeID) {...}

Рассмотрим операцию вставки с применением пользовательского класса EmployeeDB. Эту операцию мы вправе добавить на страницу в дополнение к уже реализованной операции обновления. Особенность реализации метода вставки состоит в том, что он возвращает значение, указывающее содержимое поля EmployeeID. Это поле в таблице является ключевым и имеет свойство AutoIncrement (автоматическое увеличение). Его значение, возвращенное методом, можно проигнорировать, но можно и перехватывать и использовать для каких-нибудь целей, например извещения пользователя.

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

• Создайте копию страницы ObjectDataSourceUpdates2.aspx с именем ObjectDataSourceFull.aspx и назначьте ее стартовой
• Проверьте работоспособность начального варианта страницы ObjectDataSourceFull.aspx

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

• Добавьте после элемента GridView1 компонент LinkButton и создайте для него обработчик LinkButton1_Click()
• В режиме Design двойным щелчком на свободном месте Web-формы создайте обработчик Page_Load() страницы, в котором мы будем формировать сообщение о номере добавленной в таблицу записи
• Поместите после элемента LinkButton1 компонент Label с именем lblInfo, в котором мы будем размещать сообщения для пользователя о добавленной или удаленной записи таблицы Employees
• В режиме Design вызовите встроенную панель источника ObjectDataSource1 и щелчком на ссылке Configure Data Source вызовите мастер конфигурации источника данных. Проверьте правильность подключения методов во вкладках SELECT и UPDATE, затем подключите метод удаления во вкладке DELETE
  

  
  увеличить изображение
  
• После щелчка на кнопке Finish откажитесь от предложения скорректировать объект GridView1
  

  
  увеличить изображение
  
• Вызовите через свойство ObjectDataSource1.DeleteParameters окно визуального редактирования параметров команды удаления и настройте его так
  

  
  увеличить изображение
  
• Выделите элемент ObjectDataSource1 и через панель Properties создайте обработчик ObjectDataSource1_Deleting() для события Deleting, в котором мы будем перехватывать номер удаляемой из таблицы записи

В результате таких действий по конфигурированию элемента ObjectDataSource1 оболочка добавит в его дескриптор нужный код (который, кстати, можно ввести и вручную без всяких визуальных помощников)

<asp:ObjectDataSource ID="ObjectDataSource1" runat="server"
    TypeName="EmployeeDB" SelectMethod="GetAllEmployees" 
    UpdateMethod="UpdateEmployee" 
    DeleteMethod="DeleteEmployee"
    OnDeleting="ObjectDataSource1_Deleting">
    <UpdateParameters>
        <asp:Parameter Name="employeeID" Type="Int32" />
        <asp:Parameter Name="firstName" Type="String" />
        <asp:Parameter Name="lastName" Type="String" />
        <asp:Parameter Name="titleOfCourtesy" Type="String" />
    </UpdateParameters>
    <DeleteParameters>
        <asp:ControlParameter ControlID="GridView1" 
            Name="employeeID" Type="int32" />
    </DeleteParameters>
</asp:ObjectDataSource>

Теперь скорректируем управляющий столбец объекта GridView1, чтобы добавить в его пользовательский интерфейс кнопку для возможности удаления записи. Кнопку добавим в форме гиперссылки Link.

• Вызовите встроенный визуальный редактор для объекта GridView1. Для этого щелкните на кнопке (пиктограмма треугольника) в правом верхнем углу визуального представления объекта, а затем на ссылке Edit Columns
  

  
  
• Выделите управляющий столбец "Изменить" и в поле CommandField properties установите значения следующих свойств
  • ButtonType=Link
  • DeleteText="Удалить"
  • ShowDeleteButton="True"
  

  
  увеличить изображение
  

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

ADO.NET отслеживает это положение автоматически, но ей нужно указать первичный ключ. Для этого служит параметр DataKeyNames в элементе управления GridView1 (поскольку мы планируем удалять запись через него), в котором указывается строка с одним именем ключевого поля или строка со списком ключевых полей, разделенных запятыми. В нашем случае первичным ключом в таблице Employees является поле EmployeeID.

• Переведите редактор страницы в режим Source и добавьте в заголовок элемента GridView1 параметр, назначающий ключевое поле редактируемой таблицы
  • DataKeyNames="EmployeeID"
• Выделите текстовую метку lblInfo и сбросьте свойство сохранения состояния EnableViewState="False", чтобы при каждом новом запросе ее значение очищалось

На этом этап декларативной настройки страницы закончен. Теперь нужно заполнить созданные нами ранее обработчики соответствующим кодом.

• Заполните обработчики событий так, чтобы окончательный код страницы ObjectDataSourceFull.aspx стал следующим

  <%@ Page Language="C#" %>
      
  <script runat="server">
      
      protected void LinkButton1_Click(object sender, EventArgs e)
      {
          EmployeeDB db = new EmployeeDB();
          // Вставляем пустую запись и запоминаем ее номер
          Session["recordNumber"] = 
              db.InsertEmployee(new EmployeeDetails(0, "", "", ""));
          // Обновляем страницу без полного цикла,
          Server.Transfer(Request.FilePath);
      }
      
      protected void Page_Load(object sender, EventArgs e)
      {
          if (Session["recordNumber"] != null)
          {
              lblInfo.Text = "Добавлена запись "
                  + Session["recordNumber"].ToString();
              Session.Remove("recordNumber");
          }
      }
      
      protected void ObjectDataSource1_Deleting(object sender, 
          ObjectDataSourceMethodEventArgs e)
      {
          lblInfo.Text = "Удалена запись " 
              + e.InputParameters["employeeID"].ToString();
      }
  </script>
      
  <html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
      <title>Untitled Page</title>
  </head>
  <body>
      <form id="form1" runat="server">
      <div>
          <asp:ObjectDataSource ID="ObjectDataSource1" runat="server"
              TypeName="EmployeeDB" SelectMethod="GetAllEmployees" 
              UpdateMethod="UpdateEmployee" 
              DeleteMethod="DeleteEmployee"
              OnDeleting="ObjectDataSource1_Deleting">
              <UpdateParameters>
                  <asp:Parameter Name="employeeID" Type="Int32" />
                  <asp:Parameter Name="firstName" Type="String" />
                  <asp:Parameter Name="lastName" Type="String" />
                  <asp:Parameter Name="titleOfCourtesy" Type="String" />
              </UpdateParameters>
              <DeleteParameters>
                  <asp:ControlParameter ControlID="GridView1" 
                      Name="employeeID" Type="int32" />
              </DeleteParameters>
          </asp:ObjectDataSource>
          <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="ObjectDataSource1" 
              DataKeyNames="EmployeeID">
              <Columns>
                  <asp:BoundField DataField="EmployeeID" HeaderText="№ п/п" />
                  <asp:BoundField DataField="FirstName" HeaderText="Имя" />
                  <asp:BoundField DataField="LastName" HeaderText="Фамилия" />
                  <asp:BoundField DataField="TitleOfCourtesy" HeaderText="Статус" />
                  <asp:CommandField 
                      CancelText="Отмена" EditText="Редакция" HeaderText="Изменить"
                      ShowEditButton="True" ShowHeader="True" UpdateText="Применить" 
                      DeleteText="Удалить" ShowDeleteButton="True">
                      <HeaderStyle BackColor="Red" ForeColor="Yellow" />
                  </asp:CommandField>
              </Columns>
          </asp:GridView>
          <asp:LinkButton ID="LinkButton1" runat="server" OnClick="LinkButton1_Click">
              Вставка
          </asp:LinkButton>
          <br />
          <asp:Label ID="lblInfo" runat="server" EnableViewState="False" />
      </div>
      </form>
  </body>
  </html>
• Исполните страницу ObjectDataSourceFull.aspx и насладитесь тем, что она имеет функциональность полноценного редактора таблиц, тем более - удаленных (Ах да Большой Билл, ах да мала-ц-ц-а!). Один из экранов, генерируемых на стороне пользователя, будет таким

Программное изменение запроса пользователя в SqlDataSource

Ранее мы рассматривали пример SqlDataSourceParameters.aspx выборки данных из таблицы в зависимости от выбранного пользователем города. Первый источник SqlDataSource заполнял городами список, жестко привязанный с помощью спискового свойства DataSourceID. Второй источник SqlDataSource отрабатывал один и тот же SQL-запрос с разными значениями параметра, полученными из списка в зависимости от выбора пользователя.

В следующем примере попробуем расширить список добавлением в него еще одного пункта и при выборе пользователем этого добавленного элемента списка изменить SQL-запрос. Привязку списка к источнику данных SqlDataSource, а также изменение SQL-запроса выполним программно.

• Сделайте копию страницы SqlDataSourceParameters.aspx с именем SqlDataSourceChange.aspx и назначьте ее стартовой
• Выделите элемент DropDownList ID="lstCities" и очистите его свойство DataSourceID, тем самым мы отвяжем список от источника данных
• Двойным щелчком на свободном месте Web-формы создайте обработчик загрузки страницы Page_Load()
• Для второго источника SqlDataSource ID="sourceEmployees" через панель Properties создайте обработчик события Selecting
• Заполните обработчики кодом так, чтобы окончательное описание страницы было следующим

<%@ Page Language="C#" %>
    
<script runat="server">
    
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!this.IsPostBack)// Первый запрос
        {
            // Инициировать запрос и привязать результаты
            lstCities.DataSource = sourceEmployeeCities.Select(
                DataSourceSelectArguments.Empty);
            lstCities.DataBind();
    
            // Добавить новый элемент в список
            lstCities.Items.Add("Все города");
            lstCities.SelectedIndex = lstCities.Items.Count - 1;
        }
    }
    
    void sourceEmployees_Selecting(object sender, 
                                   SqlDataSourceSelectingEventArgs e)
    {
        if ((string)e.Command.Parameters["@City"].Value == "Все города")
        {
            // Очистить коллекцию параметров
            e.Command.Parameters.Clear();
                
            // Изменить команду
            e.Command.CommandText = "SELECT EmployeeID, FirstName, LastName, "
                + "Title, City FROM Employees WHERE City!=''";
        }
    }
</script>
    
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h2>Выберите город</h2>
        <asp:SqlDataSource ID="sourceEmployeeCities" runat="server" 
            ConnectionString="<%$ connectionStrings:Northwind %>" 
            ProviderName="System.Data.SqlClient" 
            SelectCommand="SELECT DISTINCT City FROM Employees" />
        <asp:DropDownList ID="lstCities" runat="server" 
            AutoPostBack="True"
            DataTextField="City" />
            
        <h2>Проживающие сотрудники</h2>
        <asp:SqlDataSource ID="sourceEmployees" runat="server" 
            ConnectionString="<%$ connectionStrings:Northwind %>" 
            ProviderName="System.Data.SqlClient" 
            SelectCommand="SELECT EmployeeID, FirstName, LastName, 
                Title, City FROM Employees WHERE City=@City" 
                OnSelecting="sourceEmployees_Selecting">
            <SelectParameters>
                <asp:ControlParameter Name="City" ControlID="lstCities" 
                    PropertyName="SelectedValue" />
            </SelectParameters>
        </asp:SqlDataSource>
        <asp:GridView ID="GridView1" runat="server" 
            DataSourceID="sourceEmployees" />
    </div>
    </form>
</body>
</html>

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

Статический результат выполнения страницы SqlDataSourceChange.aspx следующий

Выберите город

Проживающие сотрудники

EmployeeID	FirstName	LastName	Title	City
9	Владимир	Снетков	Доцент ВАК	Красноярск