Udostępnij za pośrednictwem


Implementująca klasa połączenia dla rozszerzenie przetwarzania danych

The Connection object represents a database connection or similar resource and is the starting point for users of a SQL Server Reporting Services data processing extension.Reprezentuje połączenia z serwerami baz danych, chociaż mogą być narażeni każdy obiekt, podobnie jak połączenia.

Aby zaimplementować połączenia obiektów, należy utworzyć klasę implementującą IDbConnection i opcjonalnie implementuje IDbConnectionExtension.

W implementacji musi zapewnić, że połączenie jest tworzone i otworzyć przed wykonaniem polecenia.Upewnij się, że wdrożenie wymaga od klient do otwierania i zamykania połączeń jawnie, zamiast otwierać i zamykać połączeń niejawnie implementacji dla klient.Po uzyskaniu połączenia, należy wykonać testy zabezpieczeń.Wymaganie istniejącego połączenia dla innych klas w sieci SSRS rozszerzenie przetwarzania danych następnie zapewni, że kontrole bezpieczeństwa są zawsze wykonywane podczas pracy ze źródło danych.

Właściwości żądanego połączenia są reprezentowane jako połączenie ciąg.Zdecydowanie zalecane jest SSRS Obsługa rozszerzeń przetwarzania danych ConnectionString właściwość za pomocą systemu para znanych nazwa/wartość zdefiniowana przez OLE DB.

Ostrzeżenie

Połączenie obiekty są często zasób-intensywnego uzyskiwania, tak warto rozważyć tworzenie puli połączeń lub innych technik, aby złagodzić to.

IDbConnectiondziedziczy z IExtension.Należy zaimplementować IExtension interfejs jako część swojej implementacji klasy połączenia.IExtension Interfejs umożliwia klasy do realizacji Nazwa zlokalizowana rozszerzenia i przetwarzać informacje specyficzne dla rozszerzenia konfiguracja przechowywane w Reporting Services plik konfiguracji.

Z połączenia obiekt zawiera LocalizedName właściwość jego realizacji, z IExtension.Zdecydowanie zalecane jest Reporting Services Obsługa rozszerzeń przetwarzania danych LocalizedName właściwość, dzięki czemu użytkownicy mogą znanych, zlokalizowana nazwa rozszerzenia interfejs użytkownika, takich jak Menedżer raportów.

IExtensionPozwala także na połączenia obiektu do pobierania i przetwarzania danych niestandardowych konfiguracja przechowywane w RSReportServer.plik konfiguracja.Aby uzyskać więcej informacji na temat przetwarzania danych konfiguracja niestandardowych, zobacz SetConfiguration metoda.

Klasy, która implementuje IExtension nie jest usuwane z pamięci, gdy pozostałe klas rozszerzenie przetwarzania danych są zwalniane.Z tego względu można użyć programu rozszerzenie klasy do przechowywania informacji o stanie połączenia krzyżowe lub do przechowywania danych, które mogą być buforowane w pamięci.Z rozszerzenie klasy pozostanie w pamięci, jak długo serwer raportów jest uruchomiony.

Można rozszerzyć na połączenia klasy obejmują obsługę poświadczenia w Reporting Services przez zaimplementowanie IDbConnectionExtension.Podczas implementacji IntegratedSecurity, UserName, i Password Właściwości IDbConnectionExtension włączyć interfejs, Zintegrowanych zabezpieczeń pole wyboru i nazwa_użytkownika i hasło pól tekstowych z Źródła danych okno dialogowe w Projektant raportów.Umożliwia to Projektant raportów do przechowywania i pobierania poświadczenia dla źródeł danych, które obsługują uwierzytelnianie.Poświadczenia są bezpiecznie przechowywane i wykorzystywane podczas renderowania raportów w trybie podglądu.

Ostrzeżenie

Implementowanie IDbConnectionExtension niejawnie wymaga wykonania członków IDbConnection i IExtension interfejsów.

Przykładowe połączenia klasy implementacji, zobacz SQL Server Reporting Services próbek produktu.