System.Runtime Schema: Method Details
Continuing on my series of “Exploring relational schema for .NET assemblies in SQL Server Modeling Services”, in this post I will drill-into entities related to ‘methods’.
Type definitions are made up of methods. A method is a subroutine defined within a type that contains a sequence of statements to perform an action. It is analogous to an “operation”. It contains a set of input and output parameters and possibly a return value. Some of the types of methods are: abstract method, constructors, destructors, accessor method and static method. Methods can be overridden by another type to provide a specific implementation for the method.
The following ER diagram shows the relationship between different entities related to the definition of a CLR method.
Method Definitions
The MethodDefinitions entity represents details for a method definition for a type in an assembly. Let’s say you have a method “int add (int a, int b)” defined in Calculator type in Calculator assembly. When the Calculator assembly is loaded into a SQL Server Modeling Services System.Runtime database, the MethodDefinitions table is populated with the add method details. If a Calculator type was calling a method that’s defined in another assembly, that knowledge is stored in CalledMethods and MethodReferences tables. Check out the MethodDefinitions.m and Methods.m for attribute details.
Note: You can further scope these queries by assemblies and folders.
Description |
T-SQL Query |
Show all abstract methods in the repository |
SELECT * FROM [Repository].System_Runtime.MethodDefinitions WHERE IsAbstract = 1 |
Show all methods that return ‘System.Exception’ |
SELECT MD.* FROM [Repository].System_Runtime.MethodDefinitions AS MD INNER JOIN [Repository].System_Runtime.Types AS T ON MD.ReturnType = T.Id WHERE T.QualifiedName = 'System.Exception' |
Show the count of methods grouped by its access (public, private, etc.) |
SELECT Access, COUNT(*) FROM [Repository].System_Runtime.MethodDefinitions GROUP BY Access |
Method Parameters
As the name suggests, the Parameters entity captures the parameters for the methods. Check out Parameters.m, MethodDefinitions.m and Method.m for attribute details.
Note: You can further scope these queries by assemblies and folders.
Description |
T-SQL Query |
Show all method parameters in the repository that have type beginning with ‘System.’ |
SELECT T.QualifiedName, MD.* FROM [Repository].System_Runtime.Parameters AS P INNER JOIN [Repository].System_Runtime.MethodDefinitions AS MD ON P.Method = MD.Id INNER JOIN [Repository].System_Runtime.Types AS T ON P.Type = T.Id WHERE T.QualifiedName like 'System.%' |
Show all method parameters types and number of times they are being defined in the method definition |
SELECT T.QualifiedName, Count(MD.Id)AS ParameterCount FROM [Repository].System_Runtime.Parameters AS P INNER JOIN [Repository].System_Runtime.MethodDefinitions AS MD ON P.Method = MD.Id INNER JOIN [Repository].System_Runtime.Types AS T ON P.Type = T.Id GROUP BY T.QualifiedName |
Show all method parameters that are “out” parameters and have type beginning with ‘System.’ |
SELECT T.QualifiedName, P.* FROM [Repository].System_Runtime.Parameters AS P INNER JOIN [Repository].System_Runtime.MethodDefinitions AS MD ON P.Method = MD.Id INNER JOIN [Repository].System_Runtime.Types AS T ON P.Type = T.Id WHERE T.QualifiedName like 'System.%' AND P.IsOutParameter = 1 |
Delegates and Events
Delegates and Events are how CLR implements the Observer design pattern. The Observer pattern defines one-to-many dependency between objects so that when on object (publisher) changes state, all its dependents (subscribers) are notified and updated automatically. This allows for loose coupling between the publishers and subscribers, so that the publishing code can change without breaking any of the subscriber code. In .NET, the events are properties of the type publishing the event.
Description |
T-SQL Query |
Show all types that contain virtual events declared along with their add and remove methods |
SELECT T.QualifiedName, E.Name AS EventName, AM.Name as AddMethod, RM.Name as RemoveMethod FROM [Repository].System_Runtime.Events AS E INNER JOIN [Repository].System_Runtime.MethodDefinitions AS AMD ON AMD.Id = E.AddMethod INNER JOIN [Repository].System_Runtime.Methods AS AM ON AM.Id = AMD.Id INNER JOIN [Repository].System_Runtime.MethodDefinitions AS RMD ON RMD.Id = E.RemoveMethod INNER JOIN [Repository].System_Runtime.Methods AS RM ON RM.Id = RMD.Id INNER JOIN [Repository].System_Runtime.Types AS T ON T.Id = E.DeclaringType WHERE E.IsVirtual = 1 |
To try these queries out, just load your .NET application's assemblies in the SQL Server Modeling Services database and happy analyzing!