Udostępnij za pośrednictwem

  • Artykuł

Klasa TaskHost

Zapewnia kontener hermetyzuje pojedynczego zadania.W projektancie SSIS TaskHost nie jest skonfigurowana oddzielnie; Zamiast tego jest skonfigurowany po możesz zestaw właściwości zadania hermetyzuje on.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Dts.Runtime.DtsObject
    Microsoft.SqlServer.Dts.Runtime.Executable
      Microsoft.SqlServer.Dts.Runtime.DtsContainer
        Microsoft.SqlServer.Dts.Runtime.EventsProvider
          Microsoft.SqlServer.Dts.Runtime.TaskHost

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Runtime
Zestaw:  Microsoft.SqlServer.ManagedDTS (w Microsoft.SqlServer.ManagedDTS.dll)

Składnia

'Deklaracja
Public NotInheritable Class TaskHost _
    Inherits EventsProvider _
    Implements IDTSObjectHost, IDTSPropertiesProvider, IDTSPackagePath
'Użycie
Dim instance As TaskHost

public sealed class TaskHost : EventsProvider, 
    IDTSObjectHost, IDTSPropertiesProvider, IDTSPackagePath

public ref class TaskHost sealed : public EventsProvider, 
    IDTSObjectHost, IDTSPropertiesProvider, IDTSPackagePath

[<SealedAttribute>]
type TaskHost =  
    class
        inherit EventsProvider
        interface IDTSObjectHost
        interface IDTSPropertiesProvider
        interface IDTSPackagePath
    end

public final class TaskHost extends EventsProvider implements IDTSObjectHost, IDTSPropertiesProvider, IDTSPackagePath

Typ TaskHost uwidacznia następujące elementy członkowskie.

Właściwości

  Nazwa Opis
