Package.Execute Metode

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Mengembalikan DTSExecResult enumerasi yang berisi informasi tentang keberhasilan atau kegagalan eksekusi paket.

public:
 Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute();

public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute ();

override this.Execute : unit -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Function Execute () As DTSExecResult

Mengembalikan

DTSExecResult

DTSExecResult Enumerasi yang berisi informasi tentang keberhasilan atau kegagalan eksekusi paket.

Contoh

Contoh kode berikut membuat paket, mengatur OfflineMode properti dan InteractiveMode sebelum menambahkan tugas skrip. Kemudian menjalankan paket menggunakan Execute metode .

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

namespace Package_API  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package p = new Package();  
            p.InteractiveMode = true;  
            p.OfflineMode = true;  

            // Add a Script Task to the package.  
            TaskHost taskH = (TaskHost)p.Executables.Add(typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName);  
            // Run the package.  
            p.Execute();  
            // Review the results of the run.  
            if (taskH.ExecutionResult == DTSExecResult.Failure || taskH.ExecutionStatus == DTSExecStatus.Abend)  
                Console.WriteLine("Task failed or abended");  
            else  
                Console.WriteLine("Task ran successfully");  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.ScriptTask  

Namespace Package_API  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim p As Package =  New Package()   
            p.InteractiveMode = True  
            p.OfflineMode = True  

            ' Add a Script Task to the package.  
            Dim taskH As TaskHost = CType(p.Executables.Add(Type.GetType(Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTask).AssemblyQualifiedName), TaskHost)  
            ' Run the package.  
            p.Execute()  
            ' Review the results of the run.  
            If taskH.ExecutionResult = DTSExecResult.Failure Or taskH.ExecutionStatus = DTSExecStatus.Abend Then  
                Console.WriteLine("Task failed or abended")  
            Else   
                Console.WriteLine("Task ran successfully")  
            End If  
        End Sub  
    End Class  
End Namespace  

Keterangan

Metode Execute ini diwariskan oleh host tugas dan objek lain dari Executable kelas abstrak, melalui DtsContainer kelas , dan memungkinkan objek warisan dijalankan oleh mesin runtime. Metode Execute yang diwarisi oleh objek individual tidak umum digunakan dalam kode, dan disarankan agar Anda memanggil Execute metode jika Anda perlu menjalankan salah satu tugas atau kontainer dalam paket. Namun, Execute metode ini tersedia pada objek individual jika Anda menemukan keadaan unik di mana diperlukan.

Penggunaan Execute utama metode ini adalah agar diwariskan dan ditimpa saat Anda membuat tugas kustom. Untuk informasi selengkapnya tentang cara mengambil alih metode Jalankan, lihat Pengodean Tugas Kustom.

Metode memanggil Execute metode secara implisit Validate sebelum paket berjalan. Semua tugas dalam paket ditinjau untuk pengaturan yang sesuai selama validasi, dan semua objek dalam paket ditinjau, termasuk paket, kontainer, dan komponen lain dalam paket.

Jika tidak ada masalah yang dihadapi dalam fase validasi yang akan menyebabkan paket gagal, objek paket melanjutkan untuk memanggil Execute metode untuk setiap tugas dan objek dalam paket.

Teruskan nulltransaction untuk parameter saat TransactionOption properti adalah false. TransactionOption Jika properti benar, Anda dapat meneruskan nulltransaction parameter untuk menunjukkan bahwa kontainer mendukung transaksi tetapi tidak berpartisipasi.