Директивы using и общий код
Описание.
Общий код - это функционал, расширяющий возможности стандартных кубиков C#. Он используется для вставки дополнительных классов и функций.
А Using-директивы нужны для доступа к функциям и классам, а также для создания пространства имён (namespaсes).
Как можно использовать?
- Более эффективная работа с C# кодом.
- Создание новых пространств имен.
- Организация работы с большим объемом кода.
- Избежание конфликтов в пространстве имен.
Как добавить в проект?
Через контекстное меню: Добавить действие → Свой код → Директивы using и общий код.
Или через Панель статических блоков → Добавить → Добавить директивы using и общий код:
Общий код.
Это окно представляет собой редактор кода с подсветкой синтаксиса. В контекстном меню можно получить доступ к базовому функционалу для редактирования кода: копирование, вставка, комментирование, поиск, замена и т. д.
В нижней части окна есть чекбокс, который позволяет загружать код из своего файла в форматах .txt или .cs.
Самыми первыми в коде перечислены все using, используемые в проекте. А далее идет пример объявления namespace ZennoLab.OwnCode. Вы можете по аналогии создавать свои пространства имён и обращаться к ним в дальнейшем.
Для доступа к функциям и методам общего кода их нужно объявлять с модификатором public. Если не нужно работать с объектами определенного класса, то его можно объявить статичным public static. А когда не понадобится наследование, то лучше сразу объявить как public sealed.
Директивы Using.
Перейдя на эту вкладку, вы увидите перед собой два поля:
- Верхнее. Служит для добавления namespaces, которые используются при выполнении кода в экшенах C#. Например, для парсинга XML нужно написать
using System.Xml;. - Нижнее. Здесь перечислены все using, которые используются проектом по умолчанию. Их нельзя редактировать.
Пример работы.
Подадим изображение и коэффициент прозрачности на вход метода SetImageOpacity. В результате мы получим картинку с эффектом полупрозрачности, которую можно сохранить на диск.
public static Image SetImageOpacity(Image image, float opacity)
{
try {
Bitmap bmp = new Bitmap(image.Width, image.Height);
//создание графики из картинки
using (Graphics gfx = Graphics.FromImage(bmp)) {
//создание объекта color matrix
ColorMatrix matrix = new ColorMatrix();
//установка прозрачности
matrix.Matrix33 = opacity;
//создание новых атрибутов
ImageAttributes attributes = new ImageAttributes();
//установка цвета прозрачности картинки
attributes.SetColorMatrix(matrix, ColorMatrixFlag.Default, ColorAdjustType.Bitmap);
//отрисовываем картинку
gfx.DrawImage(image, new Rectangle(0, 0, bmp.Width, bmp.Height), 0, 0, image.Width, image.Height, GraphicsUnit.Pixel, attributes);
}
return bmp;
}
catch (Exception ex) {
return null;
}
}
А вот так эта функция вызывается из экшена C#:
Image img = OwnCode.CommonCode.SetImageOpacity(Image.FromFile(project.Directory + "//image.jpg"), .5f);