MiniProfiler

BaseProfilerProvider. This providers some helper methods which provide access to internals not otherwise available. To use, override the , and methods.

A provider used to create instances and maintain the current instance.

Starts a new MiniProfiler and sets it to be current. By the end of this method should return the new MiniProfiler.

The to use. Allows explicit naming of the new profiling session; when null, an appropriate default will be used, e.g. for a web request, the url will be used for the overall session name.

Ends the current profiling session, if one exists.

When true, clears the for this HttpContext, allowing profiling to be prematurely stopped and discarded. Useful for when a specific route does not need to be profiled.

Returns the current MiniProfiler. This is used by .

Starts a new MiniProfiler and sets it to be current. By the end of this method should return the new MiniProfiler.

Stops the current MiniProfiler (if any is currently running). should be called if is false

If true, any current results will be thrown away and nothing saved

Returns the current MiniProfiler. This is used by .

Sets to be active (read to start profiling) This should be called once a new MiniProfiler has been created.

If is null

Stops the profiler and marks it as inactive.

True if successful, false if Stop had previously been called on this profiler If is null

Calls to save the current profiler using the current storage settings. If is set, this will be used.

Times collected from the client

Returns null if there is not client timing stuff

Gets or sets the list of client side timings

Gets or sets the redirect count.

A client timing probe

Gets or sets the name.

Gets or sets the start.

Gets or sets the duration.

Unique Identifier used for sql storage.

Not set unless storing in Sql

Used for sql storage

Not set unless storing in Sql

A custom timing that usually represents a Remote Procedure Call, allowing better visibility into these longer-running calls.

Don't use this.

Returns a new CustomTiming, also initializing its and, optionally, its .

OPTIONAL - call after receiving the first response from your Remote Procedure Call to properly set .

Stops this timing, setting .

Returns for debugging.

Unique identifier for this .

Gets or sets the command that was executed, e.g. "select * from Table" or "INCR my:redis:key"

Short name describing what kind of custom timing this is, e.g. "Get", "Query", "Fetch".

Gets or sets roughly where in the calling code that this custom timing was executed.

Gets or sets the offset from main MiniProfiler start that this custom command began.

Gets or sets how long this custom command statement took to execute.

OPTIONAL - how long this tim took to come back initially from the remote server, before all data is fetched and command is completed.

Understands how to route and respond to MiniProfiler UI URLS.

Embedded resource contents keyed by filename.

Usually called internally, sometimes you may clear the routes during the apps lifecycle, if you do that call this to bring back mini profiler.

Returns this to handle .

Returns either includes' css/javascript or results' html.

Renders script tag found in "include.partial.html".

Handles rendering static content files.

Returns true if the current request is allowed to see the profiler response.

Returns either json or full page html of a previous MiniProfiler session, identified by its "?id=GUID" on the query.

Gets a value indicating whether to keep things static and reusable.

Takes a SqlTiming and returns a formatted SQL string, for parameter replacement, etc.

Return SQL the way you want it to look on the in the trace. Usually used to format parameters.

Extensions for ISqlFormatter instances

Format sql using the FormatSql method available in the current .

It is preferable to use this rather than accessing directly, as this method will detect whether an is being used, and will access it properly. This may be removed in a future major version when can be consolidated back into .

Formats SQL server queries with a DECLARE up top for parameter values

Lookup a function for translating a parameter by parameter type

What data types should not be quoted when used in parameters

Initialises static members of the class.

Formats the SQL in a SQL-Server friendly way, with DECLARE statements for the parameters up top.

This function is necessary to always return the sql statement terminated with a semicolon. Since we're using semicolons, we should also add it to the end.

Generate formatter output text for all .

to use Parameters to evaluate

Prepare the parameter value for use in SqlFormatter output

The constructor

Formats the SQL in a SQL-Server friendly way, with DECLARE statements for the parameters up top.

Should meta data relating to the command type, database and transaction be included in sql output

Profiles a single SQL execution.

Holds the maximum size that will be stored for byte[] parameters

Initialises a new instance of the class. Creates a new SqlTiming to profile 'command'.

Returns a snippet of the SQL command and the duration.

Returns true if Ids match.

Returns hash code of Id.

Called when command execution is finished to determine this SqlTiming's duration.

Called when database reader is closed, ending profiling for SqlTimings.

Returns the value of suitable for storage/display.

To help with display, put some space around crowded commas.

Returns better parameter information for . Returns null if no parameters are present.

Gets or sets the offset from main MiniProfiler start that this custom command began.

Information about a DbParameter used in the sql statement profiled by SqlTiming.

Returns true if this has the same parent and as .

Returns the XOR of certain properties.

Returns name and value for debugging.

Parameter name, e.g. "routeName"

The value submitted to the database.

System.Data.DbType, e.g. "String", "Bit"

How large the type is, e.g. for string, size could be 4000

System.Data.ParameterDirection: "Input", "Output", "InputOutput", "ReturnValue"

Gets or sets a value that indicates whether the parameter accepts null values.

