SmtpClient SmtpClient SmtpClient SmtpClient Class

Definition

Warnung

Diese API ist jetzt veraltet.

Ermöglicht Anwendungen das Senden von E-Mails mit SMTP (Simple Mail Transfer Protocol).Allows applications to send email by using the Simple Mail Transfer Protocol (SMTP). Der SmtpClient-Typ ist jetzt veraltet.The SmtpClient type is now obsolete.

public ref class SmtpClient : IDisposable
[System.Obsolete("SmtpClient and its network of types are poorly designed, we strongly recommend you use https://github.com/jstedfast/MailKit and https://github.com/jstedfast/MimeKit instead")]
public class SmtpClient : IDisposable
type SmtpClient = class
    interface IDisposable
Public Class SmtpClient
Implements IDisposable
Vererbung
SmtpClientSmtpClientSmtpClientSmtpClient
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird das asynchrone Senden einer e-Mail-Nachricht veranschaulicht.The following code example demonstrates sending an email message asynchronously.

#using <System.dll>
using namespace System;
using namespace System::Net;
using namespace System::Net::Mail;
using namespace System::Net::Mime;
using namespace System::Threading;
using namespace System::ComponentModel;

static bool mailSent;

static void SendCompletedCallback(Object^ sender, AsyncCompletedEventArgs^ e)
{
    // Get the unique identifier for this asynchronous 
    // operation.
    String^ token = (String^) e->UserState;

    if (e->Cancelled)
    {
        Console::WriteLine("[{0}] Send canceled.", token);
    }
    if (e->Error != nullptr)
    {
        Console::WriteLine("[{0}] {1}", token, 
            e->Error->ToString());
    } else
    {
        Console::WriteLine("Message sent.");
    }
    mailSent = true;
}

int main(array<String^>^ args)
{
    if (args->Length > 1)
    {
        // Command-line argument must be the SMTP host.
        SmtpClient^ client = gcnew SmtpClient(args[1]);
        // Specify the email sender.
        // Create a mailing address that includes a UTF8 
        // character in the display name.
        MailAddress^ from = gcnew MailAddress("jane@contoso.com",
            "Jane " + (wchar_t)0xD8 + " Clayton",
            System::Text::Encoding::UTF8);
        // Set destinations for the email message.
        MailAddress^ to = gcnew MailAddress("ben@contoso.com");
        // Specify the message content.
        MailMessage^ message = gcnew MailMessage(from, to);
        message->Body = "This is a test email message sent" +
            " by an application. ";
        // Include some non-ASCII characters in body and 
        // subject.
        String^ someArrows = gcnew String(gcnew array<wchar_t>{L'\u2190', 
            L'\u2191', L'\u2192', L'\u2193'});
        message->Body += Environment::NewLine + someArrows;
        message->BodyEncoding = System::Text::Encoding::UTF8;
        message->Subject = "test message 1" + someArrows;
        message->SubjectEncoding = System::Text::Encoding::UTF8;
        // Set the method that is called back when the send
        // operation ends.
        client->SendCompleted += gcnew
            SendCompletedEventHandler(SendCompletedCallback);
        // The userState can be any object that allows your 
        // callback method to identify this send operation.
        // For this example, the userToken is a string constant.
        String^ userState = "test message1";
        client->SendAsync(message, userState);
        Console::WriteLine("Sending message... press c to" +
            " cancel mail. Press any other key to exit.");
        String^ answer = Console::ReadLine();
        // If the user canceled the send, and mail hasn't been 
        // sent yet,then cancel the pending operation.
        if (answer->ToLower()->StartsWith("c") && mailSent == false)
        {
            client->SendAsyncCancel();
        }
        // Clean up.
        delete message;
        client = nullptr;
        Console::WriteLine("Goodbye.");
    }
    else
    {
        Console::WriteLine("Please give SMTP server name!");
    }
}

