Klasa SendMailTask

Wysyła wiadomość e-mail.Klasa ta nie może być dziedziczona.

Hierarchia dziedziczenia

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

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

Składnia

'Deklaracja
Public NotInheritable Class SendMailTask _
    Inherits Task _
    Implements IDTSComponentPersist, IDTSSendMailTask, IDTSBreakpointSite, IDTSSuspend
'Użycie
Dim instance As SendMailTask

public sealed class SendMailTask : Task, 
    IDTSComponentPersist, IDTSSendMailTask, IDTSBreakpointSite, IDTSSuspend

public ref class SendMailTask sealed : public Task, 
    IDTSComponentPersist, IDTSSendMailTask, IDTSBreakpointSite, IDTSSuspend

[<SealedAttribute>]
type SendMailTask =  
    class
        inherit Task
        interface IDTSComponentPersist
        interface IDTSSendMailTask
        interface IDTSBreakpointSite
        interface IDTSSuspend
    end

public final class SendMailTask extends Task implements IDTSComponentPersist, IDTSSendMailTask, IDTSBreakpointSite, IDTSSuspend

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

Konstruktorzy

	Nazwa	Opis
	SendMailTask	Inicjuje nowe wystąpienie SendMailTask klasy

Do góry

Właściwości

	Nazwa	Opis
	BCCLine	Pobiera lub ustawia adresy e-mail adresatów ukryta kopia wiadomości, rozdzielone średnikami, gdy istnieje więcej niż jeden.
	CCLine	Pobiera lub ustawia adresy e-mail adresatów wiadomości, rozdzielone średnikami, gdy istnieje więcej niż jeden.
	DebugMode	Pobiera lub ustawia logiczna wskazująca, czy obiekt jest w trybie debugowania i czy powinna podnieść OnBreakpointHit zdarzenie podczas uruchamiania.
	ExecutionValue	Zwraca obiekt zdefiniowany przez użytkownika.To pole jest tylko do odczytu. (Dziedziczony z Task).
	FileAttachments	Pobiera lub ustawia nazwy plików dołączonych do wiadomości e-mail, rozdzielone znakiem potoku (|), gdy istnieje więcej niż jeden plik.
	FromLine	Pobiera lub ustawia adres e-mail nadawcy.
	MessageSource	Pobiera lub ustawia nazwę źródło, która zawiera treść wiadomości lub treści wiadomości.
	MessageSourceType	Pobiera lub ustawia wartość typu źródło, w treści wiadomości.
	Priority	Pobiera lub ustawia priorytet wiadomości.
	SmtpConnection	Pobiera lub ustawia nazwę lub adres IP serwera Simple Mail Transfer Protocol (SMTP).
	Subject	Pobiera lub ustawia tematu wiadomości e-mail.
	SuspendRequired	Pobiera lub ustawia wartość logiczna wskazująca, że jeżeli zadań należy zawiesić po napotkaniu punktu punkt przerwania.Wartość ta jest zestaw przez aparat wykonywania zadań i pojemników po napotkaniu punktu punkt przerwania.
	ToLine	Pobiera lub ustawia adresy e-mail adresatów rozdzielone średnikami, jeśli istnieje więcej niż jednego adresata.
	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ń Wyślij pocztę.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	Wykonuje zadania Wyślij pocztę. (Zastępuje Task.Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)).
	Finalize	(Dziedziczony z Object).
	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.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	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).
	ResumeExecution	Wznawia działanie po wstrzymaniu wykonania zadania.Zadania lub kontener jest wznawiany przez aparat runtime.
	SaveToXML	Ta metoda nie jest wpłacone przez kod aplikacji.Aby zapisać pakiet jako XML, użyj Application.SaveToXml metoda.
	SuspendExecution	Wskazuje, że plik wykonywalny musi zawiesić.Metoda ta jest wywoływana przez aparat runtime.
	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	Sprawdza, czy zadanie jest właściwie skonfigurowany. (Zastępuje Task.Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)).

Do góry

Uwagi

Za pomocą zadań Wyślij pocztę, pakiet wiadomości można wysyłać powiadomienie podczas zadania w przepływie pracy pakiet się pomyślnie lub nie powiedzie się.Aby uzyskać więcej informacji, zobacz temat Wysyłanie poczty zadania.

Przykłady

Poniższy przykładowy kod tworzy konfiguruje i wykonuje nowy 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

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