Understands how to save MiniProfiler results to a MSSQL database, allowing more permanent storage and querying of slow results.

Provides saving and loading s to a storage medium.

List the latest profiling results.

Stores under its .

The results of a profiling session. Should also ensure the profiler is stored as being un-viewed by its profiling .

Returns a from storage based on , which should map to .

Should also update that the resulting profiler has been marked as viewed by its profiling .

Sets a particular profiler session so it is considered "un-viewed"

Sets a particular profiler session to "viewed"

Returns a list of s that haven't been seen by .

User identified by the current MiniProfiler.Settings.UserProvider

Initialises a new instance of the class. Returns a new SqlServerDatabaseStorage object that will insert into the database identified by connectionString.

The connection String.

Initialises a new instance of the class. Returns a new SqlServerDatabaseStorage object that will insert into the database identified by connection string settings.

The connection string settings read from ConfigurationManager.ConnectionStrings["connection"]

Saves 'profiler' to a database under its .

The profiler.

Returns the MiniProfiler identified by 'id' from the database or null when no MiniProfiler exists under that 'id'.

The id. the mini profiler

Sets a particular profiler session so it is considered "un-viewed"

The user. The id.

Sets a particular profiler session to "viewed"

The user. The id.

Returns a list of s that haven't been seen by .

User identified by the current MiniProfiler.Settings.UserProvider. the list of keys for the supplied user

Implement a basic list search here

The max number of results. The start. The finish. order By. the list of GUID keys

Gets or sets how we connect to the database used to save/load MiniProfiler results.

Allow for results to be stored in and retrieved from multiple IStorage stores. When reading Loading a MiniProfiler, will load from the first Store that returns a record for the Guid. When saving, will save in all Stores.

Ideal usage scenario - you want to store requests in Cache and Sql Server, but only want to retrieve from Cache if it is available

Create the with the given collection of objects (order is important!)

The objects to use for storage (order is important!)

Run the List command on the first Store from that returns a result with any values. Will NOT return a superset of results from all .

Stores under its in all of the .

The results of a profiling session. Should also ensure the profiler is stored as being un-viewed by its profiling .

Returns a from storage based on , which should map to . Will check in all of the classes in , and will return the first that it finds.

Should also update that the resulting profiler has been marked as viewed by its profiling .

Sets a particular profiler session so it is considered "un-viewed". Will set this to all items in

Sets a particular profiler session to "viewed". Will set this to all items in

Runs on each object in and returns the Union of results. Will run on multiple stores in parallel if = true.

The stores that are exposed by this

