SendMailTask Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengirim pesan email. Kelas ini tidak dapat diwariskan.
public ref class SendMailTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::SendMailTask::IDTSSendMailTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class SendMailTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.SendMailTask.IDTSSendMailTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class SendMailTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.SendMailTask.IDTSSendMailTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail 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.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class SendMailTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.SendMailTask.IDTSSendMailTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type SendMailTask = class
inherit Task
interface IDTSComponentPersist
interface IDTSSendMailTask
interface IDTSBreakpointSite
interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type SendMailTask = class
inherit Task
interface IDTSComponentPersist
interface IDTSSendMailTask
interface IDTSBreakpointSite
interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.sendmailtask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.SendMailTask.SendMailTaskMessages), SamplesTag="SsisSendMailTask", TaskContact="Send Mail 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.SendMailTask.SendMailTaskUI, Microsoft.SqlServer.SendMailTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type SendMailTask = class
inherit Task
interface IDTSComponentPersist
interface IDTSSendMailTask
interface IDTSBreakpointSite
interface IDTSSuspend
Public NotInheritable Class SendMailTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IDTSSendMailTask
- Warisan
- Atribut
- Penerapan
Contoh
Sampel kode berikut membuat, mengonfigurasi, dan menjalankan yang baru SendMailTask.
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.SendMailTask;
class TestSendMailTask
{
public static void Main()
{
Package pkg = new Package();
ConnectionManager smtpCM;
smtpCM = pkg.Connections.Add("SMTP");
smtpCM.Name = "SMTP Connection Manager";
smtpCM.ConnectionString = "smtphost";
Executable exe = pkg.Executables.Add("STOCK:SendMailTask");
TaskHost thSendMailTask = (TaskHost)exe;
{
thSendMailTask.Properties["SmtpConnection"].SetValue(thSendMailTask, "SMTP Connection Manager");
thSendMailTask.Properties["ToLine"].SetValue(thSendMailTask, "someone1@example.com");
thSendMailTask.Properties["CCLine"].SetValue(thSendMailTask, "someone2@example.com");
thSendMailTask.Properties["BCCLine"].SetValue(thSendMailTask, "someone3@example.com");
thSendMailTask.Properties["FromLine"].SetValue(thSendMailTask, "someone4@example.com");
thSendMailTask.Properties["Priority"].SetValue(thSendMailTask, MailPriority.Normal);
thSendMailTask.Properties["FileAttachments"].SetValue(thSendMailTask, "C:\\test_image.jpg");
thSendMailTask.Properties["Subject"].SetValue(thSendMailTask, "Testing the SendMail Task");
thSendMailTask.Properties["MessageSourceType"].SetValue(thSendMailTask, SendMailMessageSourceType.DirectInput);
thSendMailTask.Properties["MessageSource"].SetValue(thSendMailTask, "This is only a test.");
}
DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);
if (valResults == DTSExecResult.Success)
{
pkg.Execute();
}
}
}
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.SendMailTask
Module TestSendMailTask
Sub Main()
Dim pkg As New Package
Dim smtpCM As ConnectionManager
smtpCM = pkg.Connections.Add("SMTP")
smtpCM.Name = "SMTP Connection Manager"
smtpCM.ConnectionString = "smtphost"
Dim exe As Executable = pkg.Executables.Add("STOCK:SendMailTask")
Dim thSendMailTask As TaskHost = CType(exe, TaskHost)
With thSendMailTask
.Properties("SmtpConnection").SetValue(thSendMailTask, "SMTP Connection Manager")
.Properties("ToLine").SetValue(thSendMailTask, "someone1@example.com")
.Properties("CCLine").SetValue(thSendMailTask, "someone2@example.com")
.Properties("BCCLine").SetValue(thSendMailTask, "someone3@example.com")
.Properties("FromLine").SetValue(thSendMailTask, "someone4@example.com")
.Properties("Priority").SetValue(thSendMailTask, MailPriority.Normal)
.Properties("FileAttachments").SetValue(thSendMailTask, "C:\test_image.jpg")
.Properties("Subject").SetValue(thSendMailTask, "Testing the SendMail Task")
.Properties("MessageSourceType").SetValue(thSendMailTask, SendMailMessageSourceType.DirectInput)
.Properties("MessageSource").SetValue(thSendMailTask, "This is only a test.")
End With
Dim valResults As DTSExecResult = pkg.Validate(pkg.Connections, pkg.Variables, Nothing, Nothing)
If valResults = DTSExecResult.Success Then
pkg.Execute()
End If
End Sub
End Module
Keterangan
Dengan menggunakan tugas Kirim Email, paket dapat mengirim pesan pemberitahuan saat tugas dalam alur kerja paket berhasil atau gagal. Untuk informasi selengkapnya, lihat Mengirim Tugas Email.
Konstruktor
SendMailTask() |
Menginisialisasi instans baru kelas SendMailTask. |
Properti
BCCLine |
Mendapatkan atau mengatur alamat email penerima blind carbon copy, dibatasi oleh titik koma ketika ada lebih dari satu. |
CCLine |
Mendapatkan atau mengatur alamat email penerima salinan karbon, dibatasi oleh titik koma ketika ada lebih dari satu. |
DebugMode |
Mendapatkan atau mengatur Boolean yang menunjukkan apakah objek berada dalam mode debug, dan apakah objek harus menaikkan OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) peristiwa saat berjalan. |
ExecutionValue |
Mengembalikan objek yang ditentukan pengguna. Bidang ini hanya-baca. (Diperoleh dari Task) |
FileAttachments |
Mendapatkan atau mengatur nama file yang dilampirkan ke pesan email, dibatasi oleh karakter pipa (|) ketika ada lebih dari satu file. |
FromLine |
Mendapatkan atau mengatur alamat email pengirim. |
MessageSource |
Mendapatkan atau mengatur isi pesan atau nama sumber yang berisi isi pesan. |
MessageSourceType |
Mendapatkan atau mengatur nilai yang berisi jenis sumber isi pesan. |
Priority |
Mendapatkan atau mengatur prioritas pesan. |
SmtpConnection |
Mendapatkan atau mengatur nama atau alamat IP server Simple Mail Transfer Protocol (SMTP). |
Subject |
Mendapatkan atau mengatur subjek pesan email. |
SuspendRequired |
Mendapatkan atau mengatur Boolean yang menunjukkan apakah tugas harus ditangguhkan saat menemukan titik henti. Nilai ini ditetapkan oleh mesin runtime untuk tugas dan kontainer saat titik henti ditemui. |
TargetServerVersion |
Mengirim pesan email. Kelas ini tidak dapat diwariskan. (Diperoleh dari Task) |
ToLine |
Mendapatkan atau mengatur alamat email penerima, dibatasi oleh titik koma jika ada lebih dari satu penerima. |
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 Kirim Email. 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 Kirim Email. |
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 sebagai .xml, gunakan metode .LoadPackage(String, IDTSEvents) |
ResumeExecution() |
Melanjutkan eksekusi tugas setelah jeda. 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 SaveToXml(String, Package, IDTSEvents) metode . |
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. |