SmtpClient Konstruktoren

  • Referenz

Definition

Namespace:
System.Net.Mail
Assembly:
System.Net.Mail.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Initialisiert eine neue Instanz der SmtpClient-Klasse.

Überlädt

SmtpClient()

Initialisiert eine neue Instanz der SmtpClient-Klasse mit den Einstellungen der Konfigurationsdatei.
SmtpClient(String)

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

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

SmtpClient()

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

Initialisiert eine neue Instanz der SmtpClient-Klasse mit den Einstellungen der Konfigurationsdatei.

public:
 SmtpClient();
public SmtpClient ();
Public Sub New ()

Beispiele

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

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"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 = gcnew SmtpClient;
   Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
   client->Send( message );
}

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 <Knoten mailSettings in der Anwendungs- oder Computerkonfigurationsdatei> finden Sie unter <mailSettings-Element> (Netzwerkeinstellungen).

Hinweise

Dieser Konstruktor initialisiert die HostEigenschaften , Credentialsund Port für die neue SmtpClient mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien. Weitere Informationen finden Sie unter <mailSettings-Element> (Netzwerkeinstellungen).

Gilt für:

SmtpClient(String)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

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

public:
 SmtpClient(System::String ^ host);
public SmtpClient (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

Ein String, der den Namen oder die IP-Adresse des für SMTP-Transaktionen verwendeten Hostcomputers enthält.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"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 );
}

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 werden mithilfe der Einstellungen in den Konfigurationsdateien der Anwendung oder des Computers initialisiert. Wenn host oder gleich istnull, String.EmptyHost wird mithilfe der Einstellungen in den Anwendungs- oder Computerkonfigurationsdateien initialisiert.

Weitere Informationen zur Verwendung der Anwendungs- und Computerkonfigurationsdateien finden Sie unter <mailSettings-Element> (Netzwerkeinstellungen). Wenn Informationen mithilfe von SmtpClient Konstruktoren oder Eigenschaften angegeben werden, setzen diese Informationen die Konfigurationsdateieinstellungen außer Kraft.

Gilt für:

SmtpClient(String, Int32)

Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs
Quelle:
SmtpClient.cs

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

public:
 SmtpClient(System::String ^ host, int port);
public SmtpClient (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

Ein String, der den Namen oder die IP-Adresse des für SMTP-Transaktionen verwendeten Hosts enthält.

port
Int32

Ein Int32 größer als 0 (null), das den für host zu verwendenden Anschluss enthält.

Ausnahmen

ArgumentOutOfRangeException

port darf nicht kleiner 0 (Null) sein.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew 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 );
   client->~SmtpClient();
}

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 legen den Wert der -Eigenschaft bzwPort. -HostEigenschaft fest. Wenn host oder gleich istnull, String.EmptyHost 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). Wenn Informationen mithilfe von SmtpClient Konstruktoren oder Eigenschaften angegeben werden, setzen diese Informationen die Konfigurationsdateieinstellungen außer Kraft.

Gilt für: