IPWorks SNMP 2020 .NET Edition

Questions / Feedback?

MibBrowser Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

MibBrowser Configuration Settings

AutoLoadMibs:   Determines whether imported MIB modules are loaded automatically.

When True (default), the component will attempt to automatically load MIB imports. Only the path of the current module will be searched.

CacheDescriptions:   Controls caching of Node descriptions.

The default value is True.

When False, the component will only save the offset of the description in the MIB file in memory, and will fetch the textual description directly from the file only when required.

When using caching, make sure that the path of the loaded modules does not change or the property will be unable to fetch the correct text description.

CacheMibs:   Controls MIB module caching.

If set to True (default), a file will never be loaded/parsed more than once.

CheckNoKnownRoots:   Controls whether or not the component fails when a file with no known root is loaded.

If set to true the component will fail with an error when LoadMib is called and no root node can be found for the nodes defined in the file. When this value is False (default), Error will fire with this alert.

DisplayHint:   The DISPLAY-HINT property for the current node.

This is set to the DISPLAY-HINT property for the current node specified in NodeIndex.

Note that this config is read only.

MibExtensions:   Controls the file extensions that the component will search for.

When loading a MIB file with AutoLoadMibs enabled, this configuration setting controls what file extensions the component will search to find imported symbols. The default value is ".mib", which means the component will search files with a .mib extension or with no extension. If you set the value to ".txt, .mib", it will also search files with a .txt extension.

NodeIsColumnar:   Whether the current node is columnar.

This setting may be queried after calling SelectNode or within the MibNode event to determine if the current node is columnar.

NodeIsScalar:   Whether the current node is scalar.

This setting may be queried after calling SelectNode or within the MibNode event to determine if the current node is scalar.

ReturnEnumValues:   Comma-separated list of the current node's enumeration textual-conventions.

If set to true, and the current node references an enumeration textual-convention, then the values of the enumeration will be returned in the following format:

"label1(Value), label2(Value), label3(Value)..."

UndefinedSymbols:   Comma-separated list of nodes that have not been resolved.

For more information, please refer to the LoadMib method.

Base Configuration Settings

BuildInfo:   Information about the product's build.

When queried, this setting will return a string containing information about the product's build.

GUIAvailable:   Tells the component whether or not a message loop is available for processing events.

In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation.

In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GUIAvailable to false will ensure that the component does not attempt to process external events.

LicenseInfo:   Information about the current license.

When queried, this setting will return a string containing information about the license this instance of a component is using. It will return the following information:

  • Product: The product the license is for.
  • Product Key: The key the license was generated from.
  • License Source: Where the license was found (e.g. RuntimeLicense, License File).
  • License Type: The type of license installed (e.g. Royalty Free, Single Server).
UseInternalSecurityAPI:   Tells the component whether or not to use the system security libraries or an internal implementation.

By default the component will use the system security libraries to perform cryptographic functions. When set to False calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal implementation instead of using the system's security API.

Note: This setting is static. The value set is applicable to all components used in the application.

When this value is set the product's system DLL is no longer required as a reference, as all unmanaged code is stored in that file.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks SNMP 2020 .NET Edition - Version 20.0 [Build 8202]