MessageQueueTask Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Tasks.MessageQueueTask

Rakitan:

Microsoft.SqlServer.MSMQTask.dll

Berisi metode dan properti yang digunakan oleh tugas Antrean Pesan. Kelas ini tidak dapat diwariskan.

public ref class MessageQueueTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::MessageQueueTask::IMessageQueueTask

[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.messagequeuetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MSMQTaskMessages), SamplesTag="SsisMessageQueueTask", TaskContact="Message Queue Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTaskUI, Microsoft.SqlServer.MSMQTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class MessageQueueTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.IMessageQueueTask

[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.messagequeuetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MSMQTaskMessages), SamplesTag="SsisMessageQueueTask", TaskContact="Message Queue Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTaskUI, Microsoft.SqlServer.MSMQTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type MessageQueueTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IMessageQueueTask
    interface IDTSBreakpointSite
    interface IDTSSuspend

Public NotInheritable Class MessageQueueTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IMessageQueueTask

Warisan

Object

DtsObject

Task

MessageQueueTask

Atribut

DtsTaskAttribute

Penerapan

IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IMessageQueueTask

Keterangan

Kelas tugas Antrean Pesan memungkinkan objek mengirim dan menerima pesan ke atau dari antrean Antrean Pesan (juga dikenal sebagai MSMQ). Partisipasi dalam transaksi terdistribusi diizinkan saat menjalankan Koordinator Transaksi Terdistribusi Microsoft (MSDTC). Satu instans tugas Antrean Pesan mengirim satu pesan ke antrean tertentu atau menerima satu pesan dari antrean tertentu, dan juga menunggu, jika perlu, agar pesan tiba. Jenis pesan berikut dapat dikirim:

• Pesan string, yang disediakan sebagai nilai properti.

• Pesan file data, yang dihasilkan dari konten file data tertentu.

• Pesan variabel, yang dihasilkan dari nama dan nilai satu atau beberapa variabel SQL Server Integration Services.

Enumerasi MQMessageType menentukan format pesan mana yang digunakan oleh tugas Antrean Pesan tertentu.

Untuk informasi selengkapnya, lihat Tugas Antrean Pesan.

MessageQueueTask Agar berfungsi di API atau di SSIS Designer, Anda harus menginstal SQL Server Integration Services. Fitur ini tidak akan berfungsi jika hanya SQL Server Data Tools (SSDT) yang diinstal.

Penting

Saat mengonfigurasi tugas Antrean Pesan untuk mengirim pesan, Anda dapat menggunakan salah satu algoritma enkripsi yang saat ini didukung oleh Antrean Pesan, RC2 dan RC4, untuk mengenkripsi pesan. Kedua algoritma enkripsi ini sekarang dianggap lemah secara kriptografis dibandingkan dengan algoritma yang lebih baru, yang belum didukung oleh Antrean Pesan. Oleh karena itu, Anda harus mempertimbangkan kebutuhan kriptografi Anda dengan hati-hati saat mengirim pesan menggunakan tugas Antrean Pesan.

Konstruktor

MessageQueueTask()

Menginisialisasi instans baru kelas MessageQueueTask.

Properti

