Skapa en anpassad anslutningshanterare

Gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

Stegen du måste följa för att skapa en anpassad anslutningshanterare liknar stegen för att skapa vilket annat anpassat objekt som helst för Integration Services:

• Skapa en ny klass som ärver från basklassen. För en anslutningshanterare är ConnectionManagerBasebasklassen .

• Applicera attributet som identifierar objekttypen på klassen. För en anslutningshanterare är DtsConnectionAttributeattributet .

• Åsidosätt implementeringen av metoderna och egenskaperna hos basklassen. För en anslutningshanterare inkluderar dessa egenskapen ConnectionString och och-metoderna AcquireConnectionReleaseConnection .

• Eventuellt kan du utveckla ett anpassat användargränssnitt. För en anslutningshanterare kräver detta en klass som implementerar gränssnittet IDtsConnectionManagerUI .

Att komma igång med en anpassad Správca pripojení

Skapa projekt och klasser

Eftersom alla hanterade anslutningshanterare härstammar ConnectionManagerBase från basklassen är det första steget när du skapar en anpassad anslutningshanterare att skapa ett klassbiblioteksprojekt i ditt föredragna hanterade programmeringsspråk och skapa en klass som ärver från basklassen. I denna härledda klass kommer du att åsidosätta metoderna och egenskaperna hos basklassen för att implementera din anpassade funktionalitet.

I samma lösning, skapa ett biblioteksprojekt av andra klass för det anpassade användargränssnittet. En separat assembler för användargränssnittet rekommenderas för att underlätta distributionen eftersom den låter dig uppdatera och omdistribuera anslutningshanteraren eller dess användargränssnitt oberoende.

Konfigurera båda projekten att signera de assemblies som ska genereras vid byggtiden genom att använda en stark namnnyckelfil.

Tillämpning av attributet DtsConnection

Använd attributet DtsConnectionAttribute på den klass du har skapat för att identifiera den som en anslutningshanterare. Denna attribut tillhandahåller designtidsinformation såsom namn, beskrivning och anslutningstyp för anslutningshanteraren. Egenskaperna ConnectionType och Beskrivning motsvarar typ- och beskrivningskolumnerna som visas i dialogrutan Add SSIS Správca pripojení, som visas vid konfiguration av anslutningar för ett paket i SQL Server Data Tools (SSDT).

Använd egenskapen UITypeName för att länka anslutningshanteraren till dess anpassade användargränssnitt. För att få den publika nyckeltoken som krävs för denna egenskap kan du använda sn.exe -t för att visa den publika nyckeltoken från nyckelparet (.snk)-filen som du tänker använda för att signera användargränssnittsassembleren.

<DtsConnection(ConnectionType:="SQLVB", _  
  DisplayName:="SqlConnectionManager (VB)", _  
  Description:="Connection manager for Sql Server", _  
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _  
Public Class SqlConnMgrVB  
  Inherits ConnectionManagerBase  
  . . .  
End Class  

[DtsConnection(ConnectionType = "SQLCS",  
  DisplayName = "SqlConnectionManager (CS)",  
  Description = "Connection manager for Sql Server",  
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]  
public class SqlConnMgrCS :  
ConnectionManagerBase  
{  
  . . .  
}  

Bygga, distribuera och felsöka en anpassad Správca pripojení

Stegen för att bygga, distribuera och felsöka en anpassad anslutningshanterare i Integration Services liknar stegen för andra typer av anpassade objekt. För mer information, se Bygga, distribuera och felsöka anpassade objekt.

Relaterat innehåll

• Kodning av en anpassad Správca pripojení
• Utveckling av ett användargränssnitt för en anpassad Správca pripojení