using System;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;
using System.Threading;
using System.ComponentModel;
namespace Examples.SmtpExamples.Async
{
    public class SimpleAsynchronousExample
    {
        static bool mailSent = false;
        private static void SendCompletedCallback(object sender, AsyncCompletedEventArgs e)
        {
            // Get the unique identifier for this asynchronous operation.
             String token = (string) e.UserState;
           
            if (e.Cancelled)
            {
                 Console.WriteLine("[{0}] Send canceled.", token);
            }
            if (e.Error != null)
            {
                 Console.WriteLine("[{0}] {1}", token, e.Error.ToString());
            } else
            {
                Console.WriteLine("Message sent.");
            }
            mailSent = true;
        }
        public static void Main(string[] args)
        {
            // Command-line argument must be the SMTP host.
            SmtpClient client = new SmtpClient(args[0]);
            // Specify the email sender.
            // Create a mailing address that includes a UTF8 character
            // in the display name.
            MailAddress from = new MailAddress("jane@contoso.com", 
               "Jane " + (char)0xD8+ " Clayton", 
            System.Text.Encoding.UTF8);
            // Set destinations for the email message.
            MailAddress to = new MailAddress("ben@contoso.com");
            // Specify the message content.
            MailMessage message = new MailMessage(from, to);
            message.Body = "This is a test email message sent by an application. ";
            // Include some non-ASCII characters in body and subject.
            string someArrows = new string(new char[] {'\u2190', '\u2191', '\u2192', '\u2193'});
            message.Body += Environment.NewLine + someArrows;
            message.BodyEncoding =  System.Text.Encoding.UTF8;
            message.Subject = "test message 1" + someArrows;
            message.SubjectEncoding = System.Text.Encoding.UTF8;
            // Set the method that is called back when the send operation ends.
            client.SendCompleted += new 
            SendCompletedEventHandler(SendCompletedCallback);
            // The userState can be any object that allows your callback 
            // method to identify this send operation.
            // For this example, the userToken is a string constant.
            string userState = "test message1";
            client.SendAsync(message, userState);
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.");
            string answer = Console.ReadLine();
            // If the user canceled the send, and mail hasn't been sent yet,
            // then cancel the pending operation.
            if (answer.StartsWith("c") && mailSent == false)
            {
                client.SendAsyncCancel();
            }
            // Clean up.
            message.Dispose();
            Console.WriteLine("Goodbye.");
        }
    }
}

Imports System.Net
Imports System.Net.Mail
Imports System.Net.Mime
Imports System.Threading
Imports System.ComponentModel

Namespace Examples.SmtpExamples.Async
    Public Class SimpleAsynchronousExample
        Private Shared mailSent As Boolean = False
        Private Shared Sub SendCompletedCallback(ByVal sender As Object, ByVal e As AsyncCompletedEventArgs)
            ' Get the unique identifier for this asynchronous operation.
            Dim token As String = CStr(e.UserState)

            If e.Cancelled Then
                Console.WriteLine("[{0}] Send canceled.", token)
            End If
            If e.Error IsNot Nothing Then
                Console.WriteLine("[{0}] {1}", token, e.Error.ToString())
            Else
                Console.WriteLine("Message sent.")
            End If
            mailSent = True
        End Sub
        Public Shared Sub Main(ByVal args() As String)
            ' Command line argument must the SMTP host.
            Dim client As New SmtpClient(args(0))
            ' Specify the email sender.
            ' Create a mailing address that includes a UTF8 character
            ' in the display name.
            Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)
            ' Set destinations for the email message.
            Dim mailTo As New MailAddress("ben@contoso.com")
            ' Specify the message content.
            Dim message As New MailMessage(mailFrom, mailTo)
            message.Body = "This is a test email message sent by an application. "
            ' Include some non-ASCII characters in body and subject.
            Dim someArrows As New String(New Char() {ChrW(&H2190), ChrW(&H2191), ChrW(&H2192), ChrW(&H2193)})
            message.Body += Environment.NewLine & someArrows
            message.BodyEncoding = System.Text.Encoding.UTF8
            message.Subject = "test message 1" & someArrows
            message.SubjectEncoding = System.Text.Encoding.UTF8
            ' Set the method that is called back when the send operation ends.
            AddHandler client.SendCompleted, AddressOf SendCompletedCallback
            ' The userState can be any object that allows your callback 
            ' method to identify this send operation.
            ' For this example, the userToken is a string constant.
            Dim userState As String = "test message1"
            client.SendAsync(message, userState)
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.")
            Dim answer As String = Console.ReadLine()
            ' If the user canceled the send, and mail hasn't been sent yet,
            ' then cancel the pending operation.
            If answer.StartsWith("c") AndAlso mailSent = False Then
                client.SendAsyncCancel()
            End If
            ' Clean up.
            message.Dispose()
            Console.WriteLine("Goodbye.")
        End Sub
    End Class
End Namespace

Hinweise

Die System.Net.Mail.SmtpClient -Klasse wird zum Senden von e-Mails an einen SMTP-Server für die Übermittlung verwendet.The System.Net.Mail.SmtpClient class is used to send email to an SMTP server for delivery. Das SMTP-Protokoll ist in RFC 2821 definiert, das unter https://www.ietf.orgverfügbar ist.The SMTP protocol is defined in RFC 2821, which is available at https://www.ietf.org.

Wichtig

Es wird nicht empfohlen, die- SmtpClient Klasse für die neue Entwicklung zu verwenden.We don't recommend that you use the SmtpClient class for new development. Weitere Informationen finden Sie unter SmtpClient darf nicht auf GitHub verwendet werden.For more information, see SmtpClient shouldn't be used on GitHub.

Die in der folgenden Tabelle gezeigten Klassen werden verwendet, um e-Mail-Nachrichten zu SmtpClienterstellen, die mit gesendet werden können.The classes shown in the following table are used to construct email messages that can be sent using SmtpClient.

KlasseClass BeschreibungDescription
Attachment Stellt Dateianhänge dar.Represents file attachments. Diese Klasse ermöglicht das Anfügen von Dateien, Streams oder Text an eine e-Mail-Nachricht.This class allows you to attach files, streams, or text to an email message.
MailAddress Stellt die e-Mail-Adresse des Absenders und der Empfänger dar.Represents the email address of the sender and recipients.
MailMessage Stellt eine e-Mail dar.Represents an email message.

Zum Erstellen und Senden einer e-Mail- SmtpClientNachricht mithilfe von müssen Sie die folgenden Informationen angeben:To construct and send an email message by using SmtpClient, you must specify the following information:

  • Der SMTP-Host Server, den Sie zum Senden von e-Mails verwenden.The SMTP host server that you use to send email. Siehe die Host Eigenschaften Port und.See the Host and Port properties.

  • Anmelde Informationen für die Authentifizierung, wenn dies für den SMTP-Server erforderlich ist.Credentials for authentication, if required by the SMTP server. Siehe Credentials-Eigenschaft.See the Credentials property.

  • Die e-Mail-Adresse des Absenders.The email address of the sender. Siehe die Send Methoden SendAsync und, die einen from -Parameter akzeptieren.See the Send and SendAsync methods that take a from parameter. Siehe auch die MailMessage.From -Eigenschaft.Also see the MailMessage.From property.

  • Die e-Mail-Adresse oder die Adressen der Empfänger.The email address or addresses of the recipients. Siehe die Send Methoden SendAsync und, die einen recipient -Parameter akzeptieren.See the Send and SendAsync methods that take a recipient parameter. Siehe auch die MailMessage.To -Eigenschaft.Also see the MailMessage.To property.

  • Der Nachrichten Inhalt.The message content. Siehe die Send Methoden SendAsync und, die einen body -Parameter akzeptieren.See the Send and SendAsync methods that take a body parameter. Siehe auch die MailMessage.Body -Eigenschaft.Also see the MailMessage.Body property.

