SmtpClient Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Mail

Zestaw:

System.Net.Mail.dll

Inicjuje nowe wystąpienie klasy SmtpClient.

Przeciążenia

SmtpClient()	Inicjuje SmtpClient nowe wystąpienie klasy przy użyciu ustawień pliku konfiguracji.
SmtpClient(String)	Inicjuje SmtpClient nowe wystąpienie klasy, która wysyła wiadomość e-mail przy użyciu określonego serwera SMTP.
SmtpClient(String, Int32)	Inicjuje SmtpClient nowe wystąpienie klasy, która wysyła wiadomość e-mail przy użyciu określonego serwera SMTP i portu.

SmtpClient()

Źródło:

SmtpClient.cs

Inicjuje SmtpClient nowe wystąpienie klasy przy użyciu ustawień pliku konfiguracji.

public:
 SmtpClient();

public SmtpClient ();

Public Sub New ()

Przykłady

Poniższy przykład kodu pokazuje wysyłanie wiadomości e-mail.

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);
}

Aby zapoznać się z <przykładem węzła mailSettings> w pliku konfiguracji aplikacji lub maszyny, zobacz <mailSettings> , element (ustawienia sieci).

Uwagi

Ten konstruktor inicjuje Hostwłaściwości , Credentialsi Port dla nowego SmtpClient przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny. Aby uzyskać więcej informacji, zobacz <mailSettings> , element (ustawienia sieci).

SmtpClient(String)

Źródło:

SmtpClient.cs

Inicjuje SmtpClient nowe wystąpienie klasy, która wysyła wiadomość e-mail przy użyciu określonego serwera SMTP.

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)

Parametry

host

String

Element String zawierający nazwę lub adres IP komputera hosta używanego do transakcji SMTP.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie tego konstruktora.

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);
}

Uwagi

Parametr host służy do inicjowania wartości Host właściwości. Właściwości Credentials i Port są inicjowane przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny. Jeśli host parametr jest null lub równy String.Empty, Host jest inicjowany przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny.

Aby uzyskać więcej informacji na temat używania plików konfiguracji aplikacji i maszyny, zobacz <mailSettings> , element (ustawienia sieci). Jeśli informacje są określone przy użyciu SmtpClient konstruktorów lub właściwości, te informacje zastępują ustawienia pliku konfiguracji.

SmtpClient(String, Int32)

Źródło:

SmtpClient.cs

Inicjuje SmtpClient nowe wystąpienie klasy, która wysyła wiadomość e-mail przy użyciu określonego serwera SMTP i portu.

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)

Parametry

host

String

Element String zawierający nazwę lub adres IP hosta używanego do transakcji SMTP.

port

Int32

Wartość Int32 większa niż zero zawierająca port, który ma być używany w systemie host.

Wyjątki

ArgumentOutOfRangeException

port nie może być mniejsza niż zero.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie tego konstruktora.

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);
}

Uwagi

Parametry host i port ustawiają odpowiednio wartość Host właściwości i Port . Jeśli host parametr jest null lub równy String.Empty, Host jest inicjowany przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny. Jeśli port wartość jest równa zero, Port jest inicjowana przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny. Właściwość Credentials jest inicjowana przy użyciu ustawień w plikach konfiguracji aplikacji lub maszyny.

Aby uzyskać więcej informacji na temat używania plików konfiguracji aplikacji i maszyny, zobacz <mailSettings> , element (ustawienia sieci). Jeśli informacje są określone przy użyciu SmtpClient konstruktorów lub właściwości, te informacje zastępują ustawienia pliku konfiguracji.