7.3.2. Свойства и методы объектов smo

Общие свойства объектов SMO:

• Properties — это свойство возвращает коллекцию Properties, содержащую объекты Property, представляющие свойства данного объекта. При помощи свойства Properties можно программным путем получить информацию практически о всех свойствах любого объекта SMO;

• State — при помощи этого свойства можно получить информацию о состоянии объекта SMO. Для него предусмотрено пять значений:

• Creating (0) — в настоящее время происходит создание этого объекта;

• Dropped (1) — объект в настоящее время удаляется;

• Existing (2) — нормальное состояние объекта. Он существует и ничего особенного с ним не происходит;

• Pending (3) — для этого объекта в очереди на выполнение стоит какая-то команда;

• ToBeDropped (4) — для этого объекта в очереди на выполнение стоит команда на его удаление.

• Urn — важнейшее свойство объектов SMO. Определяет имя объекта и путь к нему в иерархии объектов SQL Server в специальном формате URN (Unique Resource Name). При этом URN для любого объекта уникален. Пример URN для объекта учетная запись может выглядеть так: Server[@Name='LONDON7\SQL2008']/Login[@Name='sa'] GetSMOObject()— метод объекта SMO.Server, позволяющий находить любой объект по его адресу URN.

• UserData — это свойство можно использовать для размещения какой-либо пользовательской информации об объекте.

Общие методы объктов SMO:

• Alter() — этот метод вызывается после внесения изменений в свойства данного объекта для того, чтобы эти изменения были сохранены;

• Grant(), Deny(), Revoke() — эти методы позволяют соответственно предоставить кому-либо разрешения, наложить явный запрет и отменить ранее предоставленные разрешения и запреты на объект в иерархии SQL Server;

• Refresh() — заново получить информацию об объекте в базе данных (если он мог измениться в обход вашей программы);

• Script() — этот метод используется для генерации в соответствии с указанными вами параметрами скрипта Transact-SQL, который позволит воссоздать данный объект.

Общие свойства и методы коллекций SMO

• Count — это свойство позволяет получить информацию о количестве элементов в коллекции (например. таблиц в базе данных);

• Item — возможность получить ссылку на конкретный элемент в коллекции. Всегда можно получить такую ссылку по номеру элемента, а в большинстве случаев — еще и по его имени;

• Parent — возможность получить ссылку на родительский объект, к которому принадлежит эта коллекция;

• Contains() — этот метод позволяет проверить, находится ли в коллекции объект с указанным вами именем (иногда и другими параметрами);

• CopyTo() — возможность скопировать все элементы коллекции в одномерный массив. При этом можно определить номер для первого элемента. Можно использовать, например, если нужно получить общий список объектов из нескольких коллекций.

Для всех коллекций можно использовать синтаксическую конструкцию For Each. Во многих ситуациях она может быть очень удобна. Например, получить информацию о всех учетных записях можно так:

For Each oLogin In oSrv.Logins

MsgBox(oLogin.Name)

Next