Een aangepaste taak maken

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De stappen voor het maken van een aangepaste taak zijn vergelijkbaar met de stappen voor het maken van andere aangepaste objecten voor Integration Services:

• Maak een nieuwe klasse die wordt overgenomen van de basisklasse. Voor een taak is de basisklasse Microsoft.SqlServer.Dts.Runtime.Task.

• Pas het kenmerk toe waarmee het type object wordt geïdentificeerd op de klasse. Voor een taak is DtsTaskAttributehet kenmerk .

• Overschrijf de implementatie van de methoden en eigenschappen van de basisklasse. Voor een taak omvatten deze de Validate en Execute methoden.

• U kunt eventueel een aangepaste gebruikersinterface ontwikkelen. Voor een taak is hiervoor een klasse vereist waarmee de IDtsTaskUI interface wordt geïmplementeerd.

Aan de slag met een aangepaste taak

Projecten en klassen maken

Omdat alle beheerde taken zijn afgeleid van de basisklasse Microsoft.SqlServer.Dts.Runtime.Task , is de eerste stap wanneer u een aangepaste taak maakt, het maken van een klassebibliotheekproject in de beheerde programmeertaal van uw voorkeur en het maken van een klasse die overkomt van de basisklasse. In deze afgeleide klasse overschrijft u de methoden en eigenschappen van de basisklasse om uw aangepaste functionaliteit te implementeren.

Maak in dezelfde oplossing een tweede klassebibliotheekproject voor de aangepaste gebruikersinterface. Een afzonderlijke assembly voor de gebruikersinterface wordt aanbevolen voor het gemak van de implementatie, omdat u hiermee de verbindingsbeheerder of de bijbehorende gebruikersinterface onafhankelijk kunt bijwerken en opnieuw kunt implementeren.

Configureer beide projecten om de assembly's te ondertekenen die tijdens de build worden gegenereerd met behulp van een sterk naamsleutelbestand.

Het dtstask-kenmerk toepassen

Pas het DtsTaskAttribute kenmerk toe op de klasse die u hebt gemaakt om het als taak te identificeren. Dit kenmerk bevat ontwerptijdgegevens, zoals de naam, beschrijving en het taaktype van de taak.

Gebruik de UITypeName eigenschap om de taak te koppelen aan de aangepaste gebruikersinterface. Als u het openbare-sleuteltoken wilt ophalen dat vereist is voor deze eigenschap, gebruikt u sn.exe -t om het token voor openbare sleutels weer te geven uit het sleutelpaarbestand (.snk) dat u wilt gebruiken om de assembly van de gebruikersinterface te ondertekenen.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
namespace Microsoft.SSIS.Samples  
{  
  [DtsTask  
  (  
   DisplayName = "MyTask",  
   IconResource = "MyTask.MyTaskIcon.ico",  
   UITypeName = "My Custom Task," +  
   "Version=1.0.0.0," +  
   "Culture = Neutral," +  
   "PublicKeyToken = 12345abc6789de01",  
   TaskType = "PackageMaintenance",  
   TaskContact = "MyTask; company name; any other information",  
   RequiredProductLevel = DTSProductLevel.None  
   )]  
  public class MyTask : Task  
  {  
    // Your code here.  
  }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  
  
<DtsTask(DisplayName:="MyTask", _  
 IconResource:="MyTask.MyTaskIcon.ico", _  
 UITypeName:="My Custom Task," & _  
 "Version=1.0.0.0,Culture=Neutral," & _  
 "PublicKeyToken=12345abc6789de01", _  
 TaskType:="PackageMaintenance", _  
 TaskContact:="MyTask; company name; any other information", _  
 RequiredProductLevel:=DTSProductLevel.None)> _  
Public Class MyTask  
  Inherits Task  
  
  ' Your code here.  
  
End Class 'MyTask  

Een aangepaste taak bouwen, implementeren en fouten opsporen

De stappen voor het bouwen, implementeren en opsporen van fouten in een aangepaste taak in Integration Services zijn vergelijkbaar met de stappen die vereist zijn voor andere typen aangepaste objecten. Zie Voor meer informatie het bouwen, implementeren en opsporen van fouten in aangepaste objecten.

Zie ook

Een aangepaste taak maken
Een aangepaste taak coderen
Een gebruikersinterface ontwikkelen voor een aangepaste taak