Microsoft.VisualStudio.TestPlatform.ObjectModel

Specifies the user specified RunSettings and framework provided context of the discovery.

Runsettings specified for this request.

Handle to the framework which is passed to the test executors.

Gets or sets a value indicating whether the execution framework enables the shutdown of execution process after the test run is complete. This should be used only in out of process test runs when IRunContext.KeepAlive is true and should be used only when absolutely required as using it degrades the performance of the subsequent run. It throws InvalidOperationException when it is attempted to be enabled when keepAlive is false.

Launch the specified process with the debugger attached.

File path to the exe to launch. Working directory that process should use. Command line arguments the process should be launched with. Environment variables to be set in target process Process ID of the started process.

Handle to the framework which is passed to the test executors.

Attach debugger to an already running process.

Process ID of the process to which the debugger should be attached. if the debugger was successfully attached to the requested process, otherwise.

It provides user specified runSettings and framework provided context of the run.

Whether the execution process should be kept alive after the run is finished or not.

Whether the execution is happening in InProc or outOfProc

Whether the data collection is enabled or not

Whether the test is being debugged or not.

Test case filter for user specified criteria which has been validated for 'supportedProperties'. It is used only with sources. With specific test cases it will always be null. If there is a parsing error or filter expression has unsupported properties, TestPlatformFormatException() is thrown.

Directory which should be used for storing result files/deployment files etc.

Solution Directory.

Used for loading settings for a run.

Get the settings for the provided settings name.

Name of the settings section to get. The settings provider for the settings or null if one was not found.

Settings used for this run.

Interface implemented to provide a section in the run settings. A class that implements this interface will be available for use if it exports its type via MEF, and if its containing assembly is placed in the Extensions folder.

Load the settings from the reader.

Reader to load the settings from.

TestCaseDiscovery sink is used by discovery extensions to communicate test cases as they are being discovered, and various discovery related events.

Callback used by discovery extensions to send back testcases as they are being discovered.

New test discovered since last invocation.

It represents expression for filtering test cases.

Gets original string for test case filter.

Matched test case with test case filtering criteria.

Interface implemented to provide tests to the test platform.

A class that implements this interface will be available for use if its containing assembly is either placed in the Extensions folder or is marked as a 'UnitTestExtension' type in the vsix package. Provide one or more s on the implementing class to indicate the set of file extensions that are supported for test discovery. If the discoverer supports discovering tests present inside directories, provide instead. If neither nor is provided, the discoverer will be called for all relevant test files and directories.

Discovers the tests available from the provided source.

Collection of test containers. Context in which discovery is being performed. Logger used to log messages. Used to send testcases and discovery related events back to Discoverer manager.

Used for recording test results and test messages.

Notify the framework about the test result.

Test Result to be sent to the framework. Exception thrown by the framework when an executor attempts to send test result to the framework when the test(s) is canceled.

Notify the framework about starting of the test case. Framework sends this event to data collectors enabled in the run. If no data collector is enabled, then the event is ignored.

testcase which will be started.

Notify the framework about completion of the test case. Framework sends this event to data collectors enabled in the run. If no data collector is enabled, then the event is ignored.

testcase which has completed. outcome of the test case.

Notify the framework about run level attachments.

attachments produced in this run.

Defines the test executor which provides capability to run tests. A class that implements this interface will be available for use if its containing assembly is either placed in the Extensions folder or is marked as a 'UnitTestExtension' type in the vsix package.

Runs only the tests specified by parameter 'tests'.

Tests to be run. Context to use when executing the tests. Handle to the framework to record results and to do framework operations.

Runs 'all' the tests present in the specified 'sources'.

Path to test container files to look for tests in. Context to use when executing the tests. Handle to the framework to record results and to do framework operations.

Cancel the execution of the tests.

Indicates whether or not the default test host process should be attached to.

Path to test container files to look for tests in. Context to use when executing the tests. if the default test host process should be attached to, otherwise.

Indicates whether or not the default test host process should be attached to.

Tests to be run. Context to use when executing the tests. if the default test host process should be attached to, otherwise.

Exception thrown on parsing error in user provided filter expression. This can happen when filter has invalid format or has unsupported properties.

Creates a new TestPlatformFormatException

Initializes with the message.

Message for the exception.

Initializes with the message and filter string.

Message for the exception. Filter expression.

Initializes with message and inner exception.

Message for the exception. The inner exception.

Serialization constructor.

Filter expression.

Serialization helper.

Serialization info to add to not used

Exception thrown by the framework when an executor attempts to send test result to the framework when the test is canceled.

Creates a new TestCanceledException

Initializes with the message.

Message for the exception.

Initializes with message and inner exception.

Message for the exception. The inner exception.

Serialization constructor.

Represents a set of attachments.

URI of the sender. If a data-collector is sending this set, then it should be uri of the data collector. Also if an executor is sending this attachment, then it should be uri of executor.

Name of the sender.

List of data attachments. These attachments can be things such as files that the collector/adapter wants to make available to the publishers.

Defines the data attachment. Dev10 equivalent is UriDataAttachment.

Description of the attachment.

Uri of the attachment.

Defines the discovery criterion.

Initializes a new instance of the class.

This constructor doesn't perform any parameter validation, it is meant to be used for serialization."/>

Initializes a new instance of the class.

Sources from which the tests should be discovered. Frequency of discovered test event. This is used for batching discovered tests. Test configuration provided by user.

Initializes a new instance of the class.

Sources from which the tests should be discovered Frequency of discovered test event. This is used for batching discovered tests. Timeout that triggers the discovered test event regardless of cache size. Run Settings for the discovery.

Initializes a new instance of the class.

Gets the test Containers (e.g. DLL/EXE/artifacts to scan)

Gets the test Containers (e.g. .appx, .appxrecipie)