Should operations use Parallel.ForEach when it makes sense to do so (all save operations, and data retrieval where all items in are hit? If False, all operations will run synchronously, in order. Defaults to False.

Understands how to store a to a MSSQL database.

Load the SQL statements (using Dapper Multiple Results)

Initializes a new instance of the class with the specified connection string.

The connection string to use.

Initializes a new instance of the class with the specified connection string settings.

The connection string settings read from ConfigurationManager.ConnectionStrings["connection"]

Stores to dbo.MiniProfilers under its ;

The Mini Profiler

Loads the MiniProfiler identified by 'id' from the database.

The id. the mini profiler.

Sets the session to un-viewed

The user. The id.

sets the session to viewed

The user. The id.

Returns a list of s that haven't been seen by .

User identified by the current UserProvider"/>. the list of keys.

List the Results.

The max results. The start. The finish. order by. the list of key values.

Load individual MiniProfiler

The connection. The id Parameter. Related MiniProfiler object

Build the subtree of objects with at the top. Used recursively.

Parent to be evaluated. Key: parent timing Id; Value: collection of all objects under the given parent.

Returns a connection to Sql Server.

Returns a DbConnection already opened for execution.

Creates needed tables. Run this once on your database.

Works in SQL server and sqlite (with documented removals).

An individual suppression block that deactivates profiling temporarily

Initialises a new instance of the class. Obsolete - used for serialization.

Initialises a new instance of the class. Creates a new Suppression to deactive profiling while alive

Gets a reference to the containing profiler, allowing this Suppression to affect profiler activity.

Categories of SQL statements.

Unknown type

DML statements that alter database state, e.g. INSERT, UPDATE

Statements that return a single record

Statements that iterate over a result set

A call back for ProfiledDbConnection and family

Called when a command starts executing

The profiled dB Command. The execute Type.

Called when a reader finishes executing

The profiled DB Command. The execute Type. The reader.

Called when a reader is done iterating through the data

The reader.

Called when an error happens during execution of a command

The profiled DB Command. The execute Type. The exception.

Gets a value indicating whether or not the profiler instance is active

A general implementation of that uses an to collect profiling information.

The command.

The connection.

The profiler.

The transaction.

Initialises a new instance of the class. Creates a new wrapped command

The wrapped command The wrapped connection the command is attached to The profiler to use

prepare the command.

cancel the command.

create a new parameter.

The .

execute a non query.

The .

execute the reader.

The .

execute the reader.

The behavior. the active reader.

execute and return a scalar.

the scalar value.

profile with results.

The type of execution. a function to execute against against the profile result the type of result to return.

dispose the command / connection and profiler.

false if the dispose is called from a finalizer

clone the command.

The .

Gets or sets the connection.

Gets or sets the transaction.

Gets or sets the command text.

Gets or sets the command timeout.

Gets or sets the command type.

Gets the parameters.

Gets or sets the updated row source.

A general implementation of IDbConnection that uses an to collect profiling information.

The profiler.

The connection.

Initialises a new instance of the class. Creates a simple profiled connection instance.

The database connection to wrap The profiler to use

begin the transaction.

The .

begin a transaction.

The isolation Level. the wrapped transaction

change the database.

The database name.

create a new command.

The .

close the connection

open the connection

dispose the command / connection and profiler.

false if the dispose is called from a finalizer

Gets or sets the connection string.

Gets the connection timeout.

Gets the database.

Gets the state.

Gets the internally wrapped

A simple profiled data reader.

The reader.

The profiler.

Initialises a new instance of the class.

The reader. The profiler.

get the name.

The index. a string containing the name

get the data type name.

The index. The .

get the field type.

The index. The .

get the value.

The index. The .

get the values.

The values. The .

get the ordinal.

The name. The .

The get boolean.

The index. The .

The get byte.

The index. The .

Gets the value for the column specified by the ordinal as an array of objects.

The index. The field Offset. The buffer. The buffer offset. The length. The number of bytes copied.

The get char.

The index. The .

Gets the value for the column specified by the ordinal as an array of objects.

The index. The field offset. The buffer. The buffer offset. The length. The .

get the GUID.

The index. The .

Gets the value for the column specified by the ordinal as a .

The index. The .

Gets the value for the column specified by the ordinal as a .

The index. The .

Gets the value for the column specified by the ordinal as a .

The index. The .

The get float.

The index. The .

The get double.

The index. The .

The get string.

The index. The .

The get decimal.

The index. The .

The get date time.

The index. The .

The get data.

The index. The .

Returns true if the column specified by the column ordinal parameter is null.

The index. The .

The close.

The get schema table.

The .

The next result.

The .

read from the underlying reader.

The .

dispose the command / connection and profiler.

false if the dispose is called from a finalizer

Gets the field count.

The

The index. The .

The

The name. The .

Gets the depth.

Gets a value indicating whether is closed.

Gets the number of records affected.

Provides a wrapper around a native DbDataAdapter, allowing a profiled Fill operation.

This static variable is simply used as a non-null placeholder in the MiniProfiler.ExecuteFinish method

The profiler.

The adapter.

The select command.

The insert command.

The update command.

The delete command.

Initialises a new instance of the class.

The wrapped adapter. The profiler.

Adds a named "Table" to the specified and configures the schema to match that in the data source based on the specified .

The to be filled with the schema from the data source. One of the values. An array of objects that contain schema information returned from the data source.

Adds or updates rows in the to match those in the data source using the name, and creates a named "Table".

A to fill with records and, if necessary, schema. The number of rows successfully added to or refreshed in the . This does not include rows affected by statements that do not return rows.

Adds or refreshes rows in a specified range in the .

This function will only work if you are using an implementation that inherits from . This includes and most other similar classes. The number of rows successfully added to or refreshed in the . This does not include rows affected by statements that do not return rows. The to use for table mapping. The source table is invalid or being used with an implementation that does not inherit from .

Gets the parameters set by the user when executing an SQL SELECT statement.

An array of objects that contains the parameters set by the user.

Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified from a named "Table".

The used to update the data source. The number of rows successfully updated from the . An attempt to execute an INSERT, UPDATE, or DELETE statement resulted in zero records affected.

Gets the underlying adapter. Useful for when APIs can't handle the wrapped adapter (e.g. CommandBuilder).

Gets or sets whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

One of the values. The default is Passthrough.

Gets or sets whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

One of the values. The default is Add. The value set is not one of the values.

Gets how a source table is mapped to a dataset table.

A collection that provides the master mapping between the returned records and the . The default value is an empty collection.

Gets or sets an SQL statement used to select records in the data source.

An that is used during to select records from data source for placement in the data set.

Gets or sets an SQL statement used to insert new records into the data source.

An used during to insert records in the data source for new rows in the data set.

Gets or sets an SQL statement used to update records in the data source.

An used during to update records in the data source for modified rows in the data set.

Gets or sets an SQL statement for deleting records from the data set.

An used during to delete records in the data source for deleted rows in the data set.

Wrapper for a database provider factory to enable profiling

Every provider factory must have an Instance public field

The tail.

Initialises a new instance of the class. proxy provider factory

The tail.

Prevents a default instance of the class from being created. Used for database provider APIS internally

create the command.

The .

create the command builder.

The .

create the connection.

The .

create the connection string builder.

The .

create the data adapter.

The .

create the data source enumerator.

The .

create the parameter.

The .

create the permission.

The state. The .

Allow to re-initialise the provider factory.

The tail.

Gets a value indicating whether a data source enumerator can be created.

A general implementation of that is used to wrap profiling information around calls to it.

The transaction.

The connection.

Creates a new wrapped

commit the transaction.

rollback the transaction

dispose the command / connection and profiler.

Gets the internal wrapped transaction

Gets the connection.

Gets the isolation level.

Common extension methods to use only in this project

Answers true if this String is either null or empty.

Answers true if this String is neither null or empty.

Chops off a string at the specified length and accounts for smaller length

Removes trailing / characters from a path and leaves just one

Removes any leading / characters from a path

Serializes to a JSON string.

the instance to serialise the resulting JSON object as a string

Deserializes to an object of type .

The string to deserialize The object resulting from the given string

Returns a lowercase string of suitable for use in javascript.

This is a micro-cache; suitable when the number of terms is controllable (a few hundred, for example), and strictly append-only; you cannot change existing values. All key matches are on **REFERENCE** equality. The type is fully thread-safe.

the key type the value type

Initialises a new instance of the class.

The key. The value. The tail.

try and return a value from the cache based on the key. the default value is returned if no match is found. An exception is not thrown.

The link. The key. The value. return true if a value is located.

try and return a value from the cache based on the key. the default value is returned if no match is found. An exception is not thrown.

The head. The key. The value. return true if a value is located

Gets the key.

Gets the value.

Gets the tail.

The profiled database command.

The bind by name cache.

The command.

The connection.

The transaction.

The profiler.

bind by name.

Initialises a new instance of the class.

The command. The connection. The profiler.

get the binding name.

The command type. The .

The execute database data reader.

The behaviour. the resulting .

execute a non query.

the number of affected records.

execute the scalar.

The .

cancel the command.

prepare the command.

create a database parameter.

The .

dispose the command.

false if this is being disposed in a finalizer.

clone the command, entity framework expects this behaviour.

The .

The clone.

The .

Gets or sets a value indicating whether or not to bind by name. If the underlying command supports BindByName, this sets/clears the underlying implementation accordingly. This is required to support OracleCommand from dapper-dot-net

Gets or sets the command text.

Gets or sets the command timeout.

Gets or sets the command type.

Gets or sets the database connection.

Gets the database parameter collection.

Gets or sets the database transaction.

Gets or sets a value indicating whether the command is design time visible.

Gets or sets the updated row source.

Gets the internal command.

Wraps a database connection, allowing SQL execution timings to be collected when a session is started.

This will be made private; use

Initialises a new instance of the class. Returns a new that wraps , providing query execution profiling. If profiler is null, no profiling will occur.

Your provider-specific flavour of connection, e.g. SqlConnection, OracleConnection The currently started or null.

change the database.

The new database name.

close the connection.

enlist the transaction.

The transaction.

get the schema.

The .

get the schema.

The collection name. The .

get the schema.

The collection name. The restriction values. The .

open the connection

begin the database transaction.

The isolation level. The .

create the database command.

The .

dispose the underlying connection.

false if pre-empted from a finalizer

The state change handler.

The sender. The state change event arguments.

create a clone.

The .

create a clone.

The .

Gets the underlying, real database connection to your database provider.

Gets the current profiler instance; could be null.

Gets the wrapped connection.

Gets a value indicating whether events can be raised.

Gets or sets the connection string.

Gets the connection timeout.

Gets the database.

Gets the data source.

Gets the server version.

Gets the state.

The profiled database data reader.

The _reader.

The _profiler.

Initialises a new instance of the class.

The reader. The connection. The profiler.

The close.

The get boolean.

The ordinal. The .

The get byte.

The ordinal. The .

The get bytes.

The ordinal. The data offset. The buffer. The buffer offset. The length. The .

The get char.

The ordinal. The .

The get chars.

The ordinal. The data offset. The buffer. The buffer offset. The length. The .

The get data type name.

The ordinal. The .

The get date time.

The ordinal. The .

The get decimal.

The ordinal. The .

The get double.

The ordinal. The .

The get enumerator.

The .

The get field type.

The ordinal. The .

The get float.

The ordinal. The .

get the GUID.

The ordinal. The .

The get integer.

The ordinal. The .

get a 32 bit integer

The ordinal. The .

get a 64 bit integer (long)

The ordinal. The .

The get name.

The ordinal. The .

The get ordinal.

The name. The .

The get schema table.

The .

The get string.

The ordinal. The .

The get value.

The ordinal. The .

The get values.

The values. The .

the database value null.

The ordinal. The .

The next result.

The .

The read.

The .

Gets the depth.

Gets the field count.

Gets a value indicating whether has rows.

Gets a value indicating whether is closed.

Gets the records affected.

The that is being used

The

The name. The .

The

The ordinal. The .

The profiled database transaction.

The connection.

The transaction.

Initialises a new instance of the class.

The transaction. The connection.

commit the transaction.

rollback the transaction

dispose the transaction and connection.

false if being called from a finalizer

Gets the database connection.

Gets the wrapped transaction.

Gets the isolation level.

The Stopwatch interface.

stop the timer.

Gets the elapsed ticks.

Gets the frequency.

Gets a value indicating whether is running.

The stopwatch wrapper.

start a new timer.

The .

The _stopwatch.

Prevents a default instance of the class from being created.

stop the timer.

Gets the elapsed ticks.

Gets the frequency.

Gets a value indicating whether is running.

Help to build out sql

Add a template to the SqlBuilder

Add a Left Join

itself

Add a Where Clause

itself

Add an OrderBy Clause

itself

Add the Select section

itself

Add a parameters to the query

itself

Add a Join statement

itself

Add a Group By section

itself

Add a Having section

itself

Template helper class for SqlBuilder

Template constructor

Raw Sql returns by the

Parameters being used

Dapper, a light weight object mapper for ADO.NET

Purge the query cache

Return a count of all the cached queries by dapper

Return a list of all the queries cached by dapper

Deep diagnostics only: find any hash collisions in the cache

Execute parameterized SQL

Number of rows affected

Return a list of dynamic objects, reader is closed after the call

Executes a query, returning the data typed as per T

the dynamic param may seem a bit odd, but this works around a major usability issue in vs, if it is Object vs completion gets annoying. Eg type new [space] get new object A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is created per row, and a direct column-name===member-name mapping is assumed (case insensitive).

Execute a command that returns multiple result sets, and access each in turn

Return a typed list of objects, reader is closed after the call

Maps a query to objects

The first type in the recordset The second type in the recordset The return type The Field we should split and read the second object from (default: id) Number of seconds before command execution timeout Is it a stored proc or a batch?

Maps a query to objects

The Field we should split and read the second object from (default: id) Number of seconds before command execution timeout

Perform a multi mapping query with 4 input parameters

Perform a multi mapping query with 5 input parameters

Internal use only

Throws a data exception, only used internally

Called if the query cache is purged via PurgeQueryCache

Implement this interface to pass an arbitrary db specific set of parameters to Dapper

Add all the parameters needed to the command just before it executes

The raw command prior to execution Information about the query

Identity of a cached query in Dapper, used for extensability

Create an identity for use with DynamicParameters, internal use only

The sql

The command type

Compare 2 Identity objects

The grid reader provides interfaces for reading multiple result sets from a Dapper query

Read the next grid of results

Read multiple objects from a single recordset on the grid

Read multiple objects from a single record set on the grid

Dispose the grid, closing and disposing both the underlying reader and command.

A bag of parameters that can be passed to the Dapper Query and Execute methods

construct a dynamic parameter bag

can be an anonymous type of a DynamicParameters bag

Append a whole object full of params to the dynamic EG: AddParams(new {A = 1, B = 2}) // will add property A and B to the dynamic

Add a parameter to this dynamic parameter list

Get the value of a parameter

The value, note DBNull.Value is not returned, instead the value is returned as null

This class represents a SQL string, it can be used if you need to denote your parameter is a Char vs VarChar vs nVarChar vs nChar

Create a new DbString

Add the parameter to the command... internal use only

Ansi vs Unicode

Fixed length

Length of the string -1 for max

The value of the string

Gets part of a stack trace containing only methods we care about.

Gets the current formatted and filtered stack trace.

Space separated list of methods

The haack formatter. http://haacked.com/archive/2009/01/04/fun-with-named-formats-string-parsing-and-edge-cases.aspx.

format the supplied string.

The format. The source. The .

split and format the supplied string.

The format. the set of text expressions

index of the expression start.

The format. The start index. the start index

index of the expression end.

The format. The start index. the expression end index.

The format expression.

The TextExpression interface.

evaluate the supplied object.

The o. a string containing the substituted text.

The _invalid expression.

Initialises a new instance of the class.

The expression.

evaluate the expression

The o. The .

Gets the expression.

Gets the format.

The literal format.

Initialises a new instance of the class.

The literal text.

evaluate the object

The object. The .

Gets the literal text.

Identifies users based on ip address.

Provides functionality to identify which user is profiling a request.

Returns a string to identify the user profiling the current 'request'.

The current HttpRequest being profiled.

Returns the paramter HttpRequest's client ip address. We combine both the REMOTE_ADDR header (which is the connecting device's IP address), plus the HTTP_X_FORWARDED_FOR header if present (which is set by some proxy servers and load balancers). This allows us to have a unique per-user view, even when behind a proxy or load balancer.