CurrentExecutingPackageID	Mendapatkan atau mengatur ID paket eksekusi saat ini.
DataFileOverWritable	Mendapatkan atau mengatur Boolean yang menunjukkan apakah pesan file data dapat menimpa file data yang ada.
DebugMode	Mendapatkan atau mengatur Boolean yang menunjukkan apakah objek berada dalam mode debug, dan apakah objek harus menaikkan OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) peristiwa saat berjalan.
DTSMessageLineageID	Mendapatkan atau mengatur pengidentifikasi silsilah pesan.
DTSMessagePackageID	Mendapatkan atau mengatur pengidentifikasi paket yang merupakan sumber pesan.
DTSMessageVersionID	Mendapatkan atau mengatur versi pesan.
EncryptionAlgo	Mendapatkan atau mengatur nama algoritma enkripsi yang digunakan untuk mengenkripsi isi pesan pesan privat.
ErrorIfMessageTimeOut	Mendapatkan atau mengatur Boolean yang menentukan apakah tugas gagal saat pesan kehabisan waktu.
ExecutionValue	Mengembalikan objek yang ditentukan pengguna. Bidang ini hanya-baca. (Diperoleh dari Task)
MessageDataFile	Mendapatkan atau mengatur nama file data yang digunakan saat MessageType diatur ke DTSMQMessageType_DataFile.
MessageString	Mendapatkan atau mengatur pesan yang akan digunakan saat MessageType diatur ke DTSMQMessageType_String.
MessageType	Mendapatkan atau menetapkan nilai yang menunjukkan jenis pesan yang dikirim saat TaskType adalah DTSMQType_Sender.
MessageVariables	Mendapatkan atau mengatur daftar variabel saat MQMessageType enumerasi diatur ke DTSMQMessageType_Variables.
MsmqConnection	Mendapatkan atau mengatur nama koneksi untuk tugas MSMQ.
OperationDescription	Mendapatkan atau mengatur deskripsi operasi.
ReceiveMessageTimeOut	Mendapatkan atau menetapkan nilai yang menentukan jumlah detik sebelum waktu pesan yang diterima habis.
ReceiveMessageType	Mendapatkan atau menetapkan MQMessageType nilai yang menunjukkan jenis pesan yang akan diterima.
ReceiveVariableMessage	Mendapatkan atau mengatur nama variabel untuk menyimpan pesan.
RemoveFromQueue	Mendapatkan atau mengatur Boolean yang menentukan apakah pesan harus dihapus dari antrean.
SaveDataFileName	Mendapatkan atau mengatur nama file tempat pesan File Data masuk disimpan.
StringCompareType	Nilai yang menentukan metode perbandingan string untuk jenis pesan String saat TaskType adalah DTSMQType_Receiver.
StringCompareValue	Mendapatkan atau mengatur String tempat pesan string dibandingkan dengan saat TaskType adalah DTSMQType_Receiver.
StringMessageToVariableName	Mendapatkan atau mengatur nama variabel tempat konten pesan disimpan.
SuspendRequired	Mendapatkan atau mengatur Boolean yang menunjukkan apakah tugas harus ditangguhkan saat menemukan titik henti. Nilai ini diatur oleh mesin runtime untuk tugas dan kontainer saat titik henti ditemui.
TargetServerVersion	Berisi metode dan properti yang digunakan oleh tugas Antrean Pesan. Kelas ini tidak dapat diwariskan. (Diperoleh dari Task)
TaskType	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tugas pesan dikirim atau diterima.
Use2000Format	Mendapatkan atau mengatur Boolean yang menunjukkan bahwa pesan menggunakan format SQL Server 2000.
UseEncryption	Mendapatkan atau mengatur Boolean yang menunjukkan apakah pesan menggunakan enkripsi.
Version	Anggota tidak digunakan lagi; lihat Keterangan. Mengembalikan versi tugas. Properti ini bersifat hanya baca. (Diperoleh dari Task)

Metode

AcceptBreakpointManager(BreakpointManager)	Meneruskan BreakpointManager ke tugas. Metode ini dipanggil oleh runtime dan tidak digunakan dalam kode.
CanUpdate(String)	Anggota tidak digunakan lagi; lihat Keterangan. Boolean yang menunjukkan apakah XML paket baru dapat memperbarui XML paket lama. (Diperoleh dari Task)
Equals(Object)	Menentukan apakah dua instans objek sama. (Diperoleh dari DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Menjalankan tugas.
GetConnectionID(Connections, String)	Mendapatkan String yang berisi ID koneksi. (Diperoleh dari Task)
GetConnectionName(Connections, String)	Mendapatkan String yang berisi nama koneksi. (Diperoleh dari Task)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Menginisialisasi properti yang terkait dengan tugas. Metode ini dipanggil oleh runtime dan tidak digunakan dalam kode.
LoadFromXML(XmlElement, IDTSInfoEvents)	Metode ini tidak dapat dipanggil oleh kode aplikasi Anda. Untuk memuat paket yang disimpan dalam format XML (dengan ekstensi nama file the.xml), gunakan metode .LoadPackage(String, IDTSEvents)
ResumeExecution()	Melanjutkan eksekusi tugas setelah jeda. Eksekusi tugas atau kontainer dilanjutkan oleh mesin runtime.
SaveToXML(XmlDocument, IDTSInfoEvents)	Metode ini tidak dapat dipanggil oleh kode aplikasi Anda. Untuk menyimpan paket sebagai .xml, gunakan metode .SaveToXml(String, Package, IDTSEvents)
SuspendExecution()	Menunjukkan bahwa executable perlu ditangguhkan. Metode ini dipanggil oleh mesin runtime.
Update(String)	Anggota tidak digunakan lagi; lihat Keterangan. Metode ini memperbarui XML paket lama dengan XML paket baru jika CanUpdate(String) diatur ke true. (Diperoleh dari Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Memverifikasi bahwa tugas dikonfigurasi dengan benar.