Wenn Sie eine Anlage mit einer e-Mail-Nachricht einschließen möchten, erstellen Sie Attachment zuerst die Anlage mithilfe der-Klasse, und fügen Sie Sie MailMessage.Attachments dann der Nachricht mithilfe der-Eigenschaft hinzu.To include an attachment with an email message, first create the attachment by using the Attachment class, and then add it to the message by using the MailMessage.Attachments property. Abhängig von dem von den Empfängern verwendeten e-Mail-Reader und dem Dateityp der Anlage sind einige Empfänger möglicherweise nicht in der Lage, die Anlage zu lesen.Depending on the email reader used by the recipients and the file type of the attachment, some recipients might not be able to read the attachment. Für Clients, die die Anlage nicht in ihrer ursprünglichen Form anzeigen können, können Sie mithilfe der MailMessage.AlternateViews -Eigenschaft Alternative Ansichten angeben.For clients that cannot display the attachment in its original form, you can specify alternate views by using the MailMessage.AlternateViews property.

In .NET Framework können Sie die Anwendungs-oder Computer Konfigurationsdateien verwenden, um die Standardwerte für Host, Port und Anmelde SmtpClient Informationen für alle Objekte anzugeben.In .NET Framework, you can use the application or machine configuration files to specify default host, port, and credentials values for all SmtpClient objects. Weitere Informationen finden Sie unter <MailSettings> -Element (Netzwerkeinstellungen).For more information, see <mailSettings> Element (Network Settings). .Net Core unterstützt das Festlegen von Standardwerten nicht..NET Core does not support setting defaults. Um dieses Problem zu umgehen, müssen Sie die relevanten Eigenschaften SmtpClient direkt auf festlegen.As a workaround, you must set the relevant properties on SmtpClient directly.

Um die e-Mail-Nachricht und den Block zu senden, während Sie darauf warten, dass die e-Mail an den SMTP- Send Server gesendet wird, verwenden Sie eine der synchronen MethodenTo send the email message and block while waiting for the email to be transmitted to the SMTP server, use one of the synchronous Send methods. Verwenden Sie eine der asynchronen SendAsync Methoden, damit der Haupt Thread des Programms weiterhin ausgeführt werden kann, während die e-Mail übertragen wird.To allow your program's main thread to continue executing while the email is transmitted, use one of the asynchronous SendAsync methods. Das SendCompleted -Ereignis wird ausgelöst, SendAsync wenn ein-Vorgang abgeschlossen wird.The SendCompleted event is raised when a SendAsync operation completes. Um dieses Ereignis zu empfangen, müssen Sie einen SendCompletedEventHandler SendCompletedDelegaten hinzufügen.To receive this event, you must add a SendCompletedEventHandler delegate to SendCompleted. Der SendCompletedEventHandler Delegat muss auf eine Rückruf Methode verweisen, die SendCompleted die Benachrichtigung von Ereignissen behandelt.The SendCompletedEventHandler delegate must reference a callback method that handles notification of SendCompleted events. Verwenden Sie die SendAsyncCancel Methode, um eine asynchrone e-Mail-Übertragung abzubrechen.To cancel an asynchronous email transmission, use the SendAsyncCancel method.

Hinweis

Wenn eine e-Mail-Übertragung durchgeführt wird SendAsync und Send Sie oder wieder anrufen, erhalten InvalidOperationExceptionSie eine.If there is an email transmission in progress and you call SendAsync or Send again, you will receive an InvalidOperationException.

