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