Klasa ScriptTask

Definiuje klasy dla zadania skryptu, który umożliwia deweloperom napisać kod niestandardowy do wykonywania funkcji, które nie są dostępne w wbudowane zadania udostępnione przez Integration Services.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Dts.Runtime.DtsObject
    Microsoft.SqlServer.Dts.Runtime.Task
      Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Tasks.ScriptTask
Zestaw:  Microsoft.SqlServer.ScriptTask (w Microsoft.SqlServer.ScriptTask.dll)

Składnia

'Deklaracja
<GuidAttribute("2EC4E475-058D-3590-8909-279F833D8B9C")> _
<ComVisibleAttribute(True)> _
Public Class ScriptTask _
    Inherits Task _
    Implements IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist
'Użycie
Dim instance As ScriptTask

[GuidAttribute("2EC4E475-058D-3590-8909-279F833D8B9C")]
[ComVisibleAttribute(true)]
public class ScriptTask : Task, IDTSBreakpointSite, 
    IDTSSuspend, IDTSComponentPersist

[GuidAttribute(L"2EC4E475-058D-3590-8909-279F833D8B9C")]
[ComVisibleAttribute(true)]
public ref class ScriptTask : public Task, 
    IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist

[<GuidAttribute("2EC4E475-058D-3590-8909-279F833D8B9C")>]
[<ComVisibleAttribute(true)>]
type ScriptTask =  
    class
        inherit Task
        interface IDTSBreakpointSite
        interface IDTSSuspend
        interface IDTSComponentPersist
    end

public class ScriptTask extends Task implements IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist

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

Konstruktorzy

	Nazwa	Opis
	ScriptTask	Inicjuje nowe wystąpienie ScriptTask klasy

Do góry

Właściwości

	Nazwa	Opis
	BreakpointManager	Zwraca BreakpointManager używane do kontrolowania punktów przerwania na zadanie.
	Breakpoints	Zwraca tablicę punkty przerwania zestaw nad tym zadaniem.
	DebugMode	Pobiera lub ustawia wartość wskazującą, czy zadanie jest uruchomione w trybie debugowania i czy powinna podnieść OnBreakpointHit zdarzenie, gdy zadanie jest uruchomione.
	EntryPoint	Pobiera lub ustawia nazwę klasy, która jest wykonywana jako punkt wejścia.
	ExecutionValue	Zwraca obiekt zdefiniowany przez użytkownika.To pole jest tylko do odczytu. (Zastępuje Task.ExecutionValue).
	ReadOnlyVariables	Pobiera lub ustawia listę rozdzielaną przecinkami istniejących zmiennych udostępnione do pakiet przez użytkownika dostępu tylko do odczytu.
	ReadWriteVariables	Pobiera lub ustawia listę rozdzielaną przecinkami istniejących zmiennych udostępnione do pakiet przez użytkownika dla dostępu do odczytu i zapisu.
	ScriptingEngine	Pobiera VSTATaskScriptingEngine klasy
	ScriptLanguage	Pobiera lub ustawia język programowania, w którym napisano skrypt.
	ScriptLoaded	Pobiera wartość wskazującą, czy zadania zawiera skrypt niestandardowy.
	ScriptProjectName	Pobiera lub ustawia nazwę projektu skryptu.
	ScriptStorage	Pobiera [VSTAScriptProjectStorage].
	SuspendRequired	Pobiera lub ustawia wartość logiczna wskazuje, czy zadanie Wstrzymaj wykonywanie kodu, gdy zadanie napotka punkt przerwania.Ta wartość jest ustawiana przez uruchomienie -czas aparat zadań i pojemników po napotkaniu punktu punkt przerwania.
	Version	*** Członkowskich zaniechane; Zobacz uwagi. *** Zwraca wersja zadania.Ta właściwość jest tylko do odczytu. (Dziedziczony z Task).

Do góry

