This documentation is archived and is not being maintained.

IDTExtensibility2.OnConnection Method

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

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

Sub OnConnection ( _
	<InAttribute> Application As Object, _
	<InAttribute> ConnectMode As ext_ConnectMode, _
	<InAttribute> AddInInst As Object, _
	<InAttribute> ByRef custom As Array _
Dim instance As IDTExtensibility2
Dim Application As Object
Dim ConnectMode As ext_ConnectMode
Dim AddInInst As Object
Dim custom As Array

instance.OnConnection(Application, ConnectMode, AddInInst, 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 Sub OnConnection(ByVal application As Object, ByVal _
connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    applicationObject = CType(application, DTE2)
    addInInstance = CType(addInInst, AddIn)
    MsgBox("Add-in is connected.")
End Sub