Функция CallByName

Статья
11/05/2008

Обновлен: Ноябрь 2007

Выполняет метод на объекте или устанавливает/возвращает свойство объекту.

Public Function CallByName( _
   ByVal ObjectRef As System.Object, _
   ByVal ProcName As String, _
   ByVal UseCallType As CallType, _
   ByVal Args() As Object _
) As Object

Параметры

ObjectRef
Обязательный параметр. Object. Указывает на объект, к которому относится данное свойство или метод.
ProcName
Обязательный параметр. String. Строковое выражение, содержащее имя свойства или метода объекта.
UseCallType
Обязательный параметр. Член перечисления типа Перечисление CallType, представляющий тип вызываемой процедуры. Значение CallType может быть Method, Get или Set.
Args
Необязательно. ParamArray. Массив параметров, который содержит аргументы, передаваемые в вызываемый метод или свойство.

Исключения

Тип исключения	Номер ошибки	Условия
ArgumentException	5	Недопустимое значение UseCallType; должно быть Method, Get или Set.

См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако по возможности следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.

Заметки

Функция CallByName используется во время выполнения программы для получения или возврата свойства или вызова метода.

Пример

В первой строке следующего примера функция CallByName используется для установки свойства Text текстового поля; во второй строке она извлекает значение свойства Text, а в третьей строке вызывает метод Move для перемещения текстового поля.

' Imports statements must be at the top of a module.
Imports Microsoft.VisualBasic.CallType

Sub TestCallByName1()
    'Set a property.
    CallByName(TextBox1, "Text", CallType.Set, "New Text")

    'Retrieve the value of a property.
    MsgBox(CallByName(TextBox1, "Text", CallType.Get))

    'Call a method.
    CallByName(TextBox1, "Hide", CallType.Method)
End Sub

В следующем примере используется функция CallByName для вызова метода Add или Item объекта коллекции.

Public Sub TestCallByName2()
    Dim col As New Collection()

    'Store the string "Item One" in a collection by 
    'calling the Add method.
    CallByName(col, "Add", CallType.Method, "Item One")

    'Retrieve the first entry from the collection using the 
    'Item property and display it using MsgBox().
    MsgBox(CallByName(col, "Item", CallType.Get, 1))
End Sub

Примечание для разработчиков Smart Device

Эта функция не поддерживается.

Требования

Пространство имен: Microsoft.VisualBasic

Модуль: Interaction

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

См. также

Основные понятия

Массивы параметров

Вызов свойства или метода с помощью строкового имени

Ссылки

Перечисление CallType

ArgumentException

Поделиться через