SendMailTask Classe

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Tasks.SendMailTask

Assembly:

Microsoft.SqlServer.SendMailTask.dll

Invia un messaggio di posta elettronica. La classe non può essere ereditata.

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 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 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

Ereditarietà

Object

DtsObject

Task

SendMailTask

Attributi

DtsTaskAttribute

Implementazioni

IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IDTSSendMailTask

Esempio

L'esempio di codice seguente crea, configura ed esegue un nuovo SendMailTaskoggetto .

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  

Commenti

Usando l'attività Invia posta elettronica, un pacchetto può inviare messaggi di notifica quando le attività nel flusso di lavoro del pacchetto hanno esito positivo o negativo. Per altre informazioni, vedere Inviare attività di posta elettronica.

Costruttori

SendMailTask()

Inizializza una nuova istanza della classe SendMailTask.

Proprietà

BCCLine	Ottiene o imposta gli indirizzi di posta elettronica dei destinatari in copia per conoscenza nascosta, delimitati da punti e virgola in caso di presenza di più indirizzi di posta elettronica.
CCLine	Ottiene o imposta gli indirizzi di posta elettronica dei destinatari in copia per conoscenza, delimitati da punti e virgola in caso di presenza di più indirizzi di posta elettronica.
DebugMode	Ottiene o imposta un valore booleano che indica se l'oggetto è in modalità di debug e se deve generare l'evento durante l'esecuzione OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) .
ExecutionValue	Restituisce un oggetto definito dall'utente. Questo campo è di sola lettura. (Ereditato da Task)
FileAttachments	Ottiene o imposta i nomi dei file allegati al messaggio di posta elettronica, delimitati dal carattere barra verticale (|) in caso di presenza di più file.
FromLine	Ottiene o imposta l'indirizzo di posta elettronica del mittente.
MessageSource	Ottiene o imposta il corpo del messaggio o il nome dell'origine contenente il corpo del messaggio.
MessageSourceType	Ottiene o imposta un valore contenente il tipo di origine del corpo del messaggio.
Priority	Ottiene o imposta la priorità del messaggio.
SmtpConnection	Ottiene o imposta il nome o l'indirizzo IP del server SMTP (Simple Mail Transfer Protocol).
Subject	Ottiene o imposta l'oggetto del messaggio di posta elettronica.
SuspendRequired	Ottiene o imposta un valore booleano che indica se le attività devono essere sospese quando rilevano un punto di interruzione. Questo valore viene impostato dal motore di runtime per le attività e i contenitori quando viene rilevato un punto di interruzione.
TargetServerVersion	Invia un messaggio di posta elettronica. La classe non può essere ereditata. (Ereditato da Task)
ToLine	Ottiene o imposta gli indirizzi di posta elettronica dei destinatari, delimitati da punti e virgola in caso di presenza di più destinatari.
Version	*** Membro deprecato; vedere la sezione Osservazioni. Restituisce la versione dell'attività. Questa proprietà è di sola lettura. (Ereditato da Task)

Metodi

AcceptBreakpointManager(BreakpointManager)	Passa un oggetto BreakpointManager a un'attività Invia messaggi. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice.
CanUpdate(String)	*** Membro deprecato; vedere la sezione Osservazioni. Valore booleano che indica se il nuovo codice XML del pacchetto può aggiornare il codice XML del pacchetto precedente. (Ereditato da Task)
Equals(Object)	Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Esegue l'attività Invia messaggi.
GetConnectionID(Connections, String)	Ottiene un valore String contenente l'ID della connessione. (Ereditato da Task)
GetConnectionName(Connections, String)	Ottiene un valore String contenente il nome della connessione. (Ereditato da Task)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inizializza le proprietà associate all'attività. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice.
LoadFromXML(XmlElement, IDTSInfoEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).
ResumeExecution()	Riprende l'esecuzione dell'attività dopo la sospensione. L'attività o il contenitore viene ripreso dal motore di runtime.
SaveToXML(XmlDocument, IDTSInfoEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents).
SuspendExecution()	Indica la necessità di sospendere l'eseguibile. Questo metodo viene chiamato dal motore di runtime.
Update(String)	*** Membro deprecato; vedere la sezione Osservazioni. Questo metodo aggiorna il codice XML del pacchetto precedente con il nuovo XML del pacchetto se CanUpdate(String) è impostato su true. (Ereditato da Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Verifica che l'attività sia configurata correttamente.