Gets the test adapter and source map which would look like below:


            { C:\temp\testAdapter1.dll : [ source1.dll, source2.dll ], C:\temp\testadapter2.dll : [ source3.dll, source2.dll ]

Gets the frequency of discovered test event.

Discovered test event will be raised after discovering these number of tests. Note that this event is raised asynchronously and the underlying discovery process is not paused during the listener invocation. So if the event handler, you try to query the next set of tests, you may get more than 'FrequencyOfDiscoveredTestsEvent'.

Gets the timeout that triggers the discovered test event regardless of cache size.

Gets the test settings used for the discovery request.

Gets or sets the criteria for filtering test cases.

Gets or sets the test session info object.

Event arguments used to notify the availability of new tests

Tests discovered in this discovery request

Event arguments used on completion of discovery

Constructor for creating event args object

Total tests which got discovered Specifies if discovery has been aborted.

Indicates the total tests which got discovered in this request.

Specifies if discovery has been aborted. If true TotalCount is also set to -1.

Metrics

Gets or sets the list of sources which were fully discovered.

Gets or sets the list of sources which were partially discovered (started discover tests, but then discovery aborted).

Gets or sets the list of sources that were skipped during discovery.

Gets or sets the list of sources which were not discovered at all.

Gets or sets the collection of discovered extensions.

Event arguments used when test discovery starts

Constructor for creating event args object

Discovery criteria to be used for test discovery.

Discovery criteria to be used for test discovery

Event arguments used to notify the caller about the status of the test session.

Gets or sets the test session info.

Gets or sets the metrics.

Event arguments used to notify the caller about the status of the test session.

Creates an instance of the current class.

The test session info.

Gets or sets the test session info.

Gets or sets the metrics.

Gets or sets a value indicating if the session was successfully stopped or not.

Default constructor.

Specifies whether the attachments processing is canceled. Specifies the error encountered during the execution of the attachments processing.

Gets a value indicating whether the attachments processing is canceled or not.

Gets the error encountered during the attachments processing of the test runs. Null if there is no error.

Get or Sets the Metrics (used for telemetry)

Default constructor.

Specifies current attachment processor index. Specifies current processor Uris. Specifies current processor progress. Specifies the overall number of processors.

Gets a current attachment processor index.

Gets a current attachment processor URI.

Gets a current attachment processor progress.

Gets the overall number of attachment processors.

The test run changed event args that provides the test results available.

Initializes a new instance of the class.

The stats. The new test results. The active tests.

Gets the new test results.

Gets the test run statistics.

Gets the active tests.

Event arguments used when a test run has completed.

Default constructor.

The final stats for the test run. This parameter is only set for communications between the test host and the clients (like VS) Specifies whether the test run is canceled. Specifies whether the test run is aborted. Specifies the error encountered during the execution of the test run. Attachment sets associated with the run. Time elapsed in just running tests

Default constructor.

Gets the statistics on the state of the test run.

Gets a value indicating whether the test run is canceled or not.

Gets a value indicating whether the test run is aborted.

Gets the error encountered during the execution of the test run. Null if there is no error.

Gets the attachment sets associated with the test run.

Gets the invoked data collectors for the test session.

Gets the time elapsed in just running the tests. Value is set to TimeSpan.Zero in case of any error.

Get or Sets the Metrics

Gets or sets the collection of discovered extensions.

Event arguments used when test run starts

Constructor for creating event args object

Test run criteria to be used for test run.

Test run criteria to be used for test run

Filter options to be passed into the Test Platform during Discovery/Execution.

Gets or sets the regular expression that will be applied on the property before matching.

Gets or sets the optional regular expression replacement string. When this property is set, will be called upon property value instead of before matching.

Interface defining contract for custom test host implementations

Gets a value indicating whether this is a debug launcher.

Launches custom test host using the default test process start info

Default TestHost Process Info Process id of the launched test host

Launches custom test host using the default test process start info

Default TestHost Process Info The cancellation Token. Process id of the launched test host

Interface defining contract for custom test host launcher implementation.

Attach debugger to already running custom test host process.

Process ID of the process to which the debugger should be attached. if the debugger was successfully attached to the requested process, otherwise.

Attach debugger to already running custom test host process.

Process ID of the process to which the debugger should be attached. The cancellation token. if the debugger was successfully attached to the requested process, otherwise.

Attach debugger to already running custom test host process.

Process ID and target framework of the process to which the debugger should be attached. The cancellation token. if the debugger was successfully attached to the requested process, otherwise.

Provides basic functionality for the Proxy Operation Manager.

Updates the test process start info.

The test process start info to be updated. The updated test process start info.

IDiscoverTestsRequest returned after calling GetDiscoveredTestsAsync

Handler for notifying discovery process is started

Handler for notifying discovery process is complete

Handler for notifying when newly found tests are available for UI to fetch.

Handler for receiving error during fetching/execution. This is used for when abnormal error occurs; equivalent of IRunMessageLogger in the current RockSteady core

Gets the discovery criterion.

Starts tests discovery async.

Aborts the discovery request

Interface contract for handling internal test run events during run. This interface should have methods similar to , but only the newest (most broad) version of each method, so that we only operate on the latest interface in the internals, and adapt on the edges.

Handle the TestRunCompletion event from a test engine

TestRunCompletion Data Last set of test results Attachments of the test run ExecutorURIs of the adapters involved in test run

Handle a change in TestRun i.e. new testresults and stats

TestRunChanged Data

Launches a process with a given process info under debugger Adapter get to call into this to launch any additional processes under debugger

Process start info ProcessId of the launched process

Attach debugger to an already running process.

Process ID of the process and tfm to which the debugger should be attached. if the debugger was successfully attached to the requested process, otherwise.

This Interface Provides API's to Collect Metrics.

Add Metric in the Metrics Cache

Metric Message Value associated with Metric

Get Metrics

Returns the Telemetry Data Points

Represents any request to discover or run tests.

Handler for receiving raw messages directly from host without any deserialization or morphing This is required if one wants to re-direct the message over the process boundary without any processing overhead All events should come as raw messages as well as actual serialized events

Waits for the request to complete

Time out True if the request timeouts

Extensions for .

Waits for the request to complete.

Request to wait on.

Provide common services and data for a discovery/run request.

Gets an instance of .

Gets or sets the ProtocolConfig

Gets or sets a value indicating whether is telemetry opted in.

Interface contract for handling discovery events during test discovery operation

Dispatch DiscoveryComplete event to listeners.

Total number of tests discovered. Last set of test cases discovered. True if the discovery operation is aborted.

Dispatch DiscoveredTest event to listeners.

Discovered test cases.

Interface contract for handling discovery events during test discovery operation

Dispatch DiscoveryComplete event to listeners.

Discovery Complete Event Args Last set of test cases discovered.

Dispatch DiscoveredTest event to listeners.

Discovered test cases.

Defines the functionality of the test platform.

Updates the extensions to be used by the test service.

Specifies the path to unit test extensions. If no additional extension is available, then specify null or empty list. Flag indicating if we should skip the default adapters initialization.

Clears the extensions.

Creates a discovery request.

Providing common services and data for discovery. Specifies the discovery parameters. Test platform options. Details of each dll (source). Logger to use for warnings. A DiscoveryRequest object.

Creates a test run request.

Providing common services and data for execution. Specifies the test run criteria. Test platform options. Details of each dll (source). Logger to use for warnings. A RunRequest object.

Starts a test session.

Providing common services and data for test session start. Specifies the start test session criteria. Events handler for handling session events. Details of each dll (source). Logger to use for warnings. True if the operation succeeded, false otherwise.

Basic metadata for ITestPlaform.

This interface is only public due to limitations in MEF which require metadata interfaces to be public. This interface is not intended for external consumption.

Type of testPlatform

Interface contract for handling test run attachments processing events

Dispatch TestRunAttachmentsProcessingComplete event to listeners.

AttachmentsProcessing Complete event args. Last set of processed attachment sets.

Dispatch ProcessedAttachmentsChunk event to listeners.

Processed attachment sets.

Dispatch TestRunAttachmentsProcessingProgress event to listeners.

AttachmentsProcessing Progress event args.

Defines common test run configuration APIs

Defines the frequency of run stats test event.

Run stats change event will be raised after completion of these number of tests. Note that this event is raised asynchronously and the underlying execution process is not paused during the listener invocation. So if the event handler, you try to query the next set of results, you may get more than 'FrequencyOfRunStatsChangeEvent'.

Returns whether the run is configured to run specific tests

Returns whether the run is configured to run specific sources

The specific tests for this test run if any.

Interface contract for handling test run events during run operation

Handle the TestRunCompletion event from a test engine

TestRunCompletion Data Last set of test results Attachments of the test run ExecutorURIs of the adapters involved in test run

Handle a change in TestRun i.e. new testresults and stats

TestRunChanged Data

Launches a process with a given process info under debugger Adapter get to call into this to launch any additional processes under debugger

Process start info ProcessId of the launched process

Interface for handling generic message events during various operations

Raw Message from the host directly

raw message args from host

Handle a IMessageLogger message event from Adapter Whenever adapters call IMessageLogger.SendMessage, TestEngine notifies client with this event

Message Level string message

Interface contract for handling test run events during run operation.

Attach debugger to an already running process.

Process ID of the process to which the debugger should be attached. if the debugger was successfully attached to the requested process, otherwise.

The request that a RunTests API returns.

Start the current RunTestAsync API call.

Id of the executor process

Cancel the current RunTestsAsync API call. This can be used when making async RunTestsAsync call.

Aborts the test run execution process.

Specifies the test run criteria

State of the test run

Handler for notifying when test results came back from the agent!

Handler for notifying test run started

Handler for notifying test run is complete

Handler for receiving error during fetching/execution. This is used for when abnormal error occurs; equivalent of IRunMessageLogger in the current RockSteady core

Handler for receiving data collection messages.

Stats on the test run state

The number of tests that have the specified value of TestOutcome

TestOutcome - Test count map

Number of tests that have been run.

Interface contract for handling test session events.

Dispatch StartTestSession complete event to listeners.

The event args.

Dispatch StopTestSession complete event to listeners.

The event args.

DO NOT use this to extend TestPlatform, it is public only because ITestPlatform is also public, and will be made internal later.

Log warning message that will be shown to user.

message string

Class used to define the CustomHostLaunchAckPayload sent by the Vstest.console translation layers into design mode

ProcessId of the TestHost launched by Clients like IDE, LUT etc.

ErrorMessage, in cases where custom launch fails

Class used to define the DiscoveryRequestPayload sent by the Vstest.console translation layers into design mode

Settings used for the discovery request.

Gets or sets the test platform options

Gets or sets the test session info.

Class used to define the sent by the vstest.console translation layers into design mode.

A value indicating if the debugger has successfully attached.

ErrorMessage, in cases where attaching the debugger fails.

Class used to define the start test session ack payload sent by the design mode client back to the vstest.console translation layers.

Gets or sets the event args.

Class used to define the start test session payload sent by the vstest.console translation layers into design mode.

Gets or sets the sources used for starting the test session.

Gets or sets the run settings used for starting the test session.

Gets or sets a flag indicating if debugging is enabled.

Gets or sets a flag indicating if a custom host launcher should be used.

Gets or sets the test platform options.

Class used to define the stop test session ack payload sent by the design mode client back to the vstest.console translation layers.

Gets or sets the event args.

Class used to define the stop test session payload sent by the vstest.console translation layers into design mode.

Gets or sets the test session info.

Gets or sets a flag indicating if metrics should be collected.

Class used to define the TestRunAttachmentsProcessingPayload sent by the Vstest.console translation layers into design mode

Collection of attachments.

Collection of the invoked data collectors.

Gets or sets the settings used for the test run request.

Gets or sets whether Metrics should be collected or not.

Class used to define the TestRunRequestPayload sent by the Vstest.console translation layers into design mode

Gets or sets the sources for the test run request.

Making this a list instead of an IEnumerable because the json serializer fails to deserialize if a linq query outputs the IEnumerable.

Gets or sets the test cases for the test run request.

Making this a list instead of an IEnumerable because the json serializer fails to deserialize if a linq query outputs the IEnumerable.

Gets or sets the settings used for the test run request.

Settings used for the Run request.

Is Debugging enabled

Gets or sets the testplatform options

Gets or sets the test session info.

Class for Protocol related information

Get or Set the version of protocol

Class used to define the start test session criteria.

Gets or sets the sources used for starting the test session.

Gets or sets the run settings used for starting the test session.

Gets or sets the test host launcher used for starting the test session.

Options to be passed into the Test Platform during Discovery/Execution.

Gets or sets the filter criteria for test cases.

This is only used when running tests with sources.

Gets or sets the filter options if there are any.

This will be valid only if TestCase filter is present.

Gets or sets whether metrics should be collected or not.

Gets or sets whether default adapters should be skipped or not.

Defines the test run criterion.

Initializes a new instance of the class.

Sources which contains tests that should be executed. Frequency of run stats event.

Initializes a new instance of the class.

Sources which contains tests that should be executed. Frequency of run stats event. Whether the execution process should be kept alive after the run is finished or not.

Initializes a new instance of the class.

Sources which contains tests that should be executed. Frequency of run stats event. Whether the execution process should be kept alive after the run is finished or not. Settings used for this run.

Initializes a new instance of the class.

Sources which contains tests that should be executed. Frequency of run stats event. Whether the execution process should be kept alive after the run is finished or not. Settings used for this run. Timeout that triggers sending results regardless of cache size. Test host launcher. If null then default will be used. Test case filter. Filter options.

Initializes a new instance of the class.

Initializes a new instance of the class. Create the TestRunCriteria for a test run.

Sources which contains tests that should be executed. The test run criteria.

Initializes a new instance of the class.

Tests which should be executed. Frequency of run stats event.

Initializes a new instance of the class.

Tests which should be executed. Frequency of run stats event. Whether or not to keep the test executor process alive after run completion.

Initializes a new instance of the class.

Tests which should be executed. Frequency of run stats event. Whether or not to keep the test executor process alive after run completion. Settings used for this run.

Initializes a new instance of the class.

Tests which should be executed. The base test run criteria.

Initializes a new instance of the class.

Tests which should be executed. Frequency of run stats event. Whether or not to keep the test executor process alive after run completion. Settings used for this run. Timeout that triggers sending results regardless of cache size. Test host launcher. If null then default will be used.

Initializes a new instance of the class.

Gets the test containers (e.g. DLL/EXE/artifacts to scan).

Gets the test adapter and source map which would look like below:


            { C:\temp\testAdapter1.dll : [ source1.dll, source2.dll ], C:\temp\testadapter2.dll : [ source3.dll, source2.dll ]

Gets the tests that need to executed in this test run. This will be null if test run is created with specific test containers.

Gets or sets the criteria for filtering test cases.

This is only for with sources.

Gets or sets the filter options.

This is only applicable when TestCaseFilter is present.

Gets or sets the test session info object.

Gets or sets a flag indicating if debugging should be enabled when we have test session info available.

Gets a value indicating whether run criteria is based on specific tests.

Gets a value indicating whether run criteria is based on specific sources.

Defines the base test run criterion.

Initializes a new instance of the class.

Run criteria to clone.

Initializes a new instance of the class.

Frequency of TestRunChangedEvent.

Initializes a new instance of the class.

Frequency of TestRunChangedEvent. Specify if the test host process should be stay alive after run.

Initializes a new instance of the class.

Frequency of TestRunChangedEvent. Specify if the test host process should be stay alive after run. Test run settings.

Initializes a new instance of the class.

Frequency of TestRunChangedEvent. Specify if the test host process should be stay alive after run. Test run settings. Timeout for a TestRunChangedEvent.

Initializes a new instance of the class.

Frequency of TestRunChangedEvent. Specify if the test host process should be stay alive after run. Test run settings. Timeout for a TestRunChangedEvent. Test host launcher.

Gets a value indicating whether the test executor process should remain alive after run completion.

Gets the settings used for this run.

Gets the custom launcher for test executor.

Gets the frequency of run stats test event.

Gets the timeout that triggers sending results regardless of cache size.

States of the TestRun

Status is not known

The run is still being created. No tests have started yet.

Tests are running.

All tests have completed or been skipped.

Run is canceled and remaining tests have been aborted

Run is aborted

Defines the test run stats header

Initializes a new instance of the class.

This constructor doesn't perform any parameter validation, it is meant to be used for serialization."/>

Initializes a new instance of the class.

The stats.

Initializes a new instance of the class.

The executed tests. The stats. This constructor is only needed to reconstruct the object during deserialization.

Gets or sets the number of tests that have been run.

Gets the test stats which is the test outcome versus its state.

Gets the number of tests with a specified outcome.

The test outcome. The number of tests with this outcome.

Defines the test session info object to be passed around between vstest.console and vstest.console wrapper in order to identify the current session.

Creates an instance of the current class.

Gets the session id.

Calculates the hash code for the current object.

An integer representing the computed hashcode value.

Checks if the specified object is equal to the current instance.

The object to be checked. True if the two objects are equal, false otherwise.

Checks if the specified session is equal to the current instance.

The session to be checked. True if the two sessions are equal, false otherwise.

Interface implemented to log messages and results from tests. A class that implements this interface will be available for use if it exports its type via MEF, and if its containing assembly is placed in the Extensions folder.

Initializes the Test Logger.

Events that can be registered for. Test Run Directory

This Interface extends ITestLogger and adds capability to pass parameters to loggers such as TfsPublisher. Currently it is marked for internal consumption (ex: TfsPublisher)

Initializes the Test Logger with given parameters.

Events that can be registered for. Collection of parameters

Exposes events that Test Loggers can register for.

Default constructor.

Raised when a test message is received.

Raised when a test run starts.

Raised when a test result is received.

Raised when a test run is complete.

Raised when test discovery starts

Raised when a discovery message is received.

Raised when discovered tests are received

Raised when test discovery is complete

Details of EndPoint address for connection b/w test runtime, test runner

Endpoint where the service is hosted, This endpoint is specific to Transport e.g. 127.0.0.0:8080 for sockets

Gets or sets the role played by TestRuntime during communication.

Gets or sets the transport protocol supported by test runtime

Specifies the role of application, whether as host or client

Act as server host

Act as client

Specifies the underneath Transport channel to be used E.g. For UWP/Desktop it is Sockets, for Android it could be SSH

Act as server host

Connection information for a test host to communicate with test runner.

Gets or sets the port for runner to connect to Needed for backward compatibility

Gets or sets the details of endpoint by test runner for host communication.

Gets or sets the diagnostics log file.

Gets or sets the trace level of logs.

Gets or sets the runner process id.

Extension methods for .

Creates a default command line options string from .

Connection info for the test host. Command line option string.

Defines the defaults/constants used across different components.

The in process data collection run settings name.

The in process data collector setting name.

The in process data collectors setting name.

Name of collect dump option for blame.

Name of collect dump option for blame. The internal visibility is because the new feature is not publicly exposed yet and so we can retire it.

Name of collect dump option for blame.

Name of collect hang dump option for blame.

Name of data collection settings node in RunSettings.

Name of logger run settings node in RunSettings.

Name of loggers node in RunSettings.

Name of logger node in RunSettings.

Name of friendlyName attribute of logger node.

Name of friendlyName attribute of logger node in lower case.

Name of uri attribute of logger node.

Name of assemblyQualifiedName attribute of logger node.

Name of assemblyQualifiedName attribute of logger node in lower case.

Name of codeBase attribute of logger node.

Name of codeBase attribute of logger node in lower case.

Name of enabled attribute of logger node.

Name of configuration element of logger node.

Name of configuration element of logger node in lower case.

Name of TreatNoTestsAsError parameter

Name of RunConfiguration settings node in RunSettings.

Default testrunner if testrunner is not specified

Pattern used to find test run parameter node.

Type of the unit test extension. (Extension author will use this name while authoring their Vsix)

Maximum size of the trace log file (in kilobytes).

Adding this for compatibility

Default option for parallel execution

The default batch size.

The default protocol version

The minimum protocol version that has debug support

Name of the results directory

Default results directory.

Default treatment of error from test adapters.

The default execution thread apartment state.

Constants for detecting .net framework.

Default parameters to be passed onto all loggers.

Registers an attachment processor for a data collector.

Initializes a new instance of the class.

The type of the attachement data processor.

Gets the data collector type uri.

Provides a friendly name for the data collector.

Initializes a new instance of the class.

The friendly name.

Gets the friendly name.

Provides unique identification of a data collector in the form of a URI. Recommended format: 'datacollector://Company/Product/Version'

Initializes a new instance of the class.

The type uri.

Gets the data collector type uri.

Severity levels at which a DataCollectionTextMessage can be logged.

Determines if a file name has invalid characters.

File name to check. Invalid characters which were found in the file name. True if the file name is valid and false if the filename contains invalid characters.

Returns true if the file name specified is Windows reserved file name.

The name of the file. Note: only a file name, does not expect to contain directory separators.

Wrapper class for a request ID that can be used for messages or events for identification purposes

A request ID with an empty GUID

Initializes the instance by creating a new GUID

Initializes the instance with the provided GUID

The GUID to use as the underlying ID

Compares this instance with the provided object for value equality

The object to compare to True if equal, false otherwise

Gets a hash code for this instance

The underlying GUID's hash code

Converts the instance to a string in lower-case registry format

A lower-case string in registry format representing the underlying GUID

Compares this instance with the provided request ID for value equality

The request ID to compare to True if equal, false otherwise

Compares this instance with the provided request ID

The request ID to compare to An indication of the two request IDs' relative values

Compares this instance with the provided object

The object to compare to An indication of the two objects' relative values 'obj' is not null and not an instance of

Compares the two request IDs for value equality

The left-hand request ID The right-hand request ID True if equal, false otherwise

Compares two request IDs for value inequality

The left-hand request ID The right-hand request ID True if unequal, false otherwise

Gets the underlying GUID that represents the request ID

Class identifying a session.

Type of test case failure which occurred.

Class identifying test execution id. Execution ID is assigned to test at run creation time and is guaranteed to be unique within that run.

Class representing the context in which data collection occurs.

Constructs DataCollection Context for in process data collectors

test case to identify the context

Constructs a DataCollectionContext indicating that there is a session, but no executing test, in context.

The session under which the data collection occurs. Cannot be null.

Constructs a DataCollectionContext indicating that there is a session and an executing test, but no test step, in context.

The session under which the data collection occurs. Cannot be null. The test execution under which the data collection occurs, or null if no executing test case is in context

Gets test case.

Identifies the session under which the data collection occurs. Will not be null.

Identifies the test execution under which the data collection occurs, or null if no such test exists.

Returns true if there is an executing test case associated with this context.

Encapsulates the context of the environment a data collector is being hosted in.

Serialization Constructor

Initializes with the DataCollectionContext

Creates an environment context for a local (hosted) agent and controller

An environment context for a local (hosted) agent and controller

Creates an environment context for a local (hosted) agent and controller

Session level data collection context. An environment context for a local (hosted) agent and controller

DataCollectionContext for the session.

Class used by data collectors to send messages to the client (e.g. Manual Test Runner, Visual Studio IDE, MSTest).

Constructs a DataCollectionLogger

Logs an error message.

The context in which the message is being sent. The error text. Cannot be null. When a Data Collector invokes this method, Client would get called on OnCollectionError( ) with a CollectionErrorMessageEventArgs.

Logs an error message for an exception.

The context in which the message is being sent. The exception. Cannot be null. When a Data Collector invokes this method, Client would get called on OnCollectionError( ) with a CollectionErrorMessageEventArgs.

Logs an error message for an exception.

The context in which the message is being sent. Text explaining the exception. Cannot be null. The exception. Cannot be null. When a Data Collector invokes this method, Client would get called on OnCollectionError( ) with a CollectionErrorMessageEventArgs.

Logs a warning.

The context in which the message is being sent. The warning text. Cannot be null. When a Data Collector invokes this method, Client would get called on OnCollectionWarning( ) with a CollectionWarningMessageEventArgs.

Logs and given exception to the client.

The exception to be logged Is the exception at warning level or error level. When a Data Collector invokes this method, Client would get called on OnCollectionException( ) with a CollectionExceptionMessageEventArgs.

Class used by data collectors to send data to up-stream components

Initializes a new instance of the class.

Called when sending of a file has completed.

Sends a file to up-stream components.

The context in which the file is being sent. Cannot be null. the path to the file on the local file system True to automatically have the file removed after sending it.

Sends a file to up-stream components.

The context in which the file is being sent. Cannot be null. the path to the file on the local file system A short description of the data being sent. True to automatically have the file removed after sending it.

Sends a file to up-stream components

Information about the file to be transferred.

Interface for data collector add-ins

Initializes the data collector

The XML element containing configuration information for the data collector. Can be null if the add-in does not have any configuration information. Object containing the execution events the data collector can register for The sink used by the data collector to send its data Used by the data collector to send warnings, errors, or other messages Provides contextual information about the agent environment

Disposes the data collector.

Called to perform cleanup when the instance is being disposed.

True when being called from the Dispose method and false when being called during finalization.

Base class for all execution event arguments

Default constructor added for serialization/deserialization.

Initializes the instance by storing the given information

Context information for the event

Gets the context information for the event

Class defining execution events that will be registered for by collectors

Initializes a new instance of the class.

Raised when test host initialized

Raised when a session is starting

Raised when a session is ending

Raised when a test case is starting

Raised when a test case is ending

Session Start event arguments

Initializes a new instance of the class.

Default constructor with empty properties and default DataCollectionContext. DataCollectionContext with empty session signifies that is it irrelevant in the current context.

Initializes a new instance of the class.

constructor with properties and default DataCollectionContext. DataCollectionContext with empty session signifies that is it irrelevant in the current context.

Initializes a new instance of the class.

Context information for the session Properties for the session.

Gets session start properties enumerator

Gets property value

Property name

Gets property value

Property name

Session End event arguments

Initializes a new instance of the class.

Default constructor with default DataCollectionContext. DataCollectionContext with empty session signifies that is it irrelevant in the current context.

Initializes a new instance of the class.

Context information for the session

Base class for all test case event arguments.

Default constructor added for serialization/deserialization.

Initializes a new instance of the class.

Context information for the test case The test case ID The test case name True if this is a child test case, false if this is a top-level test case.

Initializes a new instance of the class.

Context information for the test case The test element of the test that this event is for.

Gets the test case ID

Gets the test case name

Gets a value indicating whether this is a child test case, false if this is a top-level test case

Gets test element of the test this event is for.

Test Case Start event arguments.

Default constructor for serialization/deserialization

Initializes a new instance of the class with default datacollection context.

The test element.

Initializes a new instance of the class. Initializes the instance by storing the given information.

Context information for the test case The test element of the test that this event is for.

Initializes a new instance of the class. Initializes the instance by storing the given information

Context information for the test case The test case ID The test case name True if this is a child test case, false if this is a top-level test case

Test Case End event arguments.

Default constructor added for serialization/deserialization.

Initializes a new instance of the class with default data collection context.

The test element. The test outcome. Default constructor with default DataCollectionContext. DataCollectionContext with empty session signifies that is it irrelevant in the current context.

Initializes a new instance of the class. Initializes the instance by storing the given information.

Context information for the test case The test element of the test that this event is for. The outcome of the test case.

Initializes a new instance of the class.

Context information for the test case The test case ID The test case name True if this is a child test case, false if this is a top-level test case

Initializes a new instance of the class. Initializes the instance by storing the given information

Context information for the test case The test case ID The test case name True if this is a child test case, false if this is a top-level test case The outcome of the test case.

Gets the outcome of the test.

Test Case Result event arguments.

Default constructor for serialization/deserialization

Initializes a new instance of the class with default data collection context.

The test result. Default constructor with default DataCollectionContext. DataCollectionContext with empty session signifies that is it irrelevant in the current context.

Initializes a new instance of the class. Initializes the instance by storing the given information.

Context information for the test case The test Result.

Initializes a new instance of the class. Initializes the instance by storing the given information

Context information for the test case The test case ID The test case name True if this is a child test case, false if this is a top-level test case The test Result.

Gets the outcome of the test.

Session End event arguments

Process id of the test host

Initializes a new instance of the class.

Data collection context Process id of test host

Class used by data collectors to send data to up-stream components (agent, controller, client, etc).

The send data will send the data collection data to upstream applications. Key will be set as TestProperty in TestResult and value as corresponding value.

The data collection context. The key should be unique for a data collector. The value should be a string or an object serialized into a JSON string.

Interface for data collectors add-ins that choose to reprocess generated attachments

Gets the attachments Uris, which are handled by attachment processor

Indicates whether attachment processor is supporting incremental processing of attachments

`SupportsIncrementalProcessing` should indicate if attachment processor is supporting incremental processing of attachments. It means that `ProcessAttachmentSetsAsync` should be [associative](https://en.wikipedia.org/wiki/Associative_property). By default `SupportsIncrementalProcessing` should be `False`, unless processing can take longer time and it's beneficial to start the process as soon as possible. If `SupportsIncrementalProcessing` is `True` Test Platform may try to speed up whole process by reprocessing data collector attachments as soon as possible when any two test executions are done.For example let's assume we have 5 test executions which are generating 5 data collector attachments: `a1`, `a2`, `a3`, `a4` and `a5`. Test platform could perform invocations: * `var result1 = await ProcessAttachmentSetsAsync([a1, a2, a3], ...);` when first 3 executions are done * `var result2 = await ProcessAttachmentSetsAsync(result1.Concat([a4]), ...);` when 4th execution is done * `var finalResult = await ProcessAttachmentSetsAsync(result2.Concat([a5]), ...);` when last test execution is done If `SupportsIncrementalProcessing` is `False` then Test Platform will wait for all test executions to finish and call `ProcessAttachmentSetsAsync` only once: * `var finalResult = await ProcessAttachmentSetsAsync([a1, a2, a3, a4, a5], ...);`

Reprocess attachments generated by independent test executions

Configuration of the attachment processor. Will be the same as the data collector that registers it. Attachments to be processed Progress reporter. Accepts integers from 0 to 100 Message logger Cancellation token Attachments after reprocessing

Interface for data collectors add-ins that choose to handle attachment(s) generated

Gets the attachment set after Test Run Session

Gets the attachment Uri, which is handled by current Collector

Interface for data collectors add-ins that choose to specify some information about how the test execution environment should be set up

Gets environment variables that should be set in the test execution environment

Environment variables that should be set in the test execution environment

Collects the required and optional information needed for requesting a file transfer from a data collector.

Initializes a new instance of the class.

The data collection context for the transfer.

Gets the data collection context the transfer will be associated with.

Gets or sets a short description of the data being sent.

Gets or sets the token which will be included with the callback to identify this file transfer.

Gets or sets the ID of the request that this file should be associated with. This is used for sending transient data which will be associated only with this data request and not the session or test cases that are currently running.

Gets a value indicating whether cleanup should be performed after transferring the resource. This can be known by different names in the derived classes so it is protected internal so that we can refer to it in a consistent way.

Gets the name of the file to use on the client machine. This can be known by different names in the derived classes so it is protected internal so that we can refer to it in a consistent way.

Represents required and optional information needed for requesting a file transfer.

Initializes a new instance of the class.

The context in which the file is being sent. Cannot be null. The path to the file on the local file system True to automatically have the file removed after sending it.

Initializes a new instance of the class.

The context in which the file is being sent. Cannot be null. The path to the file on the local file system True to automatically have the file removed after sending it. The file Helper.

Gets the path to the file on the local file system.

Indicates if cleanup should be performed after transferring the resource.

The name of the file to use on the client machine.

The in procedure data collection run settings.

Initializes a new instance of the class.

The data collection root name. The data collections name. The data collector name.

Gets the in procedure data collector settings list.

Gets a value indicating whether is in procedure data collection enabled.

The to xml.

The .

The from xml.

The reader. The . Settings exception

The read list element from xml.

The reader. Name of the datacollector. The .

The in procedure data collector settings.

Gets or sets the uri.

Gets or sets the assembly qualified name.

Gets or sets the friendly name.

Gets or sets a value indicating whether is enabled.

Gets or sets value CodeBase of collector DLL. The syntax is same as Code Base in AssemblyName class.

Gets or sets the configuration.

The to xml.

The .

The to xml.

The data collector name. The .

The from xml.

The reader. The . Settings exception

The InProcDataCollectionArgs interface.

The test case end args.

Initializes a new instance of the class.

The data Collection Context. The outcome.

Gets the outcome.

Gets the data collection context.

The test case start args.

Initializes a new instance of the class.

The test case.

Gets the test case.

The test session end args.

The test session start args.

Initializes a new instance of the class.

Properties.

Initializes a new instance of the class.

The configuration.

Gets or sets the configuration.

Gets session start properties enumerator

Gets property value

Property name

Gets property value

Property name

Listener interface for external exe from test host

Initializes the In Process DataCollection with the DataCollectionSink

data collection sink object

Called when test session starts

The test Session Start Args.

Called when test case starts

Test Case start args

Called when test case end

The test Case End Args.

Called when test session end

The test Session End Args.

This attribute is applied on the discoverers to inform the framework about their default executor.

Initializes with the Uri of the executor.

The Uri of the executor

The Uri of the Test Executor.

This attribute is applied to s. It indicates the test discoverer discovers tests present inside a directory (as opposed to the which indicates that the discoverer discovers tests present in files with a specified extension).

If neither this attribute nor the is provided on the test discoverer, it will be called for all relevant test files and directories.

Base exception for all Rocksteady service exceptions

This attribute is applied to extensions so they can be uniquely identified. It indicates the Uri which uniquely identifies the extension. If this attribute is not provided on the extensions such as the Test Executor or Test Logger, then the extensions will not be used.

Initializes with the Uri of the extension.

The Uri of the extension

The Uri of the Test Executor.

This attribute is applied to s. It indicates that the discoverer discovers tests present in files with the specified extension.

If neither this attribute nor the is provided on the test discoverer, it will be called for all relevant test files and directories.

Initializes with a file extension that the test discoverer can process tests from. For example ".dll" or ".exe".

The file extensions that the test discoverer can process tests from.

A file extensions that the test discoverer can process tests from. For example ".dll" or ".exe".

Class for target Framework for the test container

Default .Net target framework.

Gets the FullName of framework.

Gets the framework name such as .NETCoreApp.

Common short name, as well as directory name, such as net5.0. Is null when the framework is not correct.

Gets the framework version.

Returns a valid framework or null when it cannot parse it, or when given null.

Framework name A framework object

Returns full name of the framework.

String presentation of the object.

This holds the major desktop framework versions. This is just to maintain compatibility with older runsettings files.

This attribute is applied to Loggers so they can be uniquely identified. It indicates the Friendly Name which uniquely identifies the extension. This attribute is optional.

Initializes with the Friendly Name of the logger.

The friendly name of the Logger

The friendly Name of the Test Logger.

Interface for TestRuntimeProvider which manages test host processes for test engine.

Raised when host is launched successfully Consumed by TestPlatform to initialize connection b/w test host and test platform

Raised when host is cleaned up and removes all it's dependencies

Gets a value indicating whether the test host is specific to a test source. If yes, each test source is launched in a separate host process.

Sets a Message Logger

provide logger to runtimes provide runsettings to runtimes for initialization

Gets a value indicating whether the test host is specific to a test source. If yes, each test source is launched in a separate host process.

The run Configuration. The .

Sets a custom launcher

Custom launcher to set

Gets the end point address and behavior of TestRuntime E.g. for phone device EndPoint:127.0.0.1:8080, ConnectionRole Host, TransportProtocol: Sockets

Socket where the service is hosted by TestRuntime

Launches the test host for discovery/execution.

Start parameters for the test host. Returns whether the test host launched successfully or not.

Gets the start parameters for the test host.

Test source paths. Set of environment variables for the test host process. Set of connection parameters for the test host process to communicate with test runner. ProcessStartInfo of the test host.

Gets paths of any additional extensions. A test host manager may choose to provide a custom extensions acquisition and discovery mechanism. E.g. for .net core, extensions are discovered from the testproject.deps.json file.

List of test sources. List of paths to extension assemblies.

Gets path of test sources, based on RuntimeProvider, and where the test is actually deployed(Remote Scenario). A test host manager may choose to accept input source as XML file, and provide appropriate source(dll/exe) which the adapters can actually consume E.g. for UWP, input source could be "appx recipe" file, which gives information about actual source exe.

List of test sources. Updated List of test sources based on remote/local scenario.

Cleanup the test host process and it's dependencies.

Cancellation token. The .

Interface to define a TestRuntimeProvider with support for attaching the debugger to the default testhost process.

Attach the debugger to an already running testhost process.

if the debugger was successfully attached to the running testhost process, otherwise.

Initialize an InvokedDataCollector

Data collector Uri Friendly name of the datacollector. Data collector assembly qualified name Data collector file path True if data collector registers an attachment processor

DataCollector uri.

DataCollector FriendlyName.

AssemblyQualifiedName of data collector.

Data collector file path.

True if the collector registers an attachments processor.

Compares InvokedDataCollector instances for equality.

InvokedDataCollector instance True if objects are equal

Compares InvokedDataCollector instances for equality.

InvokedDataCollector instance True if objects are equal

Returns the object hashcode

Hashcode value

Return string representation for the current object

String representation

Interface for extensions that choose to send telemetry events

Initializes telemetry reporter

Interface for extensions that choose to send telemetry events

Pushes telemetry event into TP

Represents a lazy value calculation for a TestObject

Forces calculation of the value

Represents a lazy value calculation for a TestObject

The type of the value to be calculated

Forces calculation of the value

The logger run settings.

Initializes a new instance of the class.

Gets the logger settings list.

The from xml.

The reader. The . Settings exception

The from xml.

The reader. Loggers setting name. Logger setting name. The

Reads logger settings list from runSettings

The reader. Logger setting name. LoggerSettings List

Gets existing logger index.

Logger settings. Index of given logger settings.

The logger settings.

Gets or sets the uri.

Gets or sets the assembly qualified name.

Gets or sets value CodeBase of logger DLL. The syntax is same as Code Base in AssemblyName class.

Gets or sets the friendly name.

Gets or sets a value indicating whether is enabled.

Gets or sets the configuration.

The to xml.

The .

The to xml.

The logger name. The .

EventArg used for raising data collector message event.

Constructor

Level at which message should be logged. Text message.

Friendly name of collector

Uri of collector.

Test case id if the message is generated by test case collection.

Event arguments used for raising Test Result events.

Initializes a new instance of the class.

Test Result for the event.

Gets the Test Result.

Event arguments used for raising Test Run Message events.

Initializes with the level and the message for the event.

Level of the message. The message.

The message.

Level of the message.

Event arguments used for raising TestRunStarted events. Mainly contains the process Id of the test execution process running the tests.

The process Id of the test execution process running the tests.

Used for logging error warning and informational messages.

Sends a message to the enabled loggers.

Level of the message. The message to be sent.

Levels for test messages.

Informational message.

Warning message.

Error message.

A struct that stores the information needed by the navigation: file name, line number, column number.

The class that enables us to get debug information from both managed and native binaries.

Characters that should be stripped off the end of test names.

The symbol reader.

Initializes a new instance of the class.

The binary path.

Initializes a new instance of the class.

The binary path is assembly path Ex: \path\to\bin\Debug\simpleproject.dll search path.

Dispose symbol reader

Gets the navigation data for a method declared in a type.

The declaring type name. The method name. The for that method. Leaving this method in place to preserve back compatibility.

Gets the navigation data for a method declared in a type.

The declaring type name. The method name. The for that method.

To get method's file name, startline and endline from desktop assembly file.

To check isDisposed

Holds type symbols available in the source.

Holds method symbols for all types in the source. Methods in different types can have same name, hence separated dictionary is created for each type. Bug: Method overrides in same type are not handled (not a regression) ToDo(Solution): Use method token along with as identifier, this will always give unique method.The adapters would need to send this token to us to correct the behavior.

dispose caches

Cache symbols from binary path

The binary path is assembly path Ex: \path\to\bin\Debug\simpleproject.dll search path.

Gets Navigation data from caches

Type name Ex: MyNameSpace.MyType Method name in declaringTypeName Ex: Method1 . Returns INavigationData which contains filename and line number.

Update the method symbol cache.

Stores the navigation data associated with the .exe/.dll file

Gets or sets the file name of the file containing the method being navigated.

Gets or sets the min line number of the method being navigated in the file.

Gets or sets the max line number of the method being navigated in the file.

Manages the debug data associated with the .exe/.dll file

Gets the navigation data for a method.

The declaring type name. The method name. The to get to the method.

Caches filename and line number for symbols in assembly.

Cache symbols from binary path

The binary path is assembly path Ex: \path\to\bin\Debug\simpleproject.dll search path.

Gets Navigation data from caches

Type name Ex: MyNameSpace.MyType Method name in declaringTypeName Ex: Method1 . Returns INavigationData which contains file name and line number.

Some GUID constants we use to instantiate COM objects.

DIA's IDiaEnumLineNumbers used for enumerating a symbol's line numbers.

DIA's IDiaLineNumber used for retrieving line information.

DIA's IDiaSession used for locating symbols.

DIA's IDiaSourceFile used for getting source filenames.

Represents the DIA symbol tags.

DIA's IDiaSymbol used for getting the address of function symbols.

DIA's IDiaDataSource used for opening symbols.

The portable pdb reader.

Use to get method token

Metadata reader provider from portable pdb stream To get Metadata reader

Metadata reader from portable pdb stream To get method debug info from method info

Initializes a new instance of the class.

Portable pdb stream Raises Exception on given stream is not portable pdb stream

Reads the pdb using a provided metadata reader, when the pdb is embedded in the dll, or found by path that is in the dll metadata.

Dispose Metadata reader

Gets dia navigation data from Metadata reader

Method info. The .

Checks gives stream is from portable pdb or not

Stream. The .

The portable symbol reader.

Key in first dict is Type FullName Key in second dict is method name

The cache symbols.

The binary path. The search path.

The dispose.

The get navigation data.

The declaring type name. The method name. The .

The populate cache for type and method symbols.

The binary path.

Reads the pdb data from the dlls itself, either by loading the referenced pdb file, or by reading embedded pdb from the dll itself.

Enable registry-free COM context

Initializes a new instance of RegistryFreeActivationContext class.

Manifest file path.

Finalize an instance of RegistryFreeActivationContext class.

Load manifest to enable registry-free COM context.

Disable registry-free COM context.

ActivationContextNativeMethods class needed for registry-free context

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to The parameter cannot be null or empty..

Looks up a localized string similar to Test run detected DLL(s) which would use different framework and platform versions. Following DLL(s) do not match current settings, which are {0} framework and {1} platform.{2}Go to {3} for more details on managing these settings..

Looks up a localized string similar to Settings file provided does not conform to required format..

Looks up a localized string similar to None of the provided test containers match the Platform Architecture and .Net Framework settings for the test run. Platform: {0} .Net Framework: {1}. Go to http://go.microsoft.com/fwlink/?LinkID=330428 for more details on managing these settings..

Looks up a localized string similar to {0} would use Framework {1} and Platform {2}..

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to {0,-10} {1}.

Looks up a localized string similar to The parameter cannot be null or empty..

Looks up a localized string similar to File {0} does not exist..

Looks up a localized string similar to Object must be of type {0}..

Looks up a localized string similar to Aborted.

Looks up a localized string similar to Completed.

Looks up a localized string similar to Disconnected.

Looks up a localized string similar to Error.

Looks up a localized string similar to Failed.

Looks up a localized string similar to Inconclusive.

Looks up a localized string similar to In Progress.

Looks up a localized string similar to Not Executed.

Looks up a localized string similar to Not Runnable.

Looks up a localized string similar to Passed.

Looks up a localized string similar to Passed (run aborted).

Looks up a localized string similar to Pending.

Looks up a localized string similar to Timeout.

Looks up a localized string similar to Warning.

Looks up a localized string similar to Cannot find TypeConverter for type {0}..

Looks up a localized string similar to Could not find '{0}' node.

Looks up a localized string similar to Unable to read from the provided stream. Data from a stream cannot be sent unless the stream supports reading..

Looks up a localized string similar to The provided file name '{0}' contains the following invalid characters: '{1}'..

Looks up a localized string similar to The provided file name '{0}' is reserved..

Looks up a localized string similar to Cannot register property '{0}' as value type '{1}' because it was already registered as '{2}'..

Looks up a localized string similar to Failed to Create msdia Session COM HResult '{0}'..

Looks up a localized string similar to Failed to load msdia.

Looks up a localized string similar to Invalid URI in data collector settings '{0}'..

Looks up a localized string similar to The root node of the run settings must be named 'RunSettings'..

Looks up a localized string similar to Invalid settings '{0}'. Invalid value '{1}' specified for '{2}'..

Looks up a localized string similar to Invalid settings '{0}'. Unexpected XmlAttribute: '{1}'..

Looks up a localized string similar to Invalid settings '{0}'. Unexpected XmlElement: '{1}'..

Looks up a localized string similar to Invalid URI '{0}' in settings '{1}'..

Looks up a localized string similar to Invalid data collector settings. Expected attribute '{0}' is missing. A typical data collector setting would look like <DataCollector uri="dataCollector://Samples/SampleCollector/1.0" assemblyQualifiedName="Samples.SampleCollector.SampleDataCollector, SampleCollectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=1111111111111111" friendlyName="sampleCollector">..

Looks up a localized string similar to Invalid settings '{0}'. Expected atleast one of the XmlAttribute among friendlyName, uri and assemblyQualifiedName..

Looks up a localized string similar to Cannot specify TestCaseFilter for specific tests run. FilterCriteria is only for run with sources..

Looks up a localized string similar to Notification frequency need to be a positive value..

Looks up a localized string similar to Notification timeout must be greater than zero..

Looks up a localized string similar to (null).

Looks up a localized string similar to Solution directory '{0}' does not exists. Please make sure solution directory specified in runsettings exists and have read permissions for directory..

Looks up a localized string similar to Filter string '{0}' includes unrecognized escape sequence..

Looks up a localized string similar to Column Number.

Looks up a localized string similar to Executor Uri.

Looks up a localized string similar to File Path.

Looks up a localized string similar to FullyQualifiedName.

Looks up a localized string similar to Id.

Looks up a localized string similar to Line Number.

Looks up a localized string similar to Name.

Looks up a localized string similar to Source.

Looks up a localized string similar to Traits.

Looks up a localized string similar to Message: {0}.

Looks up a localized string similar to StackTrace: {0}.

Looks up a localized string similar to Failed.

Looks up a localized string similar to None.

Looks up a localized string similar to NotFound.

Looks up a localized string similar to Passed.

Looks up a localized string similar to Skipped.

Looks up a localized string similar to {0}: {1}.

Looks up a localized string similar to Computer Name.

Looks up a localized string similar to TestResult Display Name.

Looks up a localized string similar to Duration.

Looks up a localized string similar to End Time.

Looks up a localized string similar to Error Column Number.

Looks up a localized string similar to Error Message.

Looks up a localized string similar to Error Stack Trace.

Looks up a localized string similar to Outcome.

Looks up a localized string similar to Start Time.

Looks up a localized string similar to Test Messages: {0}.

Looks up a localized string similar to The test property type '{0}' of property '{1}' is not supported. Use one of the supported property type (primitive types, uri, string, string[]) and try again. .

Stores information about a test settings.

Platform architecture which rocksteady should use for discovery/execution

Maximum number of cores that the engine can use to run tests in parallel

.Net framework which rocksteady should use for discovery/execution

Specifies the frequency of the runStats/discoveredTests event

Directory in which rocksteady/adapter should keep their run specific data.

Paths at which rocksteady should look for test adapters

Indication to adapters to disable app domain.

Indication to adapters to disable parallelization.

True if test run is triggered

False indicates that the test adapter should not collect source information for discovered tests

Initializes a new instance of the class.

Gets or sets the solution directory.

Gets or sets the results directory.

Gets or sets the Parallel execution option. Should be non-negative integer.

Gets or sets the frequency of the runStats/discoveredTests event. Should be non-negative integer.

Gets or sets the testSessionTimeout. Should be non-negative integer.

Gets or sets the design mode value.

Gets or sets a value indicating whether to run tests in isolation or not.

Gets a value indicating whether test adapter needs to collect source information for discovered tests

Gets or sets a value indicating whether app domain creation should be disabled.

Gets or sets the test adapter loading strategy.

Gets a value indicating whether parallelism needs to be disabled by the adapters.

Gets or sets the Target platform this run is targeting. Possible values are except for AnyCPU and Default.

Gets or sets the default platform that will be used for AnyCPU sources, or non-dll sources. Possible values are except for AnyCPU and Default.

Gets or sets the target Framework this run is targeting.

Gets or sets value indicating exit code when no tests are discovered or executed

Gets or sets the target Framework this run is targeting. Possible values are Framework3.5|Framework4.0|Framework4.5

Gets or sets the target device IP. For Phone this value is Device, for emulators "Mobile Emulator 10.0.15063.0 WVGA 4 inch 1GB"

Gets or sets the paths used for test adapters lookup in test platform.

Gets or sets the execution thread apartment state.

Gets or sets a value indicating whether to treat the errors from test adapters as warnings.

Gets a value indicating whether target platform set.

Gets a value indicating whether default platform is set.

Gets a value indicating whether maximum parallelization count is set.

Gets a value indicating batch size is set

Gets a value indicating whether design mode is set.

Gets a value indicating whether disable appdomain is set.

Gets a value indicating whether parallelism needs to be disabled by the adapters.

Gets a value indicating whether target framework set.

Gets a value indicating whether test adapters paths set.

Gets a value indicating whether results directory is set.

Gets the binaries root.

Collect source information

Default filter to use to filter tests

Path to dotnet executable to be used to invoke testhost.dll. Specifying this will skip looking up testhost.exe and will force usage of the testhost.dll.

When true, we capture standard output of child processes. When false the standard output is not captured and it will end up in command line. This makes the output visible to the user when running in vstest.console in-process. Such setup makes the behavior the same as in 17.6.3 and earlier. The recommended way is to use this with ForwardStandardOutput=true to forward output as informational messages so the output is always visible in console and VS, unless the logging level is set to Warning or higher. Lastly this can be used with ForwardStandardOutput=false, to suppress the output in console, which is behavior of 17.7.0 till now.

Forward captured standard output of testhost as Informational test messages. Default is true. Needs CaptureStandardOutput to be true.

Disables sharing of .NET Framework testhosts.

Skips passing VisualStudio built in adapters to the project.

Loads RunConfiguration from XmlReader.

XmlReader having run configuration node.

Exception thrown by Run Settings when an error with a settings provider is encountered.

Default Constructor

Initializes with the message.

Message for the exception.

Initializes with message and inner exception.

Message for the exception. The inner exception.

Serialization constructor.

Attribute applied to ISettingsProviders to associate it with a settings name. This name will be used to request the settings from the RunSettings.

Initializes with the name of the settings.

Name of the settings

The name of the settings.

This class deals with the run settings, Test Run Parameters node and the extracting of Key Value Pair's from the parameters listed.

Get the test run parameters from the provided reader.

The reader. The dictionary of test run parameters. Throws when format is incorrect.

Stores information about a test settings.

Initializes with the name of the test case.

The name of the test case.

Gets the name of the test settings. Do not put a private setter on this Chutzpah adapter checks for setters of all properties and it throws error if its private during RunSettings.LoadSection() call TODO: Communicate to Chutzpah and fix it

Converter the setting to be an XmlElement.

The Xml element for the run settings provided.

Initialize an TelemetryEvent

Telemetry event name Telemetry event properties

Telemetry event name.

Telemetry event properties.

Represents a loading strategy

A strategy not defined, Test Platform will load adapters normally.

Test Platform will only load adapters specified by /TestAdapterPath (or RunConfiguration.TestAdaptersPaths node). If a specific adapter path is provided, adapter will be loaded; if a directory path is provided adapters directly in that folder will be loaded. If no adapter path is specified, test run will fail. This will imply /InIsolation switch and force the tests to be run in an isolated process.

Load adapters next to source.

Default runtime providers inside Extensions folder will be included.

Load adapters inside Extensions folder.

Directory wide searches will be recursive, this is required to be used with or .

Stores information about a test case.

Initializes a new instance of the class.

This constructor doesn't perform any parameter validation, it is meant to be used for serialization."/>

Initializes a new instance of the class.

Fully qualified name of the test case. The Uri of the executor to use for running this test. Test container source from which the test is discovered.

LocalExtensionData which can be used by Adapter developers for local transfer of extended properties. Note that this data is available only for in-Proc execution, and may not be available for OutProc executors

Gets or sets the id of the test case.

Gets or sets the fully qualified name of the test case.

Gets or sets the display name of the test case.

Gets or sets the Uri of the Executor to use for running this test.

Gets the test container source from which the test is discovered.

Gets or sets the source code file path of the test.

Gets or sets the line number of the test.

Returns the TestProperties currently specified in this TestObject.

Creates a Id of TestCase

Guid test id

Return TestProperty's value

Set TestProperty's value

Well-known TestCase properties

These are the core Test properties and may be available in commandline/TeamBuild to filter tests. These Property names should not be localized.

Base class for test related classes.

The store for all the properties registered.

Property used for Json (de)serialization of store dictionary. Serialization of dictionaries by default doesn't provide the required object representation. List of KeyValuePair on the other hand provides a clean Key, Value entries for TestProperty and it's value.

Returns the TestProperties currently specified in this TestObject.

Returns property value of the specify TestProperty

TestObject's TestProperty property value

Returns property value of the specify TestProperty

Property value type TestObject's TestProperty default property value if property is not present property value

Set TestProperty's value

Property value type TestObject's TestProperty value to be set

Set TestProperty's value

Property value type TestObject's TestProperty value to be set

Set TestProperty's value

TestObject's TestProperty value to be set

Remove test property from the current TestObject.

Returns TestProperty's value

property's value. default value is returned if the property is not present

Set TestProperty's value to the specified value T.

Return TestProperty's value

Set TestProperty's value

Convert passed in value from TestProperty's specified value type.

Converted object

Convert passed in value into the specified type when property is registered.

Converted object

Represents the outcomes of a test case.

Test Case Does Not Have an outcome.

Test Case Passed

Test Case Failed

Test Case Skipped

Test Case Not found

Helper methods for working with the TestOutcome enum.

Converts the outcome into its localized string representation.

The outcome to get the string for. The localized outcome string.

The test process info payload.

Creates a new instance of this class.

The process id the debugger should attach to.

The start info of the test runner

The name of the test runner exe

The arguments for the test runner

The working directory for the test runner

The associated environment variables

Any additional custom properties that might be required for the launch For example - emulator ID, remote machine details etc.

Converts a json representation of to an object.

Initializes a new instance of the class.

Gets or sets the Id for the property.

Gets or sets a label for the property.

Gets or sets a category for the property.

Gets or sets a description for the property.

Gets the callback for validation of property value.

This property is not required at the client side.

Gets or sets the attributes for this property.

Gets or sets a string representation of the type for value.

Gets the valueType.

Only works for the valueType that is in the currently executing assembly or in Mscorlib.dll. The default valueType is of string valueType. The valueType of the test property

Represents the result of a test case.

Initializes a new instance of the class.

The test case the result is for.

Gets the test case that this result is for.

Gets the list of attachment sets for this TestResult.

Gets or sets the outcome of a test case.

Gets or sets the exception message.

Gets or sets the exception stack trace.

Gets or sets the TestResult Display name. Used for Data Driven Test (i.e. Data Driven Test. E.g. InlineData in xUnit)

Gets the test messages.

Gets or sets test result ComputerName.

Gets or sets the test result Duration.

Gets or sets the test result StartTime.

Gets or sets test result EndTime.

Returns the TestProperties currently specified in this TestObject.

Return TestProperty's value

Set TestProperty's value

Represents the test result message.

Standard Output Message Category

Standard Error Message Category

Debug Trace Message Category

Additional Information Message Category

Initializes a new instance of the class.

Category of the message. Text of the message.

Gets the message category

Gets the message text

Well-known TestResult properties

Class that holds Trait. A traits is Name, Value pair.

Class that holds collection of traits

Defines the constants used during UWP app execution.

The UWP PackageName after it is deployed.

The UWP Package ID after it is deployed.

Implementation of finding assembly references using "managed route", i.e. Assembly.Load.

Checks whether the source assembly directly references given assembly or not. Only assembly name and public key token are match. Version is ignored for matching. Returns null if not able to check if source references assembly.

Finds platform and .Net framework version for a given test container. If there is an error while inferring this information, defaults (AnyCPU, None) are returned for faulting container.

Returns the full name (AssemblyName.FullName) of the referenced assemblies by the assembly on the specified path. Returns null on failure and an empty array if there is no reference in the project.

Full path to the assembly to get dependencies for.

Set the target framework for app domain setup if target framework of dll is > 4.5

AppdomainSetup for app domain creation path of test file

Get the target dot net framework string for the assembly

Path of the assembly file String representation of the target dot net framework e.g. .NETFramework,Version=v4.0

Get the Version for the target framework version string

Target framework string Framework Version

When test run is targeted for .Net4.0, set target framework of test appdomain to be v4.0. With this done tests would be executed in 4.0 compatibility mode even when .Net4.5 is installed.

Does the real work of finding references using Assembly.ReflectionOnlyLoadFrom. The caller is supposed to create AppDomain and create instance of given class in there.

Get the target dot net framework string for the assembly

Path of the assembly file String representation of the target dot net framework e.g. .NETFramework,Version=v4.0

Get the target dot net framework string for the assembly

Assembly String representation of the target dot net framework e.g. .NETFramework,Version=v4.0

Returns the full name of the referenced assemblies by the assembly on the specified path. Returns null on failure and an empty array if there is no reference in the project.

Path to the assembly file to load from.

Returns true if given assembly matched name and public key token.

Finds platform and .Net framework version for a given container. In case of errors defaults are returned.

Wrapper class for cryptographic hashing. This class uses SHA1 instead of MD5 in order to conform to the FIPS standard.

Calculates a hash of the string and copies the first 128 bits of the hash to a new Guid.

Escapes a set of special characters for filter (%, (, ), &, |, =, !, ~) by replacing them with their escape sequences.

The input string that contains the text to convert. A string of characters with special characters converted to their escaped form.

Converts any escaped characters in the input filter string.

The input string that contains the text to convert. A filter string of characters with any escaped characters converted to their un-escaped form.

Used to calculate SHA1 hash. https://tools.ietf.org/html/rfc3174

SHA-1 Implementation as in https://tools.ietf.org/html/rfc3174

This implementation only works with messages with a length that is a multiple of the size of 8-bits.

A sequence of logical functions to be used in SHA-1. Each f(t), 0 <= t <= 79, operates on three 32-bit words B, C, D and produces a 32-bit word as output.

Function index. 0 <= t <= 79 Word B Word C Word D f(t;B,C,D) = (B AND C) OR ((NOT B) AND D) ( 0 <= t <= 19) f(t;B,C,D) = B XOR C XOR D (20 <= t <= 39) f(t;B,C,D) = (B AND C) OR (B AND D) OR (C AND D) (40 <= t <= 59) f(t;B,C,D) = B XOR C XOR D (60 <= t <= 79)

Returns a constant word K(t) which is used in the SHA-1.

Word index. K(t) = 0x5A827999 ( 0 <= t <= 19) K(t) = 0x6ED9EBA1 (20 <= t <= 39) K(t) = 0x8F1BBCDC (40 <= t <= 59) K(t) = 0xCA62C1D6 (60 <= t <= 79)

The circular left shift operation.

An uint word. 0 <= n < 32 S^n(X) = (X << n) OR (X >> 32-n)

Ensures that given bytes are in big endian notation.

An array of bytes

Utility methods for manipulating strings.

Prepares the string for output by converting null values to the "(null)" string and removing any trailing new lines.

The input string. The string that is prepared for output.

Checks if given string is null or a whitespace.

string to check True if string is null or a whitespace, false otherwise

Suspends the instrumentation (for code coverage) of the modules which are loaded during this object is created and disposed exceeded.

Whether the object is disposed or not.

Constructor. Code Coverage instrumentation of the modules, which are loaded during this object is created and disposed, is disabled.

Disposes this instance

Disposes instance.

Should dispose.

Utility methods for working with an XmlReader.

Reads up to the next Element in the document.

Reader to move to the next element.

Skips the current element and moves to the next Element in the document.

Reader to move to the next element.

Reads to the root node of the run settings and verifies that it is a "RunSettings" node.

XmlReader for the file.

Utilities for the run settings XML.

Gets the os architecture of the machine where this application is running

Gets the settings to be used while creating XmlReader for runsettings.

Examines the given XPathNavigable representation of a runsettings file and determines if it has a configuration node for the data collector (used for Fakes and CodeCoverage)

XPathNavigable representation of a runsettings file The data Collector Uri. True if there is a datacollector configured.

Get the list of friendly name of all data collector present in runsettings.

runsettings xml string List of friendly name

Inserts a data collector settings in the file

runSettingDocument settings

Returns RunConfiguration from settingsXml.

The run settings. The RunConfiguration node as defined in the settings xml.

Gets the set of user defined test run parameters from settings xml as key value pairs.

The run settings xml. The test run parameters defined in the run settings. If there is no test run parameters section defined in the settings xml a blank dictionary is returned.

Create a default run settings

The .

Returns whether data collection is enabled in the parameter settings xml or not

The run Settings Xml. True if data collection is enabled.

Returns whether in-proc data collection is enabled in the parameter settings xml or not

The run Settings Xml. True if data collection is enabled.

Get DataCollection Run settings from the settings XML.

The run Settings Xml. The .

Get InProc DataCollection Run settings

The run Settings Xml. Data collection run settings.

Get logger run settings from the settings XML.

The run Settings Xml. The .

Throws a settings exception if the node the reader is on has attributes defined.

The xml reader.

Throws a settings exception if the node the reader is on doesn't have attributes defined.

The xml reader.

Moves the given runsettings file navigator to the DataCollectors node in the runsettings xml. Throws XmlException if it was unable to find the DataCollectors node.

XPathNavigator for a runsettings xml document.

Only to be used to Test platform, to exclude auto generated code from CodeCoverage

Internal cache key used to store framework compatibility.

Check if the frameworks are compatible.

Project framework Other framework to check against the project framework True if framework supports other

Actual compatibility check without caching

Find all equivalent frameworks, and their equivalent frameworks. Example: Mappings: A <‒> B B <‒> C C <‒> D For A we need to find B, C, and D so we must retrieve equivalent frameworks for A, B, and C also as we discover them.

Singleton instance of the default framework mappings.

Contains the standard portable framework mappings

Static instance of the portable framework mappings

List framework to fall back to.

Interned frameworks that are commonly used in NuGet

FrameworkExpander finds all equivalent and compatible frameworks for a NuGetFramework

Return all possible equivalent, subset, and known compatible frameworks.

Finds all expansions using the mapping provider

Legacy frameworks that are allowed to have a single digit for the version number.

Frameworks that must always include a decimal point (period) between numerical parts.

Contains identifier -> identifier Ex: .NET Framework -> .NET Framework Ex: NET Framework -> .NET Framework This includes self mappings.

Converts a key using the mappings, or if the key is already converted, finds the normalized form.

Get all equivalent frameworks including the given framework

2 way per framework profile equivalence

2 way framework equivalence

Sorts frameworks according to the framework mappings

An inclusive range of frameworks

Minimum Framework

Maximum Framework

Minimum version inclusiveness.

Maximum version inclusiveness.

Framework Identifier of both the Min and Max

True if the framework version falls between the min and max

Reduces a list of frameworks into the smallest set of frameworks required.

Creates a FrameworkReducer using the default framework mappings.

Creates a FrameworkReducer using custom framework mappings.

Returns the nearest matching framework that is compatible.

Project target framework Possible frameworks to narrow down Nearest compatible framework. If no frameworks are compatible null is returned.

Remove duplicates found in the equivalence mappings.

Reduce to the highest framework Ex: net45, net403, net40 -> net45

Reduce to the lowest framework Ex: net45, net403, net40 -> net40

Create lookup of the given PCLs to their actual frameworks

portable-net45+win8 -> net45, win8

Order PCLs when there is no other way to decide.

Sort PCLs using these criteria 1. Lowest number of frameworks (highest surface area) wins first 2. Profile with the highest version numbers wins next 3. String compare is used as a last resort

A keyvalue pair specific to a framework identifier

Get a list of frameworks supporting the provided framework. This list is not meant to be exhaustive but is instead meant to be human-readable. Ex: netstandard1.5 -> netstandardapp1.5, net462, dnxcore50, ...

Ex: IsCompatible(net45, net40) -> true Ex: IsCompatible(net40, net45) -> false

Project target framework Library framework that is going to be installed True if framework supports other

A raw list of framework mappings. These are indexed by the framework name provider and in most cases all mappings are mirrored so that the IFrameworkMappings implementation only needs to provide the minimum amount of mappings.

Synonym ‒> Identifier Ex: NET Framework ‒> .NET Framework

Ex: .NET Framework ‒> net

Ex: WindowsPhone ‒> wp

Equal frameworks. Used for legacy conversions. ex: Framework: Win8 <‒> Framework: NetCore45 Platform: Win8

Framework, EquivalentProfile1, EquivalentProfile2 Ex: Silverlight, WindowsPhone71, WindowsPhone

Frameworks which are subsets of others. Ex: .NETCore ‒> .NET Everything in .NETCore maps to .NET and is one way compatible. Version numbers follow the same format.

Additional framework compatibility rules beyond name and version matching. Ex: .NETFramework supports ‒> Native

Ordered list of framework identifiers. The first framework in the list will be preferred over other framework identifiers. This is enable better tie breaking in scenarios where legacy frameworks are equivalently compatible to a new framework. Example: UAP10.0 ‒> win81, wpa81

Same as but is only referred to if all of the packages in consideration are package based (determined by ).

Only used to choose between frameworks that are equivalent. This favors more human-readable target frameworks identifiers.

Rewrite folder short names to the given value. Ex: dotnet50 ‒> dotnet

Rewrite full framework names to the given value. Ex: .NETPlatform,Version=v0.0 ‒> .NETPlatform,Version=v5.0

Returns the official framework identifier for an alias or short name.

Gives the short name used for folders in NuGet

Get the official profile name from the short name.

Returns the shortened version of the profile name.

Parses a version string using single digit rules if no dots exist

Parses a version string. If no dots exist, all digits are treated as semver-major, instead of inserting dots.

Returns a shortened version. If all digits are single digits no dots will be used.

Tries to parse the portable profile number out of a profile.

Looks up the portable profile number based on the framework list.

Returns the frameworks based on a portable profile number.

Returns the frameworks based on a profile string. Profile can be either the number in format: Profile=7, or the shortened NuGet version: net45+win8

Parses a shortened portable framework profile list. Ex: net45+win8

Returns ranges of frameworks that are known to be supported by the given portable profile number. Ex: Profile7 -> netstandard1.1

Returns a list of all possible substitutions where the framework name have equivalents. Ex: sl3 -> wp8

Gives all substitutions for a framework range.

Returns ranges of frameworks that are known to be supported by the given framework. Ex: net45 -> native

Returns all sub sets of the given framework. Ex: .NETFramework -> .NETCore These will have the same version, but a different framework

The ascending order of frameworks should be based on the following ordered groups: 1. Non-package-based frameworks in . 2. Other non-package-based frameworks. 3. Package-based frameworks in . 4. Other package-based frameworks. For group #1 and #3, the order within the group is based on the order of the respective precedence list. For group #2 and #4, the order is the original order in the incoming list. This should later be made consistent between different input orderings by using the .

netcore50 is a special case since netcore451 is not packages based, but netcore50 is. This sort will treat all versions of netcore as non-packages based.

Used to pick between two equivalent frameworks. This is meant to favor the more human-readable framework. Note that this comparison does not validate that the provided frameworks are indeed equivalent (e.g. with ).

Returns folder short names rewrites. Ex: dotnet50 -> dotnet

Returns full name rewrites. Ex: .NETPlatform,Version=v0.0 -> .NETPlatform,Version=v5.0

Returns all versions of .NETStandard in ascending order.

Returns a list of frameworks that could be compatible with .NETStandard.

A group or object that is specific to a single target framework

Target framework

Ex: 5 -> net4, win8

Additional optional frameworks supported in a portable profile. Ex: 5 -> MonoAndroid1+MonoTouch1

Compatibility mapping for portable profiles. This is a separate compatibility from that in .

A portable implementation of the .NET FrameworkName type with added support for NuGet folder names.

Creates a new NuGetFramework instance, with an optional profile (only available for netframework)

Creates a new NuGetFramework instance, with an optional platform and platformVersion (only available for net5.0+)

Target framework

Target framework version

Framework Platform (net5.0+)

Framework Platform Version (net5.0+)

True if the platform is non-empty

True if the profile is non-empty

Target framework profile

The TargetFrameworkMoniker identifier of the current NuGetFramework.

Formatted to a System.Versioning.FrameworkName

The TargetFrameworkMoniker identifier of the current NuGetFramework.

Formatted to a System.Versioning.FrameworkName

The TargetPlatformMoniker identifier of the current NuGetFramework.

Similar to a System.Versioning.FrameworkName, but missing the v at the beginning of the version.

Creates the shortened version of the framework using the default mappings. Ex: net45

Helper that is .NET 5 Era aware to replace identifier when appropriate

Creates the shortened version of the framework using the given mappings.

Portable class library check

True if the framework is packages based. Ex: dotnet, dnxcore, netcoreapp, netstandard, uap, netcore50

True if this framework matches for all versions. Ex: net

True if this framework was invalid or unknown. This framework is only compatible with Any and Agnostic.

True if this framework is non-specific. Always compatible.

True if this is the any framework. Always compatible.

True if this framework is real and not one of the special identifiers.

True if this framework is Net5 or later, until we invent something new.

Full framework comparison of the identifier, version, profile, platform, and platform version

Framework name only comparison.

Frameworks that are packages based across all versions.

An unknown or invalid framework

A framework with no specific target framework. This can be used for content only packages.

A wildcard matching all frameworks

Creates a NuGetFramework from a folder name using the default mappings.

Creates a NuGetFramework from a folder name using the given mappings.

Creates a NuGetFramework from individual components

Creates a NuGetFramework from individual components, using the given mappings. This method may have individual component preference, as described in the remarks.

Profiles and TargetPlatforms can't mix. As such the precedence order is profile over target platforms (TPI, TPV). .NETCoreApp,Version=v5.0 and later do not support profiles. Target Platforms are ignored for any frameworks not supporting them. This allows to handle the old project scenarios where the TargetPlatformIdentifier and TargetPlatformVersion may be set to Windows and v7.0 respectively.

Creates a NuGetFramework from a .NET FrameworkName

Creates a NuGetFramework from a folder name using the default mappings.

Creates a NuGetFramework from a folder name using the given mappings.

Attempt to parse a common but deprecated framework using an exact string match Support for these should be dropped as soon as possible.

A set of special and common frameworks that can be returned from the list of constants without parsing Using the interned frameworks here optimizes comparisons since they can be checked by reference. This is designed to optimize

A case insensitive compare of the framework, version, and profile

A case insensitive compare of the framework name only

Sorts NuGet Frameworks in a consistent way for package readers. The order is not particularly useful here beyond making things deterministic since it compares completely different frameworks.

Find the most compatible group based on target framework

framework specific groups or items project target framework retrieves the framework from the group

Find the most compatible group based on target framework

framework specific groups or items project target framework retrieves the framework from the group framework mappings compatibility provider

Find the most compatible group based on target framework

framework specific groups or items project target framework

Find the most compatible group based on target framework

framework specific groups or items project target framework framework mappings compatibility provider

Check compatibility with additional checks for the fallback framework.

True if the framework is netcore50 or higher. This is where the framework becomes packages based.

Creates a one way compatibility mapping. Ex: net -supports-> native

Project framework Framework that is supported by the project framework

Primary framework range or project target framework that supports the SuppportedFrameworkRange

Framework range that is supported by the TargetFrameworkRange

Hash code creator, based on the original NuGet hash code combiner/ASP hash code combiner implementations

Create a unique hash code for the given set of items

Avoids allocating an enumerator when enumerating an .

Returns a struct-based enumerator that avoids heap allocation during enumeration. If the underlying type is then this method will delegate to , otherwise the collection's items are accessed by index via 's indexer directly. When using a struct-based enumerator, no heap allocation occurs during enumeration via . This is in contrast to the interface-based enumerator which will always be allocated on the heap.


              list = ...;
            
             foreach (string item in list.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Avoids allocating an enumerator when enumerating an where the concrete type has a well known struct enumerator, such as for , or when index-based access is possible via .

Several collection types (e.g. ) provide a struct-based enumerator type (e.g. ) which the compiler can use in statements. When using a struct-based enumerator, no heap allocation occurs during such enumeration. This is in contrast to the interface-based enumerator which will always be allocated on the heap. This method returns a custom struct enumerator that will avoid any heap allocation if (which is declared via interface ) is actually of known concrete type that provides its own struct enumerator. If so, it delegates to that type's enumerator without any boxing or other heap allocation. If is not of a known concrete type, the returned enumerator falls back to the interface-based enumerator, which will be allocated on the heap. Benchmarking shows the overhead in such cases is low enough to be within the measurement error, meaning this is an inexpensive optimization that won't regress behavior and with low downside for cases where it cannot apply an optimization.


              source = ...;
            
             foreach (string item in source.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Avoids allocating an enumerator when enumerating an where the concrete type has a well known struct enumerator, such as for .


              dictionary = ...;
            
             foreach ((string key, string value) in dictionary.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Provides a resource pool that enables reusing instances of instances.

Renting and returning buffers with an can increase performance in situations where instances are created and destroyed frequently, resulting in significant memory pressure on the garbage collector. This class is thread-safe. All members may be used by multiple threads concurrently.

Retrieves a shared instance.

Retrieves a that is at least the requested length.

The minimum capacity of the needed. A that is at least in length. This buffer is loaned to the caller and should be returned to the same pool via so that it may be reused in subsequent usage of . It is not a fatal error to not return a rented string builder, but failure to do so may lead to decreased application performance, as the pool may need to create a new instance to replace the one lost.

Returns to the pool an array that was previously obtained via on the same instance, returning the built string.

The previously obtained from to return to the pool. Once a has been returned to the pool, the caller gives up all ownership of the instance and must not use it. The reference returned from a given call to must only be returned via once. The default may hold onto the returned instance in order to rent it again, or it may release the returned instance if it's determined that the pool already has enough instances stored. The string, built from .