A single MiniProfiler can be used to represent any number of steps/levels in a call-graph, via Step()

Totally baller.

Initialises a new instance of the class. Obsolete - used for serialization.

Initialises a new instance of the class. Creates and starts a new MiniProfiler for the root .

Initialises a new instance of the class. Creates and starts a new MiniProfiler for the root , filtering steps to .

Starts when this profiler is instantiated. Each step will use this Stopwatch's current ticks as their starting time.

The root.

Starts a new MiniProfiler based on the current . This new profiler can be accessed by .

Allows explicit naming of the new profiling session; when null, an appropriate default will be used, e.g. for a web request, the url will be used for the overall session name.

Starts a new MiniProfiler based on the current . This new profiler can be accessed by .

Profiling level. Default to Info. Allows explicit naming of the new profiling session; when null, an appropriate default will be used, e.g. for a web request, the url will be used for the overall session name.

Ends the current profiling session, if one exists.

When true, clears the for this HttpContext, allowing profiling to be prematurely stopped and discarded. Useful for when a specific route does not need to be profiled.

Returns an that will time the code between its creation and disposal. Use this method when you do not wish to include the StackExchange.Profiling namespace for the extension method.

A descriptive name for the code that is encapsulated by the resulting IDisposable's lifetime. the static step.

Returns an that will time the code between its creation and disposal. Use this method when you do not wish to include the StackExchange.Profiling namespace for the extension method.

A descriptive name for the code that is encapsulated by the resulting IDisposable's lifetime. This step's visibility level; allows filtering when is called. the static step.

Renders the current to JSON.

Renders the parameter to JSON.

Deserializes the JSON string parameter to a .

Returns the css and javascript includes needed to display the MiniProfiler results UI.

Which side of the page the profiler popup button should be displayed on (defaults to left) Whether to show trivial timings by default (defaults to false) Whether to show time the time with children column by default (defaults to false) The maximum number of trace popups to show before removing the oldest (defaults to 15) when true, shows buttons to minimize and clear MiniProfiler results Should MiniProfiler attempt to load its own version of jQuery, or rely on a version previously loaded on the page? The sampling Only. Should the profiler start as hidden. Default to null. Script and link elements normally; an empty string when there is no active profiling session.

Returns the 's and this profiler recorded.

a string containing the recording information

Returns true if Ids match.

Returns hash code of Id.

Walks the hierarchy contained in this profiler, starting with , and returns each Timing found.

Create a DEEP clone of this MiniProfiler.

Returns milliseconds based on Stopwatch's Frequency, rounded to one decimal place.

Returns how many milliseconds have elapsed since was recorded.

Called immediately after deserialization.

Contains information about queries executed during this profiling session.

Gets or sets the profiler id. Identifies this Profiler so it may be stored/cached.

Gets or sets a display name for this profiling session.

Gets or sets when this profiler was instantiated, in UTC time.

Gets the milliseconds, to one decimal place, that this MiniProfiler ran.

Gets or sets where this profiler was run.

Keys are names, values are URLs, allowing additional links to be added to a profiler result, e.g. perhaps a deeper diagnostic page for the current request.

Use to easily add a name/url pair to this dictionary.

Json used to store Custom Links. Do not touch.

Gets or sets the root timing. The first that is created and started when this profiler is instantiated. All other s will be children of this one.

Id of Root Timing. Used for Sql Storage purposes.

Gets or sets timings collected from the client

RedirectCount in ClientTimings. Used for sql storage.

Gets or sets a string identifying the user/client that is profiling this request.

If this is not set manually at some point, the implementation will be used; by default, this will be the current request's IP address.

Returns true when this MiniProfiler has been viewed by the that recorded it.

Allows POSTs that result in a redirect to be profiled. implementation will keep a list of all profilers that haven't been fetched down.

Gets or sets whether or not filtering is allowed of steps based on what the steps are created with.

Gets or sets points to the currently executing Timing.

Gets the ticks since this MiniProfiler was started.

Gets the timer, for unit testing, returns the timer.

Gets the currently running MiniProfiler for the current HttpContext; null if no MiniProfiler was ed.

A strategy to use for the current profiler. If null, then the set in will be used.

Used to set custom storage for an individual request

Various configuration properties.

Excludes the specified assembly from the stack trace output.

The short name of the assembly. AssemblyName.Name

Excludes the specified type from the stack trace output.

The System.Type name to exclude

Excludes the specified method name from the stack trace output.

The name of the method

Make sure we can at least store profiler results to the http runtime cache.

Assemblies to exclude from the stack trace report. Add to this using the method.

Types to exclude from the stack trace report. Add to this using the method.

Methods to exclude from the stack trace report. Add to this using the method.

The maximum number of unviewed profiler sessions (set this low cause we don't want to blow up headers)

The max length of the stack string to report back; defaults to 120 chars.

Any Timing step with a duration less than or equal to this will be hidden by default in the UI; defaults to 2.0 ms.

Dictates if the "time with children" column is displayed by default, defaults to false. For a per-page override you can use .RenderIncludes(showTimeWithChildren: true/false)

Dictates if trivial timings are displayed by default, defaults to false. For a per-page override you can use .RenderIncludes(showTrivial: true/false)

Determines how many traces to show before removing the oldest; defaults to 15. For a per-page override you can use .RenderIncludes(maxTracesToShow: 10)

Dictates on which side of the page the profiler popup button is displayed; defaults to left. For a per-page override you can use .RenderIncludes(position: RenderPosition.Left/Right)

Allows showing/hiding of popup results buttons via keyboard.

When true, results buttons will not initially be shown, requiring keyboard activation via .

Determines if min-max, clear, etc are rendered; defaults to false. For a per-page override you can use .RenderIncludes(showControls: true/false)

Determines if Miniprofiler relies on jQuery already loaded on the page; defaults to false. For a per-page override you can use .RenderIncludes(useExistingjQuery: true/false)

By default, SqlTimings will grab a stack trace to help locate where queries are being executed. When this setting is true, no stack trace will be collected, possibly improving profiler performance.

By default, s created by this assmebly will grab a stack trace to help locate where Remote Procedure Calls are being executed. When this setting is true, no stack trace will be collected, possibly improving profiler performance.

When is called, if the current request url contains any items in this property, no profiler will be instantiated and no results will be displayed. Default value is { "/content/", "/scripts/", "/favicon.ico" }.

The path under which ALL routes are registered in, defaults to the application root. For example, "~/myDirectory/" would yield "/myDirectory/includes.js" rather than just "/mini-profiler-resources/includes.js" Any setting here should be in APP RELATIVE FORM, e.g. "~/myDirectory/"

The path where custom ui elements are stored. If the custom file doesn't exist, the standard resource is used. This setting should be in APP RELATIVE FORM, e.g. "~/App_Data/MiniProfilerUI"

A web server restart is required to reload new files.

Maximum payload size for json responses in bytes defaults to 2097152 characters, which is equivalent to 4 MB of Unicode string data.

Understands how to save and load MiniProfilers. Used for caching between when a profiling session ends and results can be fetched to the client, and for showing shared, full-page results.

The normal profiling session life-cycle is as follows: 1) request begins 2) profiler is started 3) normal page/controller/request execution 4) profiler is stopped 5) profiler is cached with 's implementation of 6) request ends 7) page is displayed and profiling results are ajax-fetched down, pulling cached results from 's implementation of

The formatter applied to any SQL before being set in a .

Assembly version of this dank MiniProfiler.

The class that is used to run MiniProfiler

If not set explicitly, will default to

A function that determines who can access the MiniProfiler results url and list url. It should return true when the request client has access to results, false for a 401 to be returned. HttpRequest parameter is the current request and

The HttpRequest parameter that will be passed into this function should never be null.

Special authorization function that is called for the list results (listing all the profiling sessions), we also test for results authorize always. This must be set and return true, to enable the listing feature.

Allows switching out stopwatches for unit testing.

Pro

This code needs to be inserted in the page before client timings work

You can wrap an html block with timing wrappers using this helper

Contains helper methods that ease working with null s.

Wraps in a call and executes it, returning its result.

the type of result. The current profiling session or null. Method to execute and profile. The step name used to label the profiler results. the profiled result.

Wraps in a call and executes it, returning its result.

the type of result. The current profiling session or null. Method to execute and profile. The step name used to label the profiler results. This step's visibility level; allows filtering when is called. the profiled result.

Returns an that will time the code between its creation and disposal.

The current profiling session or null. A descriptive name for the code that is encapsulated by the resulting IDisposable's lifetime. the profile step

Returns an that will time the code between its creation and disposal.

The current profiling session or null. A descriptive name for the code that is encapsulated by the resulting IDisposable's lifetime. This step's visibility level; allows filtering when is called. the profile step

Returns an that will time the code between its creation and disposal. Will only save the if total time taken exceeds .

The current profiling session or null. A descriptive name for the code that is encapsulated by the resulting IDisposable's lifetime. The minimum amount of time that needs to elapse in order for this result to be recorded. Should the amount of time spent in child timings be included when comparing total time profiled with ? If true, will include children. If false will ignore children. If is set to true and a child is removed due to its use of StepIf, then the time spent in that time will also not count for the current StepIf calculation.

Returns a new that will automatically set its and

The current profiling session or null. The category under which this timing will be recorded. The command string that will be recorded along with this timing, for display in the MiniProfiler results. Execute Type to be associated with the Custom Timing. Example: Get, Set, Insert, Delete Should be used like the extension method

Returns a new that will automatically set its and . Will only save the new if the total elapsed time takes more than .

Returns an that will ignore profiling between its creation and disposal.

This is mainly useful in situations where you want to ignore database profiling for known hot spots, but it is safe to use in a nested step such that you can ignore sub-sections of a profiled step. The current profiling session or null. the profile step

Adds 's hierarchy to this profiler's current Timing step, allowing other threads, remote calls, etc. to be profiled and joined into this profiling session.

Adds the and pair to 's dictionary; will be displayed on the client in the bottom of the profiler popup.

Returns an html-encoded string with a text-representation of ; returns "" when profiler is null.

The current profiling session or null.

Returns a plain-text representation of , suitable for viewing from , log, or unit test output.

A profiling session with child instances.

Categorizes individual steps to allow filtering.

Default level given to Timings.

Useful when profiling many items in a loop, but you don't wish to always see this detail.

Dictates on which side of the page the profiler popup button is displayed; defaults to top left.

Profiler popup button is displayed on the top left.

Profiler popup button is displayed on the top right.

