Шаг 9. Проверка, комментирование и тестирование кода

Затем в код добавляется комментарий.Комментарий это заметка, которая не влияет на выполнение программы.Он облегчает понимание назначения кода тем, кто читает этот код.Добавление комментариев в код — хорошая привычка.В Visual C# строка обозначается как комментарий с помощью двух косых черт (//).В Visual Basic строка обозначается как комментарий с помощью одинарной кавычки(').После добавления комментария программа проверяется.Рекомендуется регулярно выполнять и тестировать код при работе над проектами, чтобы можно было на ранних стадиях выявлять и устранять проблемы, прежде чем код станет слишком сложным.Это называется итеративным тестированием.

Только что выполнено построение программы, которая работает. Хотя программа еще не завершена, но она уже может загружать рисунок.Перед добавлением комментариев в код и его проверкой, уделите время на ознакомление с понятиями кода, так как эти понятия будут часто использоваться.

• При двойном щелчке по кнопке Показать рисунок в конструкторе Windows Forms интегрированная среда разработки автоматически добавляла метод в код программы.

• Методами называют порядок организации кода — это то, каким образом группируется код.

• Большую часть времени метод выполняет небольшое количество действий в определенном порядке, например, метод showButton_Click() показывает диалоговое окно и затем загружает рисунок.

• Метод состоит из операторов кода или строк кода.Считайте, что метод — это способ объединения инструкций кода.

• Когда метод выполняется или вызывается, операторы в методе выполняются по порядку, один за другим, начиная с первого.

  Ниже приведен пример оператора.

  pictureBox1.Load(openFileDialog1.FileName);
  

  pictureBox1.Load(openFileDialog1.FileName)
  

  Операторы это то, что указывает программам выполнять действия.В Visual C# оператор всегда заканчивается точкой с запятой.В Visual Basic конец строки это конец оператора. (в Visual Basic точка с запятой не нужна). Предыдущий оператор указывал элементу управления PictureBox загрузить файл, который пользователь выбрал в компоненте OpenFileDialog.

Видеоверсию этого раздела см. на следующих страницах: Tutorial 1: Create a Picture Viewer in Visual Basic - Video 5 или Tutorial 1: Create a Picture Viewer in C# - Video 5.Эти видеоролики сняты с использованием более ранней версии Visual Studio, поэтому существуют небольшие различия в некоторых командах меню и других элементах пользовательского интерфейса.Однако концепции и процедуры аналогичны текущей версии Visual Studio.

Добавление комментариев

1. Добавьте следующий комментарий в код.

   Private Sub showButton_Click() Handles showButton.Click
   
       ' Show the Open File dialog. If the user clicks OK, load the 
       ' picture that the user chose. 
       If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
           PictureBox1.Load(OpenFileDialog1.FileName)
       End If 
   
   End Sub
   

   private void showButton_Click(object sender, EventArgs e)
   {
       // Show the Open File dialog. If the user clicks OK, load the 
       // picture that the user chose. 
       if (openFileDialog1.ShowDialog() == DialogResult.OK)
       {
           pictureBox1.Load(openFileDialog1.FileName);
       }
   }
   

   Примечание

   Обработчик события Click кнопки showButton завершен и он работает.Написание кода было начато с оператора if.Оператор if как-будто говорит программе: "Проверь это условие. Если оно выполняется, выполни эти действия". В данном случае программе дается указание открыть диалоговое окно Открыть файл и, если пользователь выбирает файл и нажимает кнопку ОК, загрузить этот файл в элемент управления PictureBox.

   Совет

   Интегрированная среда разработки построена так, чтобы облегчить написание кода и фрагменты кода являются одним из этих способов.Фрагмент представляет собой ярлык, который разворачивается в небольшой блок кода. Можно просмотреть все доступные фрагменты.В строке меню выберите пункт Сервис, Диспетчер фрагментов кода.В случае Visual C# фрагмент if находится в разделе Visual C #.В случае Visual Basic фрагменты if находятся в разделе Условные выражения и циклы, Шаблоны кода.Этот диспетчер можно использовать для просмотра существующих фрагментов и для добавления собственных фрагментов. Чтобы активировать фрагмент при наборе кода, введите его и нажмите клавишу TAB.В окне IntelliSense появится множество фрагментов, поэтому нажмите клавишу TAB дважды — первый раз, чтобы выделить фрагмент в окне IntelliSense, второй раз, чтобы дать указание интегрированной среде разработки на использование этого фрагмента. (IntelliSense поддерживает фрагмент if, но не фрагмент ifelse).

2. Перед выполнением программы сохраните программу, нажав кнопку панели инструментов Сохранить все, которая показана на рисунке ниже.

   Кнопка "Сохранить все"

   

   Кроме того, чтобы сохранить программу, в строке меню выберите Файл, Сохранить все.Рекомендуется выполнять сохранение от начала разработки и как можно чаще.

   При выполнении программа должна выглядеть, как показано на рисунке ниже.

   Программа просмотра изображений

   

Проверка программы

1. Нажмите клавишу F5 или нажмите кнопку Начать отладку на панели инструментов.

2. Чтобы выполнить только что написанный вами код, нажмите кнопку Показать рисунок.Сначала программа открывает диалоговое окно Открыть файл.Проверьте, что в нижней части диалогового окна в раскрывающемся списке Типы файлов появились фильтры.Затем перейдите к рисунку и откройте его.Обычно образцы рисунков, которые поставляются вместе с операционной системой Windows, можно найти в папке Мои документы во вложенной папке Мои рисунки\Образцы рисунков.

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

3. Загрузите рисунок и он появится в элемент управления PictureBox.Затем снова попробуйте изменить размер формы, перетащив ее границы.Так как элемент управления PictureBox закреплен внутри элемента управления TableLayoutPanel, который сам закреплен внутри формы, область картинки будет сама изменять размер, таким образом, что по ширине она будет как форма и заполнит 90 процентов формы.Поэтому используются контейнеры TableLayoutPanel и FlowLayoutPanel — они сохраняют правильные размеры формы, когда пользователь меняет ее размер.

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

Продолжить или повторить пройденный материал

• Следующий шаг руководства см. в разделе Шаг 10. Написание кода дополнительных кнопок и флажка.

• Предыдущий шаг руководства см. в разделе Шаг 8. Написание кода для обработчика событий кнопки "Показать рисунок".