SmtpClient Konstruktoren

Definition

Namespace:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Initialisiert eine neue Instanz der SmtpClient-Klasse.

Überlädt

Name	Beschreibung
SmtpClient()	Initialisiert eine neue Instanz der SmtpClient Klasse mithilfe von Konfigurationsdateieinstellungen.
SmtpClient(String)	Initialisiert eine neue Instanz der Klasse, die SmtpClient E-Mails mithilfe des angegebenen SMTP-Servers sendet.
SmtpClient(String, Int32)	Initialisiert eine neue Instanz der Klasse, die SmtpClient E-Mails mithilfe des angegebenen SMTP-Servers und -Ports sendet.

SmtpClient()

Quelle:

SmtpClient.cs

Initialisiert eine neue Instanz der SmtpClient Klasse mithilfe von Konfigurationsdateieinstellungen.

public:
 SmtpClient();

public SmtpClient();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird das Senden einer E-Mail-Nachricht veranschaulicht.

public static void CreateTestMessage3()
{
    MailAddress to = new MailAddress("jane@contoso.com");
    MailAddress from = new MailAddress("ben@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    // Use the application or machine configuration to get the
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

Ein Beispiel für den <mailSettings-Knoten in der Anwendungs- oder Computerkonfigurationsdatei> finden Sie unter <mailSettings> Element (Netzwerkeinstellungen).

Hinweise

Dieser Konstruktor initialisiert die Host, Credentialsund Port die Eigenschaften für das Neue SmtpClient mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien. Weitere Informationen finden Sie unter mailSettings Element (Netzwerkeinstellungen).For more information, see< mailSettings> Element (Network Settings).

SmtpClient(String)

Quelle:

SmtpClient.cs

Initialisiert eine neue Instanz der Klasse, die SmtpClient E-Mails mithilfe des angegebenen SMTP-Servers sendet.

public:
 SmtpClient(System::String ^ host);

public SmtpClient(string? host);

new System.Net.Mail.SmtpClient : string -> System.Net.Mail.SmtpClient

Public Sub New (host As String)

Parameter

host

String

A String , das den Namen oder die IP-Adresse des Hostcomputers enthält, der für SMTP-Transaktionen verwendet wird.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

public static void CreateTimeoutTestMessage(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Hinweise

Der host Parameter wird verwendet, um den Wert der Host Eigenschaft zu initialisieren. Die Credentials Eigenschaften und Port Eigenschaften werden mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert. Ist host dies null gleich String.Empty, Host wird mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert.

Weitere Informationen zur Verwendung der Anwendungs- und Computerkonfigurationsdateien finden Sie unter mailSettings-Element (Netzwerkeinstellungen).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Wenn Informationen mithilfe von SmtpClient Konstruktoren oder Eigenschaften angegeben werden, überschreibt diese Informationen die Konfigurationsdateieinstellungen.

SmtpClient(String, Int32)

Quelle:

SmtpClient.cs

Initialisiert eine neue Instanz der Klasse, die SmtpClient E-Mails mithilfe des angegebenen SMTP-Servers und -Ports sendet.

public:
 SmtpClient(System::String ^ host, int port);

public SmtpClient(string? host, int port);

new System.Net.Mail.SmtpClient : string * int -> System.Net.Mail.SmtpClient

Public Sub New (host As String, port As Integer)

Parameter

host

String

A String that contains the name or IP address of the host used for SMTP transactions.

port

Int32

Ein Int32 Wert größer als 0, der den zu verwendenden hostPort enthält.

Ausnahmen

ArgumentOutOfRangeException

port darf nicht kleiner 0 (Null) sein.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Hinweise

Die host Parameter und port die Werte legen den Wert der Host jeweiligen Eigenschaften fest Port . Ist host dies null gleich String.Empty, Host wird mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert. Wenn port null ist, Port wird mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert. Die Credentials Eigenschaft wird mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert.

Weitere Informationen zur Verwendung der Anwendungs- und Computerkonfigurationsdateien finden Sie unter mailSettings-Element (Netzwerkeinstellungen).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Wenn Informationen mithilfe von SmtpClient Konstruktoren oder Eigenschaften angegeben werden, überschreibt diese Informationen die Konfigurationsdateieinstellungen.