Metody

	Nazwa	Opis
	AcceptBreakpointManager	Przebiegi BreakpointManager do zadań.Ta metoda jest wywoływana w czasie wykonywania i nie jest używany w kodzie.
	CanUpdate	*** Członkowskich zaniechane; Zobacz uwagi. *** a wartość logiczna , wskazuje, czy nowy pakiet XML można aktualizować stare pakiet XML. (Dziedziczony z Task).
	Equals	Określa, czy dwa wystąpienia obiektu są równe. (Dziedziczony z DtsObject).
	Execute	Uruchamia zadanie skryptu. (Zastępuje Task.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)).
	Finalize	Zwalnia wszystkie zasoby używane przez ScriptTask. (Zastępuje Object.Finalize()).
	GetConnectionID	Pobiera ciąg zawierający identyfikator połączenia. (Dziedziczony z Task).
	GetConnectionName	Pobiera ciąg zawierające nazwę połączenia. (Dziedziczony z Task).
	GetHashCode	Zwraca kod skrótu dla tego wystąpienie. (Dziedziczony z DtsObject).
	GetType	(Dziedziczony z Object).
	InitializeTask	Inicjuje właściwości skojarzonych z zadaniem skryptu.Ta metoda jest wywoływana w czasie wykonywania i nie jest używany w kodzie. (Zastępuje Task.InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)).
	LoadFromXML	Wczytuje dane zadanie skryptu z pliku XML.Ta metoda nie jest wpłacone przez kod aplikacji.Aby załadować pakiet zapisany jako XML, należy użyć Application.LoadPackage metoda.
	MemberwiseClone	(Dziedziczony z Object).
	ReportBreakpointChanges	Infrastruktura.
	ResumeExecution	Wznawia wykonanie zadania lub kontener przez uruchomienie -czas silnika po wstrzymaniu.
	SaveToXML	Zapisuje składnik zadań skryptów XML.Ta metoda nie jest wpłacone przez kod aplikacji.Aby zapisać pakiet jako XML, użyj Application.SaveToXml metoda.
	SetUniqueScriptProjectName	Określa unikatową nazwę projektu skryptu.
	SuspendExecution	Wskazuje, że plik wykonywalny musi zawiesić wykonanie.Ta metoda jest wywoływana przez uruchomienie -czas silnika.
	ToString	(Dziedziczony z Object).
	Update	*** Członkowskich zaniechane; Zobacz uwagi. *** Ta metoda aktualizuje stare pakiet XML z nowego pakietu XML, jeśli CanUpdate jest zestaw do true. (Dziedziczony z Task).
	Validate	Weryfikuje, że składnik jest prawidłowo skonfigurowany. (Zastępuje Task.Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)).

Do góry

Uwagi

ScriptTask Klasy definiuje zadania skryptu i obsługi interakcji zadania skryptu z wykonawczym i Visual Studio do aplikacji.

Aby uzyskać więcej informacji, zobacz tematy Zadania skryptu i Kodowanie i zadania skryptu debugowania.

Przykłady

Poniższy przykładowy kod w aplikacji konsoli dodaje ScriptTask pakiet i wyświetla wartości domyślne niektórych właściwości.

using System;
using Microsoft.SqlServer.Dts.Runtime;

namespace ScriptTaskCS
{
  class Program
  {
    static void Main(string[] args)
    {
      Package pkg = new Package();
      string newLine = System.Environment.NewLine;

      Executable exe = pkg.Executables.Add("STOCK:ScriptTask");
      TaskHost thTask = (TaskHost)exe;

      string taskInfo;
      taskInfo = 
        
        "Entry point: " + 
        thTask.Properties["EntryPoint"].GetValue(thTask) + newLine + 
        "Script Language: " + 
        thTask.Properties["ScriptLanguage"].GetValue(thTask) + newLine + 
        "ReadOnlyVariables: " + 
        thTask.Properties["ReadOnlyVariables"].GetValue(thTask) + newLine + 
        "ReadWriteVariables: " + 
        thTask.Properties["ReadWriteVariables"].GetValue(thTask);

      Console.WriteLine(taskInfo);
      Console.Read();
    }
  }
}

Imports Microsoft.SqlServer.Dts.Runtime

Module Module1

  Sub Main()

    Dim pkg As New Package
    Dim newLine As String = System.Environment.NewLine

    Dim exe As Executable = pkg.Executables.Add("STOCK:ScriptTask")
    Dim thTask As TaskHost = CType(exe, TaskHost)

    Dim taskInfo As String
    taskInfo = 
      
      "Entry point: " & _
      thTask.Properties("EntryPoint").GetValue(thTask) & newLine & _
      "Script Language: " & _
      thTask.Properties("ScriptLanguage").GetValue(thTask) & newLine & _
      "ReadOnlyVariables: " & _
      thTask.Properties("ReadOnlyVariables").GetValue(thTask) & newLine & _
      "ReadWriteVariables: " & _
      thTask.Properties("ReadWriteVariables").GetValue(thTask)

    Console.WriteLine(taskInfo)
    Console.Read()

  End Sub

End Module

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.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Dts.Tasks.ScriptTask