Die Verbindung, die von der aktuellen Instanz der SmtpClient -Klasse zum SMTP-Server hergestellt wird, wird möglicherweise wieder verwendet, wenn eine Anwendung mehrere Nachrichten an denselben SMTP-Server senden möchte.The connection established by the current instance of the SmtpClient class to the SMTP server may be re-used if an application wishes to send multiple messages to the same SMTP server. Dies ist besonders nützlich, wenn Authentifizierung oder Verschlüsselung verwendet wird, um eine Verbindung mit dem SMTP-Server herzustellen.This is particularly useful when authentication or encryption are used establish a connection to the SMTP server. Der Prozess der Authentifizierung und Einrichtung einer TLS-Sitzung kann sehr aufwändig sein.The process of authenticating and establishing a TLS session can be expensive operations. Eine Anforderung zur erneuten Einrichtung einer Verbindung für jede Nachricht, wenn eine große Menge an e-Mail an denselben SMTP-Server gesendet wird, kann sich erheblich auf die Leistung auswirken.A requirement to re-establish a connection for each message when sending a large quantity of email to the same SMTP server could have a significant impact on performance. Es gibt eine Reihe von e-Mail-Anwendungen, die e-Mail-Statusaktualisierungen, Newsletter-Distributionen oder e-Mail-Benachrichtigungen senden.There are a number of high-volume email applications that send email status updates, newsletter distributions, or email alerts. Außerdem unterstützen viele e-Mail-Client Anwendungen einen Offline Modus, in dem Benutzer viele e-Mail-Nachrichten verfassen können, die später gesendet werden, wenn eine Verbindung mit dem SMTP-Server hergestellt wird.Also many email client applications support an off-line mode where users can compose many email messages that are sent later when a connection to the SMTP server is established. Es ist typisch für einen e-Mail-Client, alle SMTP-Nachrichten an einen bestimmten SMTP-Server (bereitgestellt vom Internet Dienstanbieter) zu senden, der diese e-Mail an andere SMTP-Server weiterleitet.It is typical for an email client to send all SMTP messages to a specific SMTP server (provided by the Internet service provider) that then forwards this email to other SMTP servers.

Die SmtpClient Klassen Implementierung bündelt SMTP-Verbindungen, damit der Aufwand für das erneute Herstellen einer Verbindung für jede Nachricht an denselben Server vermieden werden kann.The SmtpClient class implementation pools SMTP connections so that it can avoid the overhead of re-establishing a connection for every message to the same server. Eine Anwendung kann dasselbe SmtpClient Objekt wieder verwenden, um viele verschiedene e-Mails an denselben SMTP-Server und an viele verschiedene SMTP-Server zu senden.An application may re-use the same SmtpClient object to send many different emails to the same SMTP server and to many different SMTP servers. Folglich gibt es keine Möglichkeit, zu bestimmen, wann eine Anwendung mit der Verwendung des SmtpClient -Objekts fertig ist, und Sie sollte bereinigt werden.As a result, there is no way to determine when an application is finished using the SmtpClient object and it should be cleaned up.

Wenn eine SMTP-Sitzung abgeschlossen ist und der Client die Verbindung beenden möchte, muss Sie eine Beendigungs Nachricht an den Server senden, um anzugeben, dass keine Nachrichten mehr gesendet werden müssen.When an SMTP session is finished and the client wishes to terminate the connection, it must send a QUIT message to the server to indicate that it has no more messages to send. Dies ermöglicht es dem Server, Ressourcen freizugeben, die der Verbindung vom Client zugeordnet sind, und die vom Client gesendeten Nachrichten zu verarbeiten.This allows the server to free up resources associated with the connection from the client and process the messages which were sent by the client.

Die SmtpClient -Klasse verfügt Finalize über keine-Methode, sodass eine Dispose Anwendung aufgerufen werden muss, um Ressourcen explizit freizugeben.The SmtpClient class has no Finalize method, so an application must call Dispose to explicitly free up resources. Die Dispose -Methode durchläuft alle eingerichteten Verbindungen mit dem in der Host -Eigenschaft angegebenen SMTP-Server und sendet eine beendende Nachricht, gefolgt vom ordnungsgemäßen Beenden der TCP-Verbindung.The Dispose method iterates through all established connections to the SMTP server specified in the Host property and sends a QUIT message followed by gracefully ending the TCP connection. Die Dispose Methode auch frei, die vom verwendeten nicht verwalteten Ressourcen der Socket und verwirft optional auch die verwalteten Ressourcen.The Dispose method also releases the unmanaged resources used by the Socket and optionally disposes of the managed resources.

