Поделиться через

SmtpClient Конструкторы

  • Ссылка

Определение

Пространство имен:
System.Net.Mail
Сборка:
System.Net.Mail.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Инициализирует новый экземпляр класса SmtpClient.

Перегрузки

SmtpClient()

Инициализирует новый экземпляр класса SmtpClient, используя параметры файла конфигурации.
SmtpClient(String)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP.
SmtpClient(String, Int32)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP и порта.

SmtpClient()

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Инициализирует новый экземпляр класса SmtpClient, используя параметры файла конфигурации.

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

Примеры

В следующем примере кода демонстрируется отправка сообщения электронной почты.

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"[email protected]" );
   MailAddress^ from = gcnew MailAddress( L"[email protected]" );
   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("[email protected]");
    MailAddress from = new MailAddress("[email protected]");
    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);
}

Пример узла mailSettings> в файле конфигурации приложения или компьютера см. в разделе <Элемент mailSettings> (параметры сети).<

Комментарии

Этот конструктор инициализирует Hostсвойства , Credentialsи Port для нового SmtpClient с помощью параметров в файлах конфигурации приложения или компьютера. Дополнительные сведения см. в разделе <Элемент mailSettings> (параметры сети).

Применяется к

SmtpClient(String)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP.

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)

Параметры

host
String

Значение String, содержащее имя или IP-адрес компьютера-хоста, используемого для SMTP-транзакций.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"[email protected]";
   String^ from = L"[email protected]";
   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 = "[email protected]";
    string from = "[email protected]";
    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);
}

Комментарии

Параметр host используется для инициализации Host значения свойства . Свойства Credentials и инициализируются Port с помощью параметров в файлах конфигурации приложения или компьютера. Если host значение равно null или равно String.Empty, Host инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.

Дополнительные сведения об использовании файлов конфигурации приложения и компьютера см. в разделе <Элемент mailSettings> (параметры сети). Если сведения указываются с помощью SmtpClient конструкторов или свойств, эти сведения переопределяют параметры файла конфигурации.

Применяется к

SmtpClient(String, Int32)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP и порта.

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)

Параметры

host
String

Значение String, содержащее имя или IP-адрес хоста, используемого для SMTP-транзакций.

port
Int32

Значение Int32, большее нуля, которое задает порт, используемый на хосте host.

Исключения

ArgumentOutOfRangeException

Параметр port не может иметь значение меньше нуля.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"[email protected]";
   String^ from = L"[email protected]";
   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 = "[email protected]";
    string from = "[email protected]";
    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);
}

Комментарии

Параметры host и port задают значение Host свойств и Port соответственно. Если host значение равно null или равно String.Empty, Host инициализируется с помощью параметров в файлах конфигурации приложения или компьютера. Если port равно нулю, Port инициализируется с помощью параметров в файлах конфигурации приложения или компьютера. Свойство Credentials инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.

Дополнительные сведения об использовании файлов конфигурации приложения и компьютера см. в разделе <Элемент mailSettings> (параметры сети). Если сведения указываются с помощью SmtpClient конструкторов или свойств, эти сведения переопределяют параметры файла конфигурации.

Применяется к