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

Определение

Пространство имен:

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

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

Перегрузки

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

SmtpClient()

Исходный код:

SmtpClient.cs

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

public:
 SmtpClient();

public SmtpClient();

Public Sub New ()

Примеры

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

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

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

Комментарии

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

SmtpClient(String)

Исходный код:

SmtpClient.cs

Инициализирует новый экземпляр SmtpClient класса, который отправляет электронную почту с помощью указанного 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)

Параметры

host

String

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

Примеры

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

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

Комментарии

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

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

SmtpClient(String, Int32)

Исходный код:

SmtpClient.cs

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

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)

Параметры

host

String

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

port

Int32

Больше Int32 нуля, содержащего порт для использования host.

Исключения

ArgumentOutOfRangeException

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

Примеры

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

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

Комментарии

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

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