Rufen Sie Dispose auf, wenn Sie SmtpClient nicht mehr benötigen.Call Dispose when you are finished using the SmtpClient. Die Dispose-Methode bewirkt, dass SmtpClient nicht mehr verwendet werden kann.The Dispose method leaves the SmtpClient in an unusable state. Nach dem DisposeAufrufen von müssen Sie alle Verweise auf den SmtpClient freigeben, damit der Garbage Collector den Speicher freigeben kann SmtpClient , den der belegt hat.After calling Dispose, you must release all references to the SmtpClient so the garbage collector can reclaim the memory that the SmtpClient was occupying.

Konstruktoren

SmtpClient() SmtpClient() SmtpClient() SmtpClient()

Initialisiert eine neue Instanz der SmtpClient-Klasse mit den Einstellungen der Konfigurationsdatei.Initializes a new instance of the SmtpClient class by using configuration file settings.

SmtpClient(String) SmtpClient(String) SmtpClient(String) SmtpClient(String)

Initialisiert eine neue Instanz der SmtpClient-Klasse, die E-Mails mithilfe des angegebenen SMTP-Servers sendet.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server.

SmtpClient(String, Int32) SmtpClient(String, Int32) SmtpClient(String, Int32) SmtpClient(String, Int32)

Initialisiert eine neue Instanz der SmtpClient-Klasse, die E-Mails mithilfe des angegebenen SMTP-Servers und -Ports sendet.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server and port.

Eigenschaften

ClientCertificates ClientCertificates ClientCertificates ClientCertificates

Gibt an, welche Zertifikate zum Herstellen der SSL (Secure Sockets Layer)-Verbindung verwendet werden sollen.Specify which certificates should be used to establish the Secure Sockets Layer (SSL) connection.

Credentials Credentials Credentials Credentials

Ruft die Anmeldeinformationen zum Authentifizieren des Absenders ab oder legt diese fest.Gets or sets the credentials used to authenticate the sender.

DeliveryFormat DeliveryFormat DeliveryFormat DeliveryFormat

Ruft das Übermittlungsformat ab, das von SmtpClient verwendet wird, um E-Mails zu senden, oder legt es fest.Gets or sets the delivery format used by SmtpClient to send email.

DeliveryMethod DeliveryMethod DeliveryMethod DeliveryMethod

Gibt an, wie ausgehende E-Mail-Nachrichten behandelt werden.Specifies how outgoing email messages will be handled.

EnableSsl EnableSsl EnableSsl EnableSsl

Geben Sie an, ob der SmtpClient die Verbindung mit SSL (Secure Sockets Layer) verschlüsselt.Specify whether the SmtpClient uses Secure Sockets Layer (SSL) to encrypt the connection.

Host Host Host Host

Ruft den Namen oder die IP-Adresse des Hosts ab, der bzw. die für SMTP-Transaktionen verwendet wird, oder legt diese Informationen fest.Gets or sets the name or IP address of the host used for SMTP transactions.

PickupDirectoryLocation PickupDirectoryLocation PickupDirectoryLocation PickupDirectoryLocation

Ruft den Ordner ab, in dem Anwendungen vom lokalen SMTP-Server zu verarbeitende E-Mail-Nachrichten speichern, oder legt diesen fest.Gets or sets the folder where applications save mail messages to be processed by the local SMTP server.

Port Port Port Port

Ruft den für SMTP-Transaktionen verwendeten Anschluss ab oder legt diesen fest.Gets or sets the port used for SMTP transactions.

ServicePoint ServicePoint ServicePoint ServicePoint

Ruft die Netzwerkverbindung ab, die zum Übertragen der E-Mail verwendet wurde.Gets the network connection used to transmit the email message.

TargetName TargetName TargetName TargetName

Ruft den Dienstanbieternamen (SPN) ab, der bei Verwendung des erweiterten Schutzes zur Authentifizierung verwendet werden soll, oder legt ihn fest.Gets or sets the Service Provider Name (SPN) to use for authentication when using extended protection.

Timeout Timeout Timeout Timeout

Ruft einen Wert ab, der die Zeitspanne bis zum Timeout eines synchronen Send-Aufrufs angibt, oder legt diesen fest.Gets or sets a value that specifies the amount of time after which a synchronous Send call times out.

UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Methoden

Dispose() Dispose() Dispose() Dispose()

Sendet eine QUIT-Meldung an den SMTP-Server, beendet die TCP-Verbindung ordnungsgemäß und gibt alle Ressourcen frei, die von der aktuellen Instanz der SmtpClient-Klasse verwendet werden.Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, and releases all resources used by the current instance of the SmtpClient class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Sendet eine QUIT-Meldung an den SMTP-Server, beendet die TCP-Verbindung ordnungsgemäß, gibt alle Ressourcen frei, die von der aktuellen Instanz der SmtpClient-Klasse verwendet werden, und gibt optional die verwalteten Ressourcen frei.Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, releases all resources used by the current instance of the SmtpClient class, and optionally disposes of the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnSendCompleted(AsyncCompletedEventArgs) OnSendCompleted(AsyncCompletedEventArgs) OnSendCompleted(AsyncCompletedEventArgs) OnSendCompleted(AsyncCompletedEventArgs)

Löst das SendCompleted-Ereignis aus.Raises the SendCompleted event.

Send(MailMessage) Send(MailMessage) Send(MailMessage) Send(MailMessage)

Sendet die angegebene Nachricht an einen SMTP-Server für die Übermittlung.Sends the specified message to an SMTP server for delivery.

Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String) Send(String, String, String, String)

Sendet die angegebene E-Mail für die Übermittlung an einen SMTP-Server.Sends the specified email message to an SMTP server for delivery. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.The message sender, recipients, subject, and message body are specified using String objects.

SendAsync(MailMessage, Object) SendAsync(MailMessage, Object) SendAsync(MailMessage, Object) SendAsync(MailMessage, Object)

Sendet die angegebene E-Mail für die Übermittlung an einen SMTP-Server.Sends the specified email message to an SMTP server for delivery. Diese Methode blockiert den aufrufenden Thread nicht und ermöglicht dem Aufrufer die Übergabe eines Objekts an die Methode, die beim Abschluss des Vorgangs aufgerufen wird.This method does not block the calling thread and allows the caller to pass an object to the method that is invoked when the operation completes.

SendAsync(String, String, String, String, Object) SendAsync(String, String, String, String, Object) SendAsync(String, String, String, String, Object) SendAsync(String, String, String, String, Object)

Sendet eine E-Mail für die Übermittlung an einen SMTP-Server.Sends an email message to an SMTP server for delivery. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.The message sender, recipients, subject, and message body are specified using String objects. Diese Methode blockiert den aufrufenden Thread nicht und ermöglicht dem Aufrufer die Übergabe eines Objekts an die Methode, die beim Abschluss des Vorgangs aufgerufen wird.This method does not block the calling thread and allows the caller to pass an object to the method that is invoked when the operation completes.

SendAsyncCancel() SendAsyncCancel() SendAsyncCancel() SendAsyncCancel()

Bricht einen asynchronen Vorgang zum Senden einer E-Mail ab.Cancels an asynchronous operation to send an email message.

SendMailAsync(MailMessage) SendMailAsync(MailMessage) SendMailAsync(MailMessage) SendMailAsync(MailMessage)

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.Sends the specified message to an SMTP server for delivery as an asynchronous operation.

SendMailAsync(String, String, String, String) SendMailAsync(String, String, String, String) SendMailAsync(String, String, String, String) SendMailAsync(String, String, String, String)

Sendet die angegebene Meldung an einen SMTP-Server für die Übermittlung als asynchroner Vorgang.Sends the specified message to an SMTP server for delivery as an asynchronous operation. sein.. Der Absender, die Empfänger, der Betreff und der Text der Nachricht werden mit String-Objekten angegeben.The message sender, recipients, subject, and message body are specified using String objects.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

SendCompleted SendCompleted SendCompleted SendCompleted

Tritt ein, wenn das asynchrone Senden einer E-Mail abgeschlossen wurde.Occurs when an asynchronous email send operation completes.

Gilt für:

Siehe auch