Właściwość publiczna ApartmentThreaded Infrastruktura.
Właściwość publiczna CreationName Zwraca ciąg, który jest używany do utworzenia wystąpienie DtsContainer obiektu.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna DebugMode Pobiera lub ustawia logiczna wskazuje, czy DtsContainer obiekt jest w trybie debugowania i czy powinny być ognia OnBreakpointHit zdarzenie podczas uruchamiania. (Dziedziczony z DtsContainer).
Właściwość publiczna DelayValidation Pobiera lub ustawia logiczna wskazuje, czy poprawności zadanie jest opóźnione do czasu uruchomienia czas.Wartością domyślną jest false. (Dziedziczony z DtsContainer).
Właściwość publiczna Description Pobiera lub ustawia opis DtsContainer obiektu. (Dziedziczony z DtsContainer).
Właściwość publiczna Disable A wartość logiczna wskazuje, że jeśli DtsContainer obiekt jest wyłączone. (Dziedziczony z DtsContainer).
Właściwość publiczna DisableEventHandlers Pobiera lub ustawia logiczna wskazuje, czy zdarzenie obsługi zadania są wyłączone. (Dziedziczony z EventsProvider).
Właściwość publiczna EventHandlers Zwraca kolekcja obsługa zdarzeń obiektów.To pole jest tylko do odczytu. (Dziedziczony z EventsProvider).
Właściwość publiczna EventInfos Zwraca kolekcja EventInfo obiektów.To pole jest tylko do odczytu. (Dziedziczony z EventsProvider).
Właściwość publiczna ExecutionDuration Zwraca wartość, która wskazuje ilość czas kontener zużytą wykonanie w milisekundach.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna ExecutionResult Zwraca wartość wskazująca sukcesu lub niepowodzenia wykonania DtsContainer obiektu. (Dziedziczony z DtsContainer).
Właściwość publiczna ExecutionStatus Zwraca wartość, która wskazuje bieżący stan realizacji DtsContainer obiektu na czas rozmowy. (Dziedziczony z DtsContainer).
Właściwość publiczna ExecutionValue Zwraca wynik wykonania zadania.Ta właściwość jest tylko do odczytu.
Właściwość publiczna ExecValueVariable Pobiera lub ustawia niestandardowej Variable zawierający wyniki wykonania zadania.
Właściwość publiczna FailPackageOnFailure Pobiera lub ustawia wartość logiczna , wskazuje, czy pakiet nie działa, gdy kontener podrzędność nie powiedzie się.Ta właściwość jest używana na pojemnikach, nie pakiet. (Dziedziczony z DtsContainer).
Właściwość publiczna FailParentOnFailure Pobiera lub ustawia wartość logiczna definiuje czy kontenera nadrzędnego nie działa, gdy kontener podrzędność nie powiedzie się. (Dziedziczony z DtsContainer).
Właściwość publiczna ForcedExecutionValue Jeśli ForceExecutionValue właściwość jest zestaw do true, pobiera lub zestaws wartość, która określa wartość wykonanie opcjonalną, która zwraca pakiet. (Dziedziczony z DtsContainer).
Właściwość publiczna ForceExecutionResult Pobiera lub ustawia DTSForcedExecResult wartość wyliczenia, który określa wynik wykonanie wymuszonego kontener. (Dziedziczony z DtsContainer).
Właściwość publiczna ForceExecutionValue Pobiera lub ustawia wartość logiczna , wskazuje, czy wartość wykonanie kontener powinna być wymuszona zawiera określoną wartość. (Dziedziczony z DtsContainer).
Właściwość publiczna HostType Pobiera wartość z DTSObjectHostType wyliczenia, który opisuje hosta z kontener.Ta właściwość jest tylko do odczytu.
Właściwość publiczna ID Zwraca identyfikator, który jest identyfikatorem GUID, z DtsContainer.Wartość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna InnerObject metoda umożliwiające dostęp do wystąpienie zadania, znajdujących się na TaskHost.
Właściwość publiczna IsDefaultLocaleID A wartość logiczna , wskazuje, czy kontener używa domyślnych ustawienia regionalne.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna IsolationLevel Pobiera lub ustawia poziom izolacji transakcji w DtsContainer obiektu. (Dziedziczony z DtsContainer).
Właściwość publiczna LocaleID Pobiera lub ustawia całkowitą wskazuje, że Microsoft Win32 ® identyfikator ustawień regionalnych dla użytku w DtsContainer obiektu jest wykonywany. (Dziedziczony z DtsContainer).
Właściwość publiczna LogEntryInfos Zwraca LogEntryInfos obiektu.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna LoggingMode Pobiera lub ustawia prawidłową wartość z DTSLoggingMode wyliczenia wskazująca tryb rejestrowania kontener. (Dziedziczony z DtsContainer).
Właściwość publiczna LoggingOptions Zwraca obiekt, który zawiera właściwości wskazujący filtrowania i rejestrowanie zasób dla kontenerów.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna MaximumErrorCount Pobiera lub ustawia całkowitą wartość wskazująca maksymalną liczbę błędów, który może występować przed DtsContainer obiektu zatrzymuje działanie. (Dziedziczony z DtsContainer).
Właściwość publiczna Name Pobiera lub ustawia nazwę DtsContainer. (Dziedziczony z DtsContainer).
Właściwość publiczna Parent Zwraca kontener nadrzędnego.Wartość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna Properties Zwraca DtsProperties kolekcja, który zawiera właściwości skojarzonych z zadaniem.
Właściwość publiczna Site Infrastruktura. (Dziedziczony z DtsContainer).
Właściwość publiczna StartTime Zwraca czas, że kontener rozpoczął wykonywanie.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna StopTime Zwraca czas, że kontener zakończono wykonywanie.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).
Właściwość publiczna SuspendRequired Pobiera lub ustawia wartość logiczna wskazująca, że jeżeli zadań należy zawiesić po napotkaniu punktu punkt przerwania.Wartość ta jest zestaw przez aparat wykonywania zadań i pojemników po napotkaniu punktu punkt przerwania. (Dziedziczony z DtsContainer).
Właściwość publiczna TransactionOption Pobiera lub ustawia DTSTransactionOption wartość wyliczenia wskazująca, czy kontener uczestniczy w transakcji. (Dziedziczony z DtsContainer).
Właściwość publiczna VariableDispenser Zwraca VariableDispenser obiektu, można zablokować zmienne skojarzone z kontener. (Dziedziczony z DtsContainer).
Właściwość publiczna Variables Zwraca kolekcja zawierającą zmienne skojarzone z tym kontener.Ta właściwość jest tylko do odczytu. (Dziedziczony z DtsContainer).

Do góry

Metody

  Nazwa Opis
