Документация

Цель свойств объектов

Весь Доступ к данным OPC Toolbox™ возражает свойствам поддержки, которые позволяют вам управлять характеристиками объекта:

Для всех трех объектов тулбокса можно использовать те же функции тулбокса для

Просмотрите значения свойств объектов

Чтобы просмотреть все свойства объекта OPC Toolbox Data Access, с их текущими значениями, используют get функция.

Если вы не задаете возвращаемое значение, get функционируйте отображает свойства объектов в категориях, которые собирают в группу подобные свойства. Вы используете форму отображения get функционируйте, чтобы просмотреть значение всех свойств для объекта тулбокса.

Этот пример использует get функционируйте, чтобы отобразить список всех свойств dagroup OPC объект grp.

get(grp)

  General Settings:
    DeadbandPercent = 0
    GroupType = private
    Item = []
    Name = group1
    Parent = [1x1 opcda]
    Tag = 
    TimeBias = 0
    Type = dagroup
    UpdateRate = 0.5000
    UserData = []

  Callback Function Settings:
    CancelAsyncFcn = @opccallback
    DataChangeFcn = []
    ReadAsyncFcn = @opccallback
    RecordsAcquiredFcn = []
    RecordsAcquiredFcnCount = 20
    StartFcn = []
    StopFcn = []
    WriteAsyncFcn = @opccallback

  Subscription and Logging Settings:
    Active = on
    LogFileName = opcdatalog.olf
    Logging = off
    LoggingMode = memory
    LogToDiskMode = index
    RecordsAcquired = 0
    RecordsAvailable = 0
    RecordsToAcquire = 120
    Subscription = on

Просмотрите значение конкретного свойства

Чтобы просмотреть значение конкретного свойства объекта OPC Toolbox Data Access, используйте get функция, задавая имя свойства в качестве аргумента. Можно также получить доступ к значению свойства, когда вы были бы поле в структуре MATLAB^®.

Этот пример использует get функция, чтобы получить значение Subscription свойство для dagroup объект.

get(grp,'Subscription')

ans =

on

Этот пример иллюстрирует, как получить доступ к тому же свойству путем ссылки на объект, как будто это была структура MATLAB.

grp.Subscription

ans =

on

Получение информации о свойствах объектов

Чтобы получить информацию о конкретном свойстве, используйте propinfo или opchelp функции.

propinfo функция возвращает структуру, которая содержит информацию о свойстве, таком как его тип данных, значение по умолчанию и список всех возможных значений, если свойство поддерживает такой список. Этот пример использует propinfo получить информацию о LoggingMode свойство.

propinfo(grp,'LoggingMode')

ans = 

               Type: 'string'
         Constraint: 'enum'
    ConstraintValue: {'memory'  'disk'  'disk&memory'}
       DefaultValue: 'memory'
           ReadOnly: 'whileLogging'

opchelp функция возвращает справочную информацию о свойстве с полным описанием. Этот пример использует opchelp получить информацию о LoggingMode свойство.

opchelp(grp,'LoggingMode')

Установите значение свойства объекта

Чтобы установить значение конкретного свойства объекта OPC Toolbox Data Access, используйте set функция, задавая имя свойства в качестве аргумента. Можно также присвоить значение свойству, когда вы были бы поле в структуре MATLAB.

Этот пример использует set функционируйте, чтобы установить значение LoggingMode свойство.

set(grp,'LoggingMode','disk&memory')

Чтобы проверить новое значение свойства, используйте get функция.

get(grp,'LoggingMode')

ans =

disk&memory

Этот пример устанавливает значение свойства путем присвоения значения объекту, как будто это была структура MATLAB.

grp.LoggingMode = 'disk';
grp.LoggingMode

ans =

disk

Просмотрите список всех устанавливаемых свойств объектов

Чтобы просмотреть список всех свойств объекта тулбокса, который может быть установлен, используйте set функция.

set(grp)

  General Settings:
    DeadbandPercent
    Name
    Tag
    TimeBias
    UpdateRate
    UserData

  Callback Function Settings:
    CancelAsyncFcn: character vector -or- function handle -or- cell array
    DataChangeFcn: character vector -or- function handle -or- cell array
    ReadAsyncFcn: character vector -or- function handle -or- cell array
    RecordsAcquiredFcn: character vector -or- function handle -or- cell array
    RecordsAcquiredFcnCount
    StartFcn: character vector -or- function handle -or- cell array
    StopFcn: character vector -or- function handle -or- cell array
    WriteAsyncFcn: character vector -or- function handle -or- cell array

  Subscription and Logging Settings:
    Active: [ {on} | off ]
    LogFileName
    LoggingMode: [ {memory} | disk | disk&memory ]
    LogToDiskMode: [ {index} | append | overwrite ]
    RecordsToAcquire
    Subscription: [ {on} | off ]

При использовании set функционируйте, чтобы отобразить список устанавливаемых свойств, все свойства, которые имеют предопределенный набор приемлемых значений, перечисляют те значения после свойства. Значение по умолчанию заключено в фигурные скобки ({}). Например, от отображения, показанного выше, можно установить Subscription свойство для dagroup возразите против 'on' или 'off', со значением по умолчанию, являющимся 'on'. Можно установить LogFileName свойство к любому значению.