IDtsComponentUI Interface

Defines the methods called by SSIS Designer for the user interface of a data flow component.

This API is not CLS-compliant. 

Namespace:  Microsoft.SqlServer.Dts.Pipeline.Design
Assembly:  Microsoft.SqlServer.Dts.Design (in Microsoft.SqlServer.Dts.Design.dll)

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
Public Interface IDtsComponentUI
'Usage
Dim instance As IDtsComponentUI

[CLSCompliantAttribute(false)]
public interface IDtsComponentUI

[CLSCompliantAttribute(false)]
public interface class IDtsComponentUI

[<CLSCompliantAttribute(false)>]
type IDtsComponentUI =  interface end

public interface IDtsComponentUI

The IDtsComponentUI type exposes the following members.

Methods

	Name	Description
	Delete	Called when the component is deleted from the SSIS Designer surface.
	Edit	Called when a component is edited.
	Help	[Reserved for future use.]
	Initialize	Called to initialize the user interface of the component.
	New	Called when a component is initially added to a Data Flow task.

Top

Remarks

Component developers can provide a user interface for a data flow component by specifying a Type and implementing this interface in the UITypeName property of the DtsPipelineComponentAttribute attribute. The designer calls the methods of this interface when the component is added, deleted, and edited inside the SSIS Designer.

Examples

The following code sample demonstrates a class that implements the IdtsComponentUI interface. For more information and the complete sample, see Developing a User Interface for a Data Flow Component.

using System;
using System.Windows.Forms;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Pipeline.Design;
using Microsoft.SqlServer.Dts.Pipeline.Wrapper;

namespace Microsoft.Samples.SqlServer.Dts
{
    public class SampleComponentUI : IDtsComponentUI
    {
        IDTSComponentMetaData100 md;
        IServiceProvider sp;

        public void Help(System.Windows.Forms.IWin32Window parentWindow)
        {
        }
        public void New(System.Windows.Forms.IWin32Window parentWindow)
        {
        }
        public void Delete(System.Windows.Forms.IWin32Window parentWindow)
        {
        }
        public bool Edit(System.Windows.Forms.IWin32Window parentWindow, Variables vars, Connections cons)
        {
            // Create the component's form, and then display it.
            SampleComponentUIForm componentEditor = new SampleComponentUIForm(cons, vars, md);

            DialogResult result  = componentEditor.ShowDialog(parentWindow);

            if (result == DialogResult.OK)
                return true;

            return false;
        }
        public void Initialize(IDTSComponentMetaData100 dtsComponentMetadata, IServiceProvider serviceProvider)
        {
            // Store the component metadata.
            this.md = dtsComponentMetadata;
        }
    }
}

Imports System 
Imports System.Windows.Forms 
Imports Microsoft.SqlServer.Dts.Runtime 
Imports Microsoft.SqlServer.Dts.Pipeline.Design 
Imports Microsoft.SqlServer.Dts.Pipeline.Wrapper 

Public Class SampleComponentUI 
Implements IDtsComponentUI 
 Private md As IDTSComponentMetaData100 
 Private sp As IServiceProvider 

 Public Sub Help(ByVal parentWindow As System.Windows.Forms.IWin32Window) 
 End Sub 

 Public Sub New(ByVal parentWindow As System.Windows.Forms.IWin32Window) 
 End Sub 

 Public Sub Delete(ByVal parentWindow As System.Windows.Forms.IWin32Window) 
 End Sub 

 Public Function Edit(ByVal parentWindow As System.Windows.Forms.IWin32Window, ByVal vars As Variables, ByVal cons As Connections) As Boolean 
   Dim componentEditor As SampleComponentUIForm = New SampleComponentUIForm(cons, vars, md) 
   Dim result As DialogResult = componentEditor.ShowDialog(parentWindow) 
   If result = DialogResult.OK Then 
     Return True 
   End If 
   Return False 
 End Function 

 Public Sub Initialize(ByVal dtsComponentMetadata As IDTSComponentMetaData100, ByVal serviceProvider As IServiceProvider) 
   Me.md = dtsComponentMetadata 
 End Sub 
End Class

See Also

Reference

Microsoft.SqlServer.Dts.Pipeline.Design Namespace