Объект WScript
Свойства | Описание |
---|---|
Timeout | Время в секундах, по истечении которого скрипт будет автоматически остановлен. |
Name | Наименование сервера сценариев. |
FullName | Полный путь к исполняемому файлу сервера сценариев. |
Path | Полный путь к каталогу исполняемого файла сервера сценариев |
Version | Версия сервера сценариев. |
BuildVersion | Номер сборки сервера сценариев. |
ScriptName | Имя запущенного файла скрипта. |
ScriptFullName | Полный путь к запущенному файлу скрипта. |
StdIn | Объект "TextStream", соответствующий стандартному входному потоку. |
StdOut | Объект "TextStream", соответствующий стандартному выходному потоку. |
StdErr | Объект "TextStream", соответствующий стандартному потоку ошибок. |
Arguments | Объект "WshArguments" имеет ряд свойств и методов, позволяющих обращаться к именным и безымянным параметрам. |
Interactive | Режим запуска скрипта - запрещён (False) или разрешён (True) диалог с пользователем. |
Методы | Описание |
Sleep | Приостановка исполнения скрипта на указанное количество миллисекунд. |
Quit | Завершение исполнения скрипта с указанным кодом возврата. |
Echo | Вывод сообщения в окно MessageBox (если скрипт был запущен с помощью WScript.exe) или на консоль (если скрипт был запущен с помощью CScript.exe). |
CreateObject | Создает программный объект автоматизации. |
ConnectObject | Устанавливает соединение с объектом автоматизации для обработки его событий. |
DisconnectObject | Разрывает соединение с объектом автоматизации. |
Объект WScript. Создание объекта.
Тут совсем просто)). Объект WScript можно использовать в сценарии сразу, без его создания, т.к. его экземпляр создаётся сервером сценариев (CScript.exe или WScript.exe) автоматически.Объект WScript. Свойство Timeout.
Время в секундах, по истечении которого скрипт будет автоматически остановлен.Замечание: чтение и запись.
Следует отметить, что при запуске сценариев из командной строки есть параметр //T который ограничивает максимальное время работы скрипта. Подробнее о параметрах запуска скриптов смотрите здесь.
WScript.Timeout = 5
Если время исполнения скрипта превысит 5 секунд, он будет завершен.
Объект WScript. Свойство Name.
Наименование сервера сценариев.
MsgBox "Name=" & WScript.Name
В моем случае результат был Windows Script Host.
Объект WScript. Свойство FullName.
Полный путь к исполняемому файлу сервера сценариев.
MsgBox "FullName=" & WScript.FullName
В моем случае результат был c:\windows\system32\WScript.exe
Объект WScript. Свойство Path.
Полный путь к каталогу исполняемого файла сервера сценариев.
MsgBox "Path=" & WScript.Path
В моем случае результат был c:\windows\system32
Объект WScript. Свойство Version.
Версия сервера сценариев.Замечание: только чтение.
MsgBox "Version=" & WScript.Version
Объект WScript. Свойство BuildVersion.
Номер сборки сервера сценариев.Замечание: только чтение.
MsgBox "BuildVersion=" & WScript.BuildVersion
Объект WScript. Свойство ScriptName.
Имя запущенного файла скрипта.Замечание: только чтение.
MsgBox "ScriptName=" & WScript.ScriptName
Объект WScript. Свойство ScriptFullName.
Полный путь и имя запущенного файла скрипта.Замечание: только чтение.
MsgBox "ScriptFullName=" & WScript.ScriptFullName
Объект WScript. Свойство StdIn.
Возвращает объект "TextStream", соответствующий стандартному входному потоку.Замечание: свойство доступно только если скрипт был запущен с помощью CScript.exe.
WScript.StdOut.Write "Input: "
s = WScript.StdIn.ReadLine
MsgBox s
Объект WScript. Свойство StdOut.
Возвращает объект "TextStream", соответствующий стандартному выходному потоку.Замечание: свойство доступно только если скрипт был запущен с помощью CScript.exe.
WScript.StdOut.Write "Input: "
s = WScript.StdIn.ReadLine
MsgBox s
Объект WScript. Свойство StdErr.
Возвращает объект "TextStream", соответствующий стандартному потоку ошибок.Замечание: свойство доступно только если скрипт был запущен с помощью CScript.exe.
WScript.StdErr.Write "Hello, StdErr!"
В командном окне (cmd) введите CScript.exe tst2.vbs
где tst2.vbs - имя, под которым сохранили предыдущий пример. Стандартный поток ошибок будет выведен на экран, где вы и увидите сообщение.
Объект WScript. Свойство Arguments.
Возвращает объект "WshArguments", который имеет ряд свойств и методов, позволяющих обращаться к именным и безымянным параметрам. Более подробно работа с параметрами описана здесь.Объект WScript. Свойство Interactive.
Режим запуска скрипта - запрещён (False) или разрешён (True) диалог с пользователем.Это свойство позволяет определять в каком режиме был запущен скрипт ( //B - Пакетный режим или //I - Диалоговый режим. Подробнее о параметрах запуска скриптов смотрите здесь). Свойство позволяет так же переопределить этот режим.
Замечание: чтение и запись.
WScript.Interactive = False
Объект WScript. метод Sleep.
Приостановка исполнения скрипта на указанное количество миллисекунд.
MsgBox Start
WScript.Sleep 1000
MsgBox After Sleep 1000
Объект WScript. метод Quit.
Завершение исполнения скрипта с указанным кодом возврата.Параметры: ErrorCode - необязательный, число, код возврата приложения.
WScript.Quit 10
Объект WScript. метод Echo.
Вывод сообщения в окно MessageBox (если скрипт был запущен с помощью WScript.exe) или на консоль (если скрипт был запущен с помощью CScript.exe).Если аргументы не заданы, будет выведена пустая строка. Перечисленные через запятую аргументы при выводе будут разделены пробелами. В случае использования CScript.exe вывод будет завершён символом новой строки
WScript.Echo "Это Ваш пароль q1w2e3r4 ?",vbCrLf,"Не теряйте больше!"
Объект WScript. метод CreateObject.
Синтаксис:CreateObject(ProgID [,Prefix])
где ProgID - строка, программный идентификатор объекта (ProgID).
Prefix - необязательный, префикс функций-обработчиков событий
Set WshNetwork = WScript.CreateObject("WScript.Network")
Объект WScript. метод ConnectObject.
Устанавливает соединение с объектом автоматизации для обработки его событий.Синтаксис:
ConnectObject(Obj [,Prefix])
где Obj - объект.
Prefix - необязательный, префикс функций-обработчиков событий
Объект WScript. метод DisconnectObject.
Разрывает соединение с объектом автоматизации (созданное ранее для обработки его событий).Синтаксис:
DisconnectObject(Obj)
где Obj - объект.
Объект WScript. Объект WshArguments.
Как уже упоминалось, свойство Arguments возвращает объект WshArguments. Настало время рассмотреть этот объект. Сразу хотелось бы отметить, что практическая сторона вопроса - работа с объектом рассмотрена на другой странице этого проекта - WSH. Обработка аргументов.Свойства | Описание |
---|---|
Item | Возвращает значение n-ного элемента коллекции. |
Length | Возвращает значение количества элементов коллекции (аргументов). |
Named | Возвращает коллекцию именных (именованных) параметров. |
Unnamed | Возвращает коллекцию безымянных параметров. |
Методы | Описание |
Count | В возвращает число элементов коллекции (количество аргументов). |
ShowUsage | Выводит информацию о запуске и назначении сценария (описание аргументов, пример запуска). |
Объект WshArguments. Создание объекта.
Объект WshArguments создается свойством Arguments.
Set WshArg = WScript.Arguments
Объект WScript. Свойство Item.
Синтаксис:Item(Index)
где Index - номер элемента в коллекции.
Возвращаемое значение - элемент коллекции.
Только чтение.
Объект WScript. Свойство Length.
Синтаксис:Length
Параметров нет.
Возвращаемое значение - число элементов коллекции (количество аргументов, переданных скрипту).
Только чтение.
Объект WScript. Свойство Named.
Синтаксис:Named
Параметров нет.
Возвращаемое значение - коллекция именных (именованных) параметров, переданных скрипту).
Только чтение.
Объект WScript. Свойство Unnamed.
Синтаксис:Length
Параметров нет.
Возвращаемое значение - коллекция безымянных (не именованных) параметров, переданных скрипту).
Только чтение.
Объект WScript. Метод Count.
Синтаксис:Count
Параметров нет.
Возвращает число элементов коллекции (количество аргументов, переданных скрипту).
Только чтение.
Объект WScript. Метод ShowUsage.
Синтаксис:ShowUsage
Параметров нет.
Если сценарий размещен в XML файле специального формата с расширением .wsf (Windows Script file) и в этом файле в разделе <runtime>, присутствуют элементы <description>, <unnamed,> <named>, <example или <usage> то значения этих элементов будет выведено так же как и при запуске скрипта с параметром /?.
Только чтение.
If WScript.Arguments.Count <> 1 Then
WScript.Arguments.ShowUsage
WScript.Quit
End If
Еще раз напоминаю, что примеры работы с аргументами рассмотрены на другой странице этого проекта - WSH. Обработка аргументов.
За более подробной информацией обращайтесь в MSDN. На момент написания страницы это было здесь.
Для вопросов, обсуждений, замечаний, предложений и т. п. можете использовать раздел форума этого сайта (требуетс¤ регистраци¤).