This documentation is not maintained. Please refer to doc.castsoftware.com/technologies to find the latest updates.

Summary: This document provides information about the extension providing .NET analysis support.

Extension ID

com.castsoftware.dotnet

What's new?

Please see .NET Analyzer - 1.3 - Release Notes.

Description

This extension provides support for analyzing applications built with .NET, .NET Standard and .NET Core technologies: objects and links between these objects are identified and Automated Function Point values are calculated. A set of .NET specific structural rules are also available with the extension.

Technology support

Please also see .NET - Technical notes and limitations for additional information.

Visual Studio / .NET Framework support

Visual Studio version.NET Framework version.NET Core.NET StandardC# versionVB.NET versionSupported

2003

1.1



1.27.1(tick)

2005

2.0, 3.0



2.08.0(tick)

2008

2.0, 3.0, 3.5



3.09.0(tick)

2010

2.0, 3.0, 3.5, 4.0



4.010.0(tick)
2012/20132.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2

5.012.0(tick)
20152.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6

6.014.0(tick)
20172.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2

1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1

1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.17.215.5(tick)
20192.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.21.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.11.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.18.015.8(tick)
  • The following are implicitly supported:
    • ADO.NET
    • ASP.NET
    • ASP.NET Core (up to v 3.1)
    • iFrame
    • Interop
    • WinForms
    • WPF 

LINQ support

  • LINQ to Objects
  • LINQ to DataSets
  • LINQ to SQL

Please also see .NET - Technical notes and limitations for additional information.

Xamarin support

First level of support for Xamarin (links to Xamarin API objects will be resolved) for:

  • Android
  • iOS
  • TvOS
  • WatchOS
  • UWP

Function Point, Quality and Sizing support

This extension provides the following support:

  • Function Points (transactions): a green tick indicates that OMG Function Point counting and Transaction Risk Index are supported
  • Quality and Sizing: a green tick indicates that CAST can measure size and that a minimum set of Quality Rules exist
Function Points
(transactions)
Quality and Sizing
(tick)(tick)

CAST AIP compatibility

This extension is compatible with:

CAST AIP releaseSupported
8.3.5(tick)
8.2.x(error)

Supported DBMS servers

This extension is compatible with the following DBMS servers:

CAST AIP releaseCSSOracleMicrosoft
All supported releases(tick)(tick)(tick)

Prerequisites

Required third-party software

Note that if the CAST Delivery Manager Tool (DMT) is being run (whether from the CAST AIC Portal or direct from the CAST Management Studio (CMS)) from the SAME workstation as the one used for CMS to run the analysis/snapshot generation, then any IDEs or APIs will need to be installed on the workstation running CMS so that the DMT can access them.

To successfully deliver and analyze .NET code, the following third-party software is required:

Install on workstation running the DMT (for extraction)
Install on workstation running CMS (for analysis)

Nothing required for the packing to function.

If your source code references specific frameworks or third-party packages, then these will be required on the workstation running the DMT for packaging purposes.

Some frameworks/third-party packages are shipped with the extension - see below.

.NET Framework ≥ 4.7.2 must be installed in order for the analysis to function. A check will be done when the analysis starts and a message will produced if the minimum .NET Framework cannot be found.

Note that a .NET Framework is installed with the AIP Core setup, however this may not be the required version. Please check.


Location of the source code deployment folder

In the case of .NET analyses the Deployment folder should always be located on the same machine as the AIP Node. If the Deployment folder is located on a remote network file share, there is a risk that assemblies may not be loaded correctly during the analysis, causing external objects to not be saved.

Location of extensions folder

If you have altered the location where extensions are stored to a network location remote to the analysis machine (for example changing CAST_PLUGINS_ROOT_PATH - see Configure AIP Node storage folder locations - optional - v. 1.x) then you will need to add the following lines to the .NET Framework machine.config file (located on the machine where the analysis is being run). This is to ensure that the .NET Analyzer DLLs located in the remote network folder can be successfully run from a network location. The analysis will fail without this configuration.

Replace the following tag:

<runtime />

with:

<runtime>
	<loadFromRemoteSources enabled="true"/>
</runtime>

Dependent frameworks and third-party packages provided in the extension

Some dependent frameworks and third-party packages are provided in the extension itself. There is therefore no need to specifically package these items if your source code relies on them - note however, that the DMT will generate missing library/assembly alerts for these items - these alerts can safely be ignored.

Frameworks

  • .NET framework
  • .NET Core
  • .NET standard
  • Silverlight
  • Universal Windows Platform
  • Mono Android
  • Xamarin iOS
  • Xamarin TvOS
  • Xamarin WatchOS

Third-party packages

  • Microsoft.AspNetCore.All (ASP.NET)
  • Microsoft.AspNetCore.App (ASP.NET)
  • log4net
  • NHibernate
  • NPersistence
  • NLog
  • Newtonsoft.Json
  • Newtonsoft.Json.Bson
  • MySql.Data
  • Iesi.Collections
  • EntityFramework
  • Microsoft.Practices.EnterpriseLibrary.2008
  • elmah.corelibrary
  • System.Data.SqlClient
  • Serilog
  • Remotion.Linq
  • Xamarin.Android.Support.v7.AppCompat
  • Xamarin.Android.Support.v7.CardView
  • Xamarin.Android.Support.v7.MediaRouter
  • Xamarin.Android.Support.v4
  • Xamarin.Android.Support.Media.Compat
  • Xamarin.Android.Support.Fragment
  • Xamarin.Android.Support.Design
  • Xamarin.Android.Support.Core.Utils
  • Xamarin.Android.Support.Core.UI
  • Xamarin.Android.Support.Wear
  • Xamarin.Android.Wear
  • Xamarin.Forms

Dependencies with other extensions

Some CAST AIP extensions require the presence of other CAST AIP extensions in order to function correctly. The .NET Analyzer extension requires that the following other CAST AIP extensions are also installed:

Note that when using the CAST Extension Downloader to download the extension and the Manage Extensions interface in CAST Server Manager to install the extension, any dependent extensions are automatically downloaded and installed for you. You do not need to do anything.

Download and installation instructions

A specific version of the .NET Analyzer extension is shipped with AIP Core. However, this release may not be the release you want to use, therefore you should check before beginning the analysis that the correct extension release is being used. You can see the list of shipped extensions for each release of AIP Core here: Technology coverage changes in CAST AIP 8.3.x.

If you need to change the release use the Included interface in AIP Console:

Application qualification information

Please see: .NET - Qualification.

Prepare and deliver the source code

Please see: .NET - Prepare and deliver the source code

Analysis configuration and execution

Please see: .NET - Analysis configuration and execution and all child pages:

What analysis results can you expect?

Please see: .NET - Analysis results

Structural rules

The vast majority of rules provided for the .NET Analyzer are embedded in CAST AIP - see .NET - Structural rules for more information. In addition, some rules are also provided with the extension: