IDTExtensibility2.OnConnection Method

Occurs whenever an add-in is loaded into Visual Studio.

Namespace: Extensibility
Assembly: Extensibility (in extensibility.dll)

void OnConnection (
	[InAttribute] Object Application,
	[InAttribute] ext_ConnectMode ConnectMode,
	[InAttribute] Object AddInInst,
	[InAttribute] ref Array custom
void OnConnection (
	/** @attribute InAttribute() */ Object Application, 
	/** @attribute InAttribute() */ ext_ConnectMode ConnectMode, 
	/** @attribute InAttribute() */ Object AddInInst, 
	/** @attribute InAttribute() */ /** @ref */ Array custom
JScript does not support passing value-type arguments by reference.



A reference to an instance of the integrated development environment (IDE), DTE, which is the root object of the Visual Studio automation model.


An ext_ConnectMode enumeration value that indicates the way the add-in was loaded into Visual Studio.


An AddIn reference to the add-in's own instance. This is stored for later use, such as determining the parent collection for the add-in.


An empty array that you can use to pass host-specific data for use in the add-in.

OnConnection is the main method for IDTExtensibility2, because it is called every time an add-in is loaded. It is the entry point for an add-in when it is loaded, so you can put any code here (or call any another function) that you want to run when the add-in starts.

public void OnConnection(object application, ext_ConnectMode 
connectMode, object addInInst, ref Array custom)
    applicationObject = (DTE2)application;
    addInInstance = (AddIn)addInInst;
    System.Windows.Forms.MessageBox.Show("Add-in has connected.");

Community Additions