
- •С.А.Матюхин Свойства и методы компонентов в c# Форма
- •Компоненты
- •Системные классы
- •Функции по работе с файлами и каталогами
- •Доступ к базе данных -
- •Объекты поставщики данных
- •Объект Connection
- •Дополнительные пространства имён ado.Net
- •Объект Command
- •Объект DataBuilder
- •Объект DataReader
- •Объект DataAdapter
- •Объект Transaction
- •Объекты- потребители данных
- •Типы System.Data
- •Класс DataRow
- •События изменения значений в строках таблицы данных
- •Адаптер данных
С.А.Матюхин Свойства и методы компонентов в c# Форма
Свойство |
Описание |
BackColor |
Цвет фона |
Cursor |
Вид указателя мыши |
Enabled |
Позволяет сделать форму недоступной (False) или разрешить щелчок по ней (True) |
Font |
По умолчанию шрифт всех содержащихся в форме компонентов |
ForeColor |
Цвет текстов |
ControlBox |
Управляет системными кнопками: False – кнопки отсутствуют |
FormBorderStyle |
Тип поведения рамки формы : Sizable – обычное окно, FixedSingle – окно фиксированного размера, FixedDialog – Окно без системных кнопок «Свернуть» и «Развернуть», None – окно без заголовка |
Icon |
Значок в заголовке окна |
Location |
Координаты формы в пикселях относительно верхнего левого угла экрана |
MaximizeBox |
Системная кнопка «Развернуть». Если значение свойства равно False, то кнопка недоступна. |
MinimiseBox |
Системная кнопка «Свернуть». Если значение свойства равно False, то кнопка недоступна. |
Name |
Программное имя формы |
|
|
Opacity |
Степень прозрачности формы. 100% - форма непрозрачна (по умолчанию). Меньшее значение позволяет увидеть детали изображений, поверх которых форма располагается |
ShowDialog |
Показывает изображение формы как модальное окно. Этому окну передаётся управление (фокус). Возврат в вызывающее окно происходи при закрытии данной формы оператором Close |
Size |
Размер формы в пикселях. Width – ширина, Height – высота. |
StartPosition |
Начальное положение формы на экране: CenterScreen – в центре, Manual – положение определяется значениями свойства Location |
Text |
Текст заголовка |
Компоненты
Вот некоторые элементы управления, которые можно размещать на формах:
Label (Надпись).
Button (Кнопка).
ListBox (Список).
CheckBox (Флажок).
RadioButton (Переключатель).
MessageBox (Окно сообщений).
Menu (Меню).
TabControl (Управление вкладками).
Toolbar (Панель инструментов).
TreeView (Дерево).
DataGrid (Сетка данных).
PictureBox (Изображение).
RichTextBox (Текстовое поле с поддержкой формата RTF).
Button
командная кнопка
Свойство |
Описание |
Cursor |
Вид указателя мыши при его позиционировании на кнопке |
Enabled |
Позволяет сделать кнопку недоступной (False) или разрешить щелчок по ней (True) |
FlatStyle |
Стиль изображения кнопки: Standard - стандартная Flat - плоская Popup – всплывающая |
Font |
Шрифт надписи на кнопке |
ForeColor |
Цвет текста кнопки |
Image |
Изображение на кнопке. |
ImageAlign |
Положение картинки на кнопке. Возможные значения: MiddleCenter – в центре MiddleLeft- прижато к левой границе MiddleRight прижато к правой границе Возможны другие значения: TopLeft, TopCenter, TopRight, BottomLeft, BottomCenter, BottomRight |
ImageList |
Набор изображений, которые могут быть размещены на кнопке , если в свойстве ImageIndex установлен соответствующий индекс. К форме приложения надо добавить компонент ImageList |
ImageIndex |
Индекс изображения из набора ImageList, отображаемое на кнопке |
Location |
Координаты (в пикселях) кнопки на форме по отношению к верхнему левому углу |
Name |
Имя компонента. Используется для доступа к компоненту и его свойствам |
Size |
Размер |
Text |
Надпись на кнопке |
TextAlign |
Положение текста на кнопке: MiddleCentre в центре MiddlLeft прижат к левому краю MiddleRight прижат к правому краю Имеются и другие способы расположения текста: TopLeft, TopCentre, TopRight, BottomLeft, BottomCeter, BottomRight |
ToolTip |
Подсказка, появляющаяся через 0.5 секунды рядом с курсором при его позиционировании на кнопке Чтобы свойство стало доступным, в форму приложения надо добавить компонент ToolTip |
Visible |
Позволяет скрыть (False) кнопку или показать её (True) |
ComoBox
комбинация поля редактирования и выпадающего списка возможных значений.
Свойство |
Описание |
DropDowbStyle |
Вид компонента: DropDown – поле ввода и выпадающий список Simle - поле ввода и постоянный список DropDownList – раскрывающийся список, в поле ввода текста отсутствует |
DropDown With |
Ширина области списка |
Items |
Элементы списка (коллекция строк символов) |
Items.Count |
Количество элементов списка |
Font |
Шрифт текстов |
Location |
Координаты компонента |
MaxDropDownItems |
Количество элементов, отображаемых выпадающим списком |
Name |
Имя компонента. Используется для доступа к компоненту и его свойствам |
SelectedItem |
Выбранный пункт – объект. Чтобы его распечатать на экране, надо применить метод SelectedItem.ToString() |
SelectedIndex |
Индекс выбранного пункта. Если выбор отсутствует, то SelectedIndex = -1 |
Sorted |
Признак автоматической сортировки (TRue) |
Size |
Размер компонента |
Text |
Строка символов в поле редактирования |
Console
Системный класс, содержащий методы для работы с консольными приложениями, то есть не с графическим, а с текстовым дисплеем
Свойство |
Описание |
Title |
Заголовок консольного окна |
ForegroundColor |
Цвет текста окна |
BackgroundColor |
Цвет фона окна |
Константы, задающие цвет в консоли
|
ConsoleColor.White ConsoleColor.Black ConsoleColor.Red ConsoleColor.Blue и т.д. |
WindowHeight |
Высота окна (количество строк) |
WindowWidth |
Ширина окна (количество символов) |
|
|
Метод |
Описание |
ReadLine |
Считывает строку символов, введенную с клавиатуры |
Read |
Считывает ANSI-код нажатой клавиши. Если пользователь указал ряд символов, то возвращается код первого из них. |
WriteLine |
Начиная с новой строки, выводит на экран (или иное устройство вывода) операнды, указанные в качестве аргументов, автоматически преобразуя их в строку символов. В качестве аргументов метод может принимать строки, символы, целые и дробные числа и булевские выражения |
Write |
Выводит на экран ряд символов без перехода на новую строку. |
CheckBox
переключатель (флажок) , который может находиться в одном из двух состояний «отмеченный» или «неотмеченный»
Свойство |
Описание |
Appearance |
Вид переключателя. Normal - обычный, Button - кнопка |
CheckAlign |
Положение флажка в поле компонента. |
Checked |
Признак того, что элемент выбран (отмечен) - True |
Enabled |
Признак доступности (True) команды |
FlatStyle |
Стиль флажка. Standard - -обычный Flat - плоский ,Popup- -всплывающий |
Image |
Картинка в поле компонента |
ImageList |
Набор картинок, объект типа ImageList. Чтобы задать значения – имена файлов изображений- следует разместить на форме компонент ImageList |
ImageIndex |
Индекс картинки из списка ImageList |
Text |
Текст справа от поля отметки |
Visible |
Управляет видимостью компонента. False – невидимый, True – видимый |
CheckedListBox
список, перед каждым элементом которого находится флажок CheckBox
Свойство |
Описание |
CheckedItems |
Коллекция выбранных элементов |
CheckedItems.Count |
Количество выбранных элементов |
CheckedIndices |
Коллекция, элементы которой содержат номера выбранных пунктов |
Itemst |
Элементы списка – коллекция строк |
Items.Count |
Количество элементов списка |
MultiColumn |
Возможность показывать список в несколько колонок (True) |
Sorted |
Признак автоматической сортировки элементов списка (пунктов) после добавления очередного пункта |
ContextMenuStrip
скрытое контекстное меню, появляющееся при правом щелчке по форме или компоненту. Компонент невизуальный. Команды меню определяет значение свойства Item, являющееся коллекцией объектов MenuItem. Чтобы меню появилось при щелчке по форме или компоненту, нужно указать его имя (Name) в свойстве ContextMenuStrip этого компонента.
Свойства объекта MenuItem
Свойство |
Описание |
BackColor |
Цвет фона надписи |
Checked |
Признак того, что элемент выбран (отмечен) - True |
Enabled |
Признак доступности (True) команды |
ForeColor |
Цвет текста надписи |
Image |
Картинка в строке команды |
Text |
Команда |
GroupBox
контейнер для других компонентов
Свойство |
Описание |
Enabled |
Параметр, управляющий доступностью заключенных компонентов (True) |
Text |
Заголовок «коробочки» (компонента), поясняющий общее назначение содержащихся компонентов |
Visible |
Параметр, управляющий видимостью контейнера (True) |
ImageList
невизуальный компонент- коллекция изображений, представляющая список имен файлов с картинками
Свойство |
Описание |
ColorDepht |
Глубина цвета, - число байтов, используемых для кодирования цвета. Чем больше, тем точнее цветопередача, но и больше занимаемый объём памяти. |
ImageSize |
Размер списка картинок. Width - ширина, Height - высота. |
TransparentColor |
Прозрачный цвет (True) . Участки изображения, окрашенные этим цветом, не отображаются |
Label – надпись на форме только для чтения
Свойство |
Описание |
AutoSize |
Признак автоматического изменения размеров компонента. Если значении равно True, то при изменении размера надписи в свойстве Text, автоматически меняется размер компонента. |
BackColor |
Цвет области |
BorderStyle |
Вид рамки, ограничивающей область текста. None – рамка отсутствует, FixedSingle – тонкая рамка, Fixed3D – обычная для Windows системная рамка |
Font |
Шрифт |
ForeColor |
Цвет текста |
Location |
Координаты |
Name |
Имя компонента, используемое программой для доступа к нему. |
Size |
Размер области текста |
Техт |
Строка символов для вывода |
TextAlign |
Способ выравнивания текста в поле компонента |
ListBox - список строк для выбора, но не для ввода
Свойство |
Описание |
Font |
Шрифт |
Items |
Элементы списка – коллекция строк |
Items.Count |
Количество элементов списка |
Location |
Координаты компонента |
MultiColumn |
Возможность отображения списка в несколько колонок |
SelectedIndex |
Номер выбранного элемента |
SelectedItem |
Выбранный элемент списка – объект. Чтобы эту строку вывести на экран, надо применить к объекту метод ToString(), то есть записать SelectedItem.ToString() или SelectedItem.Text. Если выбранных элементов нет, его значение равно -1. Выражение listBox.SelectedItem эквивалентно записи listBox.Items[Listbox.SelectedIndex] |
SelectedItems |
Коллекция выбранных объектов. Чтобы обратиться (например, вывести на экран) к каждому их них, удобно использовать такой оператор: foreach(string str in listBox.SelectedItems ) MessageBox.Show(str); |
SelectionMode |
Режим выборки строк. One – только одна строка, MultiSimple – можно выбрать несколько элементов, щелкнув по нужным строкам, MultiExtended – добавляются варианты выбора за счет нажатия и удерживания клавишей Ctrl и Shift |
Size |
Размер области списка |
Sorted=<Boolean> |
Признак необходимости автоматической сортировки при работе со списком |
Text |
Все текстовые строки списка, соединённые в одну длинную строку методом конкатенации. |
Методы ListBox |
Описание |
ClearSelected() |
Очищает все выборки в ListBox и устанавливает свойство Selected в False |
CopyTo |
Копирует строки ListBox в указанный список |
FindString() |
Находит в списке Items первую строку, начинающуюся с указанной строки . Например, команда FindString (“beg”) найдет в ListBox строку, первыми символами которой являются «beg» |
FindStringExact() |
Находит в списке Items первую строку, в точности совпадающую с указанной строкой |
Focus() |
Устанавливает курсор на объект ListBox |
GetSelected() |
Возвращает объект, выделенный курсором |
Items.Add() |
Добавить элемент к списку |
Items.CopyTo() |
Копировать пункт списка |
Items.Insert() |
Вставить пункт по указанному индексу |
Items.Remove() |
Удалить выделенный пункт |
Items.RemoveAt() |
Удалить пункт, указанный индексом |
Items.ToString() |
Возвращает текст, выделенный курсором |
SetSelected() |
Устанавливает или очищает выбор элемента |
События ListBox |
Описание |
SelectedIndexChanged |
Происходит при изменении индекса выделенной строки |
MenuStrip - главное меню программы. Компонент невизуальный
Свойство |
Описание |
Enabled |
Признак доступности (True) всего меню или его отдельной строки (коменды) |
Checked |
Признак того, что пункт выбран, тогда элемент помечается галочкой. |
Font |
Шрифт |
|
|
Image |
Картинка, отображаемая рядом с названием меню или его пунктом. |
ShortCut |
Определяет «горячую» клавишу или клавишную комбинацию, нажатие которой активизирует команду |
ShowShortCut |
Если это свойство установлено в True, то после текста команды выводится эквивалентная «горячая» клавиша. |
NotifyiIcon - значок, отображаемый в системной области панели задач. при установке курсора на этот значок появляется подсказка из свойства Text, а после правого щелчка – контекстное меню ContextMenuStrip, команду которого позволяют управлять программой
Свойство |
Описание |
Icon |
значок, отображаемый в системной области панели задач |
ContextMenuStrip |
Ссылка на компонент ContextMenuStrip, отображающий контекстное меню |
|
|
Text |
Всплывающая подсказка, возникающая при позиционировании курсор на панели задач. |
Visible |
Свойство позволяет скрыть (False) значок или показать его |
NumericUpDown -компонент предназначен для ввода числовых данных. Значения в поле редактирования можно ввести с помощью цифровых клавишей ли при помощи командных кнопок, находящихся в поле редактирования «Увеличить» (стрелка вверх ) или «уменьшить» (стрелка вниз)
Свойство |
Описание |
DecimalPlaces |
Число десятичных разрядов после разделительной точки |
Increment |
Приращение значения |
Maximum |
Максимально возможное значение в поле ввода |
Minimum |
Минимально возможное значение в поле ввода |
Value |
Числовое значение в поле редактирования |
- - - - - - - - - - - - - - -Компоненты базы данных - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OpenFileDialog -компонент предназначен для поиска файла по имени с помощью средств операционной системы – Explorer (Browser)/
Свойство |
Описание |
Filter |
Свойство задает описание и фильтр (маску) имени файла. В списке отображаются только те файлы, имена которых соответствуют маске. |
FilterIndex |
Если фильтр состоит из нескольких элементов (например, Текст|*.txt|Все файлы|*.*), то значение свойства задаёт тот фильтр, который используется в момент появления диалога на экране |
FileNems |
Имя файла, выбранное из списка файлов или введённое пользователем с клавиатуры |
SafeFileName |
Собственно имя файла без указания пути |
OpenFile |
Создаёт поток, с помощью которого можно прочитать файл |
InitialDirectory |
Каталог, содержание которого отображается при первом запуске диалога , по существу – это путь к файлу |
Title |
Текст в заголовке окна. Если значение свойства не задано, то в заголовке отобразится слово «Открыть» |
Методы OpenFileDialog |
Описание |
ShowDialog() |
Обеспечивает отображение дерева файлов на экране. Функция возвращает в точку вызова значение из перечисляемого списка значений : «OK» если в диалоговом окне пользователь выбрал клавишу «Открыть» «Cancel», если была выбрана клавиша «Отмена»
|
|
|
|
|
|
|
Panel -Контейнер для других компонентов. Установив свойства контейнеры, вы тем самым одновременно устанавливает одноимённые свойства содержащихся в нём компонентов
Свойство |
Описание |
BorfderStyle |
Определяет вид границы окна панели: FixedSingle – рамка, Fixed3D - объемный бордюр, None – граница не отображается |
Doc |
Определят, к какому краю формы приклеивается панель: Left – к левой границе, Right – к правой, Top - к верхней, Bottom – к нижней. |
Enabled |
Свойство позволяет сделать недоступными (False) все компоненты панели |
Visible |
Позволяет спрятать (False) панель |
ProgressBar индикатор иллюстрирующий развитее некоторого сравнительно длительного процесса, например, копирование файлов
Свойство |
Описание |
Maximum |
Максимально допустимое значение свойства Value |
Minimum |
Минимально допустимое значение свойства Value |
Step |
Приращение изменения значения свойства Value при использовании метода PerformStep |
Value |
Значение, отображаемое в поле компонента в виде полосы, длина которой пропорциональна значению свойства Value |
PictureBox -обеспечивает отображение рисунков, фотографий и тому подобное.
Свойство |
Описание |
BorederStyle |
Вид границы компонента: None – граница не отображается, FixedSingle – рамка отображается тонкой линией, Fixed3D – рамка объёмная |
Image |
Имя файла картинки, отображающейся в поле компонента |
Image.PhisicalDimention |
Информация об истинном размере картинки |
Loaction |
Координаты компонента |
Size |
Размер компонента. |
SizeMode |
Метод масштабирования иллюстрации, если её размер не соответствует размеру компонента: Normal – масштабирование не выполняется, StrethImage – масштабирование выполняется так, чтобы оно занимало всю область компонента, AutoSize – размер компонента автоматсчески подгоняется к размеру картинки, CenterImage – если размер картинки меньше размера компонента, она центрируется в кадре, Zoom – картинка масштабируется таким образом, чтобы она занимала максимально возможную область компонента и при этом отображалась без искажения с соблюдением пропорций.
|
Visible |
Признак видимости (True) компонента |
RadioButton -кнопка в виде окружности с точкой или без неё.
Свойство |
Описание |
Appearance |
Определяет вид переключателя: Normal – обычный, Button - в виде кнопки |
AutoCheck |
Определяет, должно ли автоматически изменяться состояние кнопки при щелчке по ней. По умолчанию значение свойства True |
Checked |
Если кнопка выбрана (в ней установлена точка), свойство имеет значение True. Кнопка без точки имеет значениё False |
CheckAllign |
Положение кнопки в поле компонента : TopLeft – кнопка прижата к левой границе. Имеются и другие подобные значения |
Enabled |
Свойство позволяет сделать кнопку недоступной (False) |
FlatStyle |
Стиль кнопки: Standard – обычная, Flat – плоская, Popup – всплывающая. |
ImagListe |
Комплект картинок, используемых для обозначения различных состояний кнопки. Чтобы задать значение свойства, в форму приложения надо ввести компонент ImageList. |
ImageIndex |
Номер картинки из набора IageList |
Visible |
Позволяетя скрыть (False) кнопку |
SaveFileDialog - представляет собой стандартной диалоговое окно Сохранить, предназначенное для записи файла средствами операционной системы
– Explorer (Browser)/
Свойство |
Описание |
Filter |
Свойство задает описание и фильтр (маску) имени файла. В списке отображаются только те файлы, имена которых соответствуют маске. |
DefaultExt |
Расширение имени по умолчанию |
FileName |
Полное имя файла, заданное пользователем |
InitialDirectory |
Каталог, содержание которого отображается при первом запуске компонента. |
CheckFileExist |
Осуществляет проверку, существует ли файл с заданным именем (True) |
Title |
Текст в заголовке окна. Если значение свойства не указано, то в заголовке отображается предложение «Схранить как» |
richTextBox - текстовое окно для ввода или вывода информации в обогащенном формате
Метод |
Описание |
AppendText |
Присоединяет указанный текст к уже имеющемуся. Строки игнорируются |
Clear |
Очистка всего текста |
Copy |
Copies the current selection in the text box to the Clipboard. (Inherited from TextBoxBase.) |
Cut |
Moves the current selection in the text box to the Clipboard. (Inherited from TextBoxBase.) |
Find(array<Char>[]()[]) |
Searches the text of a RichTextBox control for the first instance of a character from a list of characters |
Focus |
Sets input focus to the control. (Inherited from Control.) |
Find(String) |
Searches the text in a RichTextBox control for a string |
Hide |
Conceals the control from the user. (Inherited from Control.) |
LoadFile(String) |
Loads a rich text format (RTF) or standard ASCII text file into the RichTextBox control. |
Paste()()() |
Replaces the current selection in the text box with the contents of the Clipboard. (Inherited from TextBoxBase.) |
SaveFile(String) |
Saves the contents of the RichTextBox to a rich text format (RTF) file |
Select(Int32, Int32) |
Selects a range of text in the text box. (Inherited from TextBoxBase.) |
ScrollToCaret |
Scrolls the contents of the control to the current caret position. (Inherited from TextBoxBase.) |
Show |
Displays the control to the user. (Inherited from Control.) |
Undo |
Undoes the last edit operation in the text box. (Inherited from TextBoxBase.) |
|
|
|
|
TextBox - текстовое окно для ввода или вывода информации
Свойство |
Описание |
Font |
Шрифт текста |
BackColor |
Цвет фона компонента |
BorfderStyle |
Вид рамки компонента: Fixed3D - обычная, FixedSingle – тонкая линия, None – отсутствует. |
Lines |
Массив строк, в поле редактирования, если указан режим Multiline |
Dock |
Способность приклеиваться к границе формы |
ForeColor |
Цвет текста в компоненте |
Location |
Координаты |
MaxLenght |
Максимальное количество символов, которое можно ввести в поле компонента. |
Multiline |
Разрешает (True) или запрещает (False) ввод нескольких строк ткста. |
Name |
Программное имя компонента |
ReadOnly |
Разрешает (False) или запрещает (True) редактировать отображаемый текст. |
PasswordChar |
Символ, который используется для отображения вводимых знаков. |
ScrollBar |
Задаёт полосу прокрутки: Horizontal – горизонтальная, Vertical – вертикальная, Both - обе полосы, None – не отображать |
Size |
Размер |
TextAllign |
Указывает, как расположить текст в окне |
ToolTip - вспомогательный компонент, используемый другим компонента для вывода подсказок при позиционировании курсора на основном компоненте. В свойствах компонента ToolTip задаются временные параметры окна подсказки, общие для всех компонентов. Конкретный многострочный текст подсказки указывается в свойстве «ToolTip on toolTip1» каждого компонента в отдельности. Это свойство появляется в списке свойств, только если предварительно на форме установлен компонент ToolTip
Свойство |
Описание |
Active |
Разрешает (True) или запрещает (False) отображение подсказок |
AutoPopDelay |
Время отображения подсказки |
InitialDelay |
Время задержки курсора на компоненте, необходимое для вызова подсказки |
ReshowDelay |
Время задержки отображения подсказки после перемещения указателя мыши с одного компонента на другой |
Timer - компонент, генерирующий последовательность событий Tick, на появление которого можно настроить автоматический запуск какого-нибудь алгоритма
Свойство |
Описание |
Interval |
Период (в миллисекундах) генерации события Tick. |
Enabled |
Разрешает (True) или запрещает (Fale) генерацию события Tick |