Profiler popup button is displayed on the bottom left.

Profiler popup button is displayed on the bottom right.

Formats any SQL query with inline parameters, optionally including the value type

Creates a new Inline SQL Formatter, optionally including the parameter type info in comments beside the replaced value

whether to include a comment after the value, indicating the type, e.g. /* @myParam DbType.Int32 */

Formats the SQL in a generic friendly format, including the parameter type information in a comment if it was specified in the InlineFormatter constructor

Returns a string representation of the parameter's value, including the type

Mostly for unit testing and single-threaded apps, only allows one instance of a to be the one.

The name says it all

Starts a new profiling session.

Stops the current profiling session.

Understands how to store a to the with absolute expiration.

The string that prefixes all keys that MiniProfilers are saved under, e.g. "mini-profiler-ecfb0050-7ce8-4bf1-bf82-2cb38e90e31e".

Syncs access to runtime cache when adding a new list of ids for a user.

Initialises a new instance of the class. Returns a new HttpRuntimeCacheStorage class that will cache MiniProfilers for the specified duration.

Saves to the HttpRuntime.Cache under a key concatenated with and the parameter's .

remembers we did not view the profile

Set the profile to viewed for this user

Returns the saved identified by . Also marks the resulting profiler to true.

Returns a list of s that haven't been seen by .

User identified by the current MiniProfiler.Settings.UserProvider.

List the latest profiling results.

Gets or sets how long to cache each for, in absolute terms.

Identifies a MiniProfiler result and only contains the needed info for sorting a list of profiling sessions.

SortedList on uses the comparer for both key lookups and insertion

How lists should be sorted.

Ascending Order

Descending Order

Contains helper code to time SQL statements.

Returns a new SqlProfiler to be used in the session.

Tracks when 'command' is started.

Finishes profiling for 'command', recording durations.

Called when 'reader' finishes its iterations and is closed.

Returns all currently open commands on this connection

Gets the profiling session this SqlProfiler is part of.

Helper methods that allow operation on SqlProfilers, regardless of their instantiation.

Tracks when 'command' is started.

Finishes profiling for 'command', recording durations.

Called when 'reader' finishes its iterations and is closed.

An individual profiling step that can contain child steps.

Offset from parent MiniProfiler's creation that this Timing was created.

Initialises a new instance of the class. Obsolete - used for serialization.

Creates a new Timing named 'name' in the 'profiler's session, with 'parent' as this Timing's immediate ancestor.

Returns this Timing's Name.

Returns true if Ids match.

Returns hash code of Id.

Completes this Timing's duration and sets the MiniProfiler's Head up one level.

Stops profiling, allowing the using construct to neatly encapsulate a region to be profiled.

Add the parameter 'timing' to this Timing's Children collection.

Used outside this assembly for custom deserialization when creating an implementation.

Adds to this step's dictionary of custom timings, . Ensures that is created, as well as the 's list.

The kind of custom timing, e.g. "http", "redis", "memcache" Duration and command information

Returns the list keyed to the , creating any collections when null.

The kind of custom timings, e.g. "sql", "redis", "memcache"

Gets or sets Unique identifier for this timing; set during construction.

Gets or sets Text displayed when this Timing is rendered.

Gets or sets How long this Timing step took in ms; includes any Timings' durations.

Gets or sets The offset from the start of profiling.

Gets or sets All sub-steps that occur within this Timing step. Add new children through

lists keyed by their type, e.g. "sql", "memcache", "redis", "http".

JSON representing the Custom Timings associated with this timing.

Returns true when there exists any objects in this .

Gets or sets Which Timing this Timing is under - the duration that this step takes will be added to its parent's duration.

This will be null for the root (initial) Timing.

The Unique Identifier identifying the parent timing of this Timing. Used for sql server storage.

Gets the elapsed milliseconds in this step without any children's durations.

Gets a value indicating whether this is less than the configured , by default 2.0 ms.

Gets a value indicating whether this Timing has inner Timing steps.

Gets a value indicating whether this Timing is the first one created in a MiniProfiler session.

Gets a value indicating whether how far away this Timing is from the Profiler's Root.

Gets a reference to the containing profiler, allowing this Timing to affect the Head and get Stopwatch readings.

The unique identifier used to identify the Profiler with which this Timing is associated. Used for sql storage.

HttpContext based profiler provider. This is the default provider to use in a web context. The current profiler is associated with a HttpContext.Current ensuring that profilers are specific to a individual HttpRequest.

Initialises a new instance of the class. Public constructor. This also registers any UI routes needed to display results

Starts a new MiniProfiler and associates it with the current .

Ends the current profiling session, if one exists.

When true, clears the for this HttpContext, allowing profiling to be prematurely stopped and discarded. Useful for when a specific route does not need to be profiled.

Makes sure 'profiler' has a Name, pulling it from route data or url.

Returns the current profiler

Gets the currently running MiniProfiler for the current HttpContext; null if no MiniProfiler was ed.

WebRequestProfilerProvider specific configurations

Provides user identification for a given profiling request.