FirstMatchCodeGroup.ResolveMatchingCodeGroups(Evidence) Method

Definition

Namespace:

System.Security.Policy

Assembly:

System.Security.Permissions.dll

Package:

System.Security.Permissions v9.0.0-preview.3.24172.9

Source:

FirstMatchCodeGroup.cs

Resolves matching code groups.

public:
 override System::Security::Policy::CodeGroup ^ ResolveMatchingCodeGroups(System::Security::Policy::Evidence ^ evidence);

public override System.Security.Policy.CodeGroup ResolveMatchingCodeGroups (System.Security.Policy.Evidence evidence);

override this.ResolveMatchingCodeGroups : System.Security.Policy.Evidence -> System.Security.Policy.CodeGroup

Public Overrides Function ResolveMatchingCodeGroups (evidence As Evidence) As CodeGroup

Parameters

evidence

Evidence

The evidence for the assembly.

Returns

CodeGroup

A CodeGroup that is the root of the tree of matching code groups.

Exceptions

ArgumentNullException

The evidence parameter is null.

Examples

The following code shows the use of the ResolveMatchingCodeGroups method to resolve matching code groups. This code example is part of a larger example provided for the FirstMatchCodeGroup class.

Assembly^ assembly = Members::typeid->Assembly;
Evidence^ evidence = assembly->Evidence;
CodeGroup^ resolvedCodeGroup =
   codeGroup->ResolveMatchingCodeGroups( evidence );

Assembly assembly = typeof(Members).Assembly;
Evidence evidence = assembly.Evidence;
CodeGroup resolvedCodeGroup = 
    codeGroup.ResolveMatchingCodeGroups(evidence);

Dim executingAssembly As [Assembly] = Me.GetType().Assembly
Dim evidence As Evidence = executingAssembly.Evidence
Dim resolvedCodeGroup As CodeGroup
resolvedCodeGroup = codegroup.ResolveMatchingCodeGroups(Evidence)

Remarks

Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a root code group. The code group that is returned contains child code groups, which in turn can have child code groups as necessary to reflect the complete set of code groups that were matched by the evidence provided.

For first-match code groups, each child code group's membership condition is tested against the evidence in the order in which they were added; only the first match is resolved with the evidence set. If there are no matches, the policy statement of the parent first-match code group applies. The matching child code group type determines how all child groups under it are applied, depending on how the ResolveMatchingCodeGroups methods of these child groups work.