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


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

Определение

Инициализирует новый экземпляр класса 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"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);
}

Пример узла 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"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);
}

Комментарии

Параметр 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.

Исключения

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

Примеры

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

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

Комментарии

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

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

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