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

Определение

Инициализирует новый экземпляр класса SmtpClient.Initializes a new instance of the SmtpClient class.

Перегрузки

SmtpClient()

Инициализирует новый экземпляр класса SmtpClient, используя параметры файла конфигурации.Initializes a new instance of the SmtpClient class by using configuration file settings.

SmtpClient(String)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server.

SmtpClient(String, Int32)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP и порта.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server and port.

SmtpClient()

Инициализирует новый экземпляр класса SmtpClient, используя параметры файла конфигурации.Initializes a new instance of the SmtpClient class by using configuration file settings.

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

Примеры

В следующем примере кода демонстрируется отправка сообщения электронной почты.The following code example demonstrates sending an email message.

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

Пример узла <Маилсеттингс > в файле конфигурации приложения или компьютера см. в разделе <маилсеттингс> (параметры сети).For an example of the <mailSettings> node in the application or machine configuration file, see <mailSettings> Element (Network Settings).

Комментарии

Этот конструктор инициализирует свойства Host, Credentialsи Port для нового SmtpClient с помощью параметров в файлах конфигурации приложения или компьютера.This constructor initializes the Host, Credentials, and Port properties for the new SmtpClient by using the settings in the application or machine configuration files. Дополнительные сведения см. в разделе <маилсеттингс> Element (параметры сети).For more information, see <mailSettings> Element (Network Settings).

Безопасность

SmtpPermission
для создания SmtpClient.to construct an SmtpClient. Связанное перечисление: Connect.Associated enumeration: Connect.

SmtpClient(String)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server.

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-транзакций.A String that contains the name or IP address of the host computer used for SMTP transactions.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.The following code example demonstrates calling this constructor.

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.The host parameter is used to initialize the value of the Host property. Свойства Credentials и Port инициализируются с помощью параметров в файлах конфигурации приложения или компьютера.The Credentials and Port properties are initialized by using the settings in the application or machine configuration files. Если host имеет null или равно String.Empty, Host инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.If host is null or equal to String.Empty, Host is initialized using the settings in the application or machine configuration files.

Дополнительные сведения об использовании файлов конфигурации приложений и компьютеров см. в разделе <маилсеттингс> Element (параметры сети).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Если сведения указываются с помощью SmtpClient конструкторы или свойства, эти сведения переопределяют параметры файла конфигурации.If information is specified using SmtpClient constructors or properties, this information overrides the configuration file settings.

Безопасность

SmtpPermission
для создания SmtpClient.to construct an SmtpClient. Связанное перечисление: Connect.Associated enumeration: Connect.

SmtpClient(String, Int32)

Инициализирует новый экземпляр класса SmtpClient, который отправляет электронную почту с помощью указанного сервера SMTP и порта.Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server and port.

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-транзакций.A String that contains the name or IP address of the host used for SMTP transactions.

port
Int32

Значение Int32, большее нуля, которое задает порт, используемый на хосте host.An Int32 greater than zero that contains the port to be used on host.

Исключения

Параметр port не может иметь значение меньше нуля.port cannot be less than zero.

Примеры

В следующем примере кода демонстрируется вызов этого конструктора.The following code example demonstrates calling this constructor.

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;
   
   //Display the properties on the service point.
   ServicePoint^ p = client->ServicePoint;
   Console::WriteLine( L"Connection lease timeout: {0}", p->ConnectionLeaseTimeout );
   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 соответственно.The host and port parameters set the value of the Host and Port properties, respectively. Если host имеет null или равно String.Empty, Host инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.If host is null or equal to String.Empty, Host is initialized using the settings in the application or machine configuration files. Если port равен нулю, Port инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.If port is zero, Port is initialized using the settings in the application or machine configuration files. Свойство Credentials инициализируется с помощью параметров в файлах конфигурации приложения или компьютера.The Credentials property is initialized using the settings in the application or machine configuration files.

Дополнительные сведения об использовании файлов конфигурации приложений и компьютеров см. в разделе <маилсеттингс> Element (параметры сети).For more information about using the application and machine configuration files, see <mailSettings> Element (Network Settings). Если сведения указываются с помощью SmtpClient конструкторы или свойства, эти сведения переопределяют параметры файла конфигурации.If information is specified using SmtpClient constructors or properties, this information overrides the configuration file settings.

Безопасность

SmtpPermission
для указания порта.to specify the port. Связанное перечисление: ConnectToUnrestrictedPort.Associated enumeration: ConnectToUnrestrictedPort.

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