.NET Recording Filter pane [.NET protocol]
This pane enables you to manage .NET filters, only visible for .NET protocol scripts.
UI Example | ![]() |
To access | View > .NET Recording Filter or the Show .NET Recording Filter toolbar button ![]() |
See also |
User interface elements are described below (unlabeled elements are shown in angle brackets):
UI Element
|
Description
|
---|---|
<Filter List> |
A list of the recording filters.
|
<Filter Tree> |
The Filter tree uses symbols to illustrate the elements and their status. For details about each of the icons, see the table below.
|
New |
Opens the Create a New Filter dialog box, in which you create an empty filter or a new filter based on an existing one. For more information, see Create a New Filter dialog box [.NET protocol].
|
Save |
Saves the changes you made to filter.
|
Delete |
Deletes the selected custom filter. The filter pane prompts you for a confirmation.
|
Add Reference |
Opens the Add Reference dialog box with a list of .NET Framework components or assemblies in the Public Assemblies folder. For more information, see Add Reference dialog box [.NET protocol]. Note: If you add a reference to a DLL for a .NET filter, VuGen adds it to the script's reference list only if the script accesses the DLL's methods during recording. |
Remove Reference |
Removes the assembly that is selected in the Filter pane and disables all of the rules associated with it. All disabled rules are enabled after adding the reference to this assembly once again. The Filter mechanism prompts you for a confirmation. |
|
Include. Includes the selected element. If you manually include a parent node, the filter mechanism includes the child elements below it, provided that no other rule exists. For example, if you include a class, it will include all its methods unless you specifically excluded a method.
|
|
Exclude. Excludes the selected element. The child elements are also excluded unless they were included by another rule. By default, when you exclude a class, the filter mechanism applies the Exclude attribute to the class, but it allows the recording engine to record activity within the methods of the excluded class. When you exclude a method, however, the filter mechanism applies Totally Exclude, preventing the recording engine from recording any activity within the methods of the excluded class. Advanced users can modify these setting in the filter file.
|
|
Reset. Removes the manual inclusion or exclusion rule. In this case, the element may be impacted by other parent elements.
The inclusion and exclusion rules have the following properties:
Note: The resetting of a parent node does not override a manual inclusion or exclusion applied to a child node. For example, if you manually exclude a method, and then reset its class, which by default included all sub-nodes, your method remains excluded. Properties and events are view-only and cannot be included or excluded through the .NET Recording Filter pane. In addition, several system related elements are protected and may not be altered.
For tips about including and excluding elements in the filter, see Guidelines for setting .NET filters.
|
![]() |
Navigate. Navigates to the previous or next tree node visited by the user.
|
![]() |
Show non-public items. By default, the filter tree shows only public classes and class members. By clicking this button, you instruct the tree view to display non-public items. If you include a class which contains non-public items, they are not added to the filter automatically. You must explicitly include each non-public item to the filter. |
Impact Log |
Opens the Impact log for the selected filter. The Impact log shows which nodes in the tree were affected by recent actions.
|
The following table shows the filter tree icons that represent the various elements:
Icon
|
Description
|
Icon
|
Description
|
---|---|---|---|
![]() |
assembly
|
![]() |
interface
|
![]() |
assembly that couldn't be loaded
|
![]() |
method
|
![]() |
assembly that was partially loaded
|
![]() |
static method
|
![]() |
class
|
![]() |
namespace
|
![]() |
constructor
|
![]() |
property
|
![]() |
static constructor
|
![]() |
static
property |
![]() |
event
|
![]() |
structure
|
![]() |
static event
|