Metoda publiczna AcceptBreakpointManager Ta metoda jest wywoływana przez uruchomienie -czas silnika podczas zadania lub kontener jest tworzony i przekazuje je BreakpointManager Menedżera zezwalają na tworzenie, usuwanie i sprawdzić stan punktów przerwania.Ta metoda jest wywoływana w czasie wykonywania i nie jest używany w kodzie. (Dziedziczony z DtsContainer).
Metoda publiczna Dispose Wykonuje zadania przez aplikację skojarzonych z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Dziedziczony z DtsContainer).
Metoda publiczna Equals Określa, czy dwa wystąpienia obiektu są równe. (Dziedziczony z DtsObject).
Metoda publiczna Execute Uruchamia aplikację, kontener lub pakiet jako część pakietu przepływu pracy. (Dziedziczony z DtsContainer).
Metoda chroniona Finalize (Dziedziczony z Object).
Metoda publiczna GetExpression Zwraca wyrażenie dla określonej właściwość. Null oznacza przypisane żadne wyrażenie.
Metoda publiczna GetHashCode Zwraca kod skrótu dla tego wystąpienie. (Dziedziczony z DtsObject).
Metoda publiczna GetPackagePath Zwraca ścieżka do lokalizacji zadania.
Metoda publiczna GetType (Dziedziczony z Object).
Metoda publiczna LoadFromXML Ta metoda nie jest wpłacone przez kod aplikacji.Aby załadować pakiet zapisany jako XML, należy użyć Application.LoadPackage metoda. (Dziedziczony z DtsContainer).
Metoda chroniona MemberwiseClone (Dziedziczony z Object).
Metoda publiczna ResumeExecution Wznawia działanie po wstrzymaniu wykonania zadania.Zadania lub kontener jest wznawiany przez aparat runtime. (Dziedziczony z DtsContainer).
Metoda publiczna SaveToXML Ta metoda nie jest wpłacone przez kod aplikacji.Aby zapisać pakiet jako XML, użyj Application.SaveToXml metoda. (Dziedziczony z DtsContainer).
Metoda publiczna SetExpression Przypisuje określone wyrażenie właściwość.Określ nullodwołanie o wartości null (Nothing w języku Visual Basic) usunąć istniejące wyrażenie z właściwość.
Metoda chroniona SetWrappedExecutable Infrastruktura. (Dziedziczony z EventsProvider).
Metoda publiczna SuspendExecution Wywoływane, gdy plik wykonywalny musi zawiesić.Metoda ta jest wywoływana przez aparat runtime. (Dziedziczony z DtsContainer).
Metoda publiczna ToString (Dziedziczony z Object).
Metoda publiczna Validate Umożliwia kontener określić, jeśli zawiera ona nieprawidłowe ustawienia, które uniemożliwi wykonywanie pomyślnie. (Dziedziczony z DtsContainer).

Do góry

Zdarzenia

  Nazwa Opis
Zdarzenie publiczne Disposed Dodaje funkcję obsługa zdarzeń, aby posłuchać Disposed zdarzenie składnika. (Dziedziczony z DtsContainer).

Do góry

Pola

  Nazwa Opis
Pole chronione m_executable Infrastruktura. (Dziedziczony z Executable).

Do góry

Uwagi

Integration Serviceszawiera kilka różnych typów pojemników do budowania pakietów, z TaskHost jest jednym z tych kontenerów.TaskHost kontener zapewnia usługi do pojedynczego zadania.W przyborniku projektanta graficzne nie ma pasującego element.TaskHost Obiekt jest obiektem otoki dla zadania i tworzony jest przezroczysty podczas tworzenia zadania.Zwracany jest z Add metoda jako Executable object i oddanych jako TaskHost.Wreszcie, dostęp do wystąpienie zadania za pomocą InnerObject właściwość.Więcej informacji na temat wszystkich kontenerów SSIS, zobacz Integracja usług kontenerów.

Przykłady

Poniższy przykład kodu pokazuje utworzenia pustego pakiet.Dwa zadania są dodawane do pakiet i oddanych do TaskHost klasy tak TaskHost metoda i właściwości mogą być używane w obu zadań, takich jak InnerObject metoda, bez względu na to, jaki rodzaj zadań go Wyspy

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;
using Microsoft.SqlServer.Dts.Tasks.FileSystemTask;

namespace Microsoft.SqlServer.SSIS.Samples
{
    class Program
    {
        static void Main(string[] args)
        {
            Package p = new Package();
            // Add a File System task to the package.
            Executable exec1 = p.Executables.Add("STOCK:FileSystemTask");
            TaskHost thFileSystemTask = exec1 as TaskHost;
            // Add a Bulk Insert task to the package.
            Executable exec2 = p.Executables.Add("STOCK:BulkInsertTask");
            TaskHost thBulkInsertTask = exec2 as TaskHost;

            // Iterate through the package Executables collection.
            Executables pExecs = p.Executables;
            foreach (Executable pExec in pExecs)
            {
                TaskHost taskHost = (TaskHost)pExec;
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString());
            }
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
Imports Microsoft.SqlServer.Dts.Tasks.FileSystemTask
 
Namespace Microsoft.SqlServer.SSIS.Samples
    Class Program
        Shared  Sub Main(ByVal args() As String)
            Dim p As Package =  New Package() 
            ' Add a File System task to the package.
            Dim exec1 As Executable =  p.Executables.Add("STOCK:FileSystemTask") 
            Dim thFileSystemTask As TaskHost =  exec1 as TaskHost 
            ' Add a Bulk Insert task to the package.
            Dim exec2 As Executable =  p.Executables.Add("STOCK:BulkInsertTask") 
            Dim thBulkInsertTask As TaskHost =  exec2 as TaskHost 
 
            ' Iterate through the package Executables collection.
            Dim pExecs As Executables =  p.Executables 
            Dim pExec As Executable
            For Each pExec In pExecs
                Dim taskHost As TaskHost = CType(pExec, TaskHost)
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString())
            Next
        End Sub
    End Class
End Namespace

Przykładowe dane wyjściowe:

Typ Microsoft.SqlServer.Dts.Tasks.FileSystemTask.FileSystemTask

Typ Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTask

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.