SmtpClient SmtpClient SmtpClient SmtpClient Constructors

定義

オーバーロード

SmtpClient() SmtpClient() SmtpClient()

構成ファイルの設定を使用して SmtpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the SmtpClient class by using configuration file settings.

SmtpClient(String) SmtpClient(String) SmtpClient(String) SmtpClient(String)

指定した SMTP サーバーを使用して電子メールを送信する SmtpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server.

SmtpClient(String, Int32) SmtpClient(String, Int32) SmtpClient(String, Int32) SmtpClient(String, Int32)

指定した SMTP サーバーとポートを使用して電子メールを送信する SmtpClient クラスのインスタンスを初期化します。Initializes a new instance of the SmtpClient class that sends email by using the specified SMTP server and port.

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

例については、 <mailSettings > アプリケーションまたはマシン構成ファイル内のノードを参照してください <mailSettings>要素 (ネットワーク設定)します。For an example of the <mailSettings> node in the application or machine configuration file, see <mailSettings> Element (Network Settings).

注釈

このコンス トラクターを初期化します、 HostCredentialsPort新しいプロパティ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. 詳細については、次を参照してください。 <mailSettings>要素 (ネットワーク設定)します。For more information, see <mailSettings> Element (Network Settings).

セキュリティ

SmtpPermission
構築する、SmtpClientします。to construct an SmtpClient. Connect (関連する列挙体)Associated enumeration: Connect.

SmtpClient(String) SmtpClient(String) SmtpClient(String) SmtpClient(String)

指定した SMTP サーバーを使用して電子メールを送信する SmtpClient クラスの新しいインスタンスを初期化します。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 String String

SMTP トランザクションで使用されるホスト コンピューターの名前または IP アドレスを格納している StringA 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. CredentialsPortプロパティは、アプリケーションまたはマシン構成ファイルで設定を使用して初期化されます。The Credentials and Port properties are initialized by using the settings in the application or machine configuration files. 場合hostnull以上String.EmptyHostアプリケーションまたはマシン構成ファイルで設定を使用して初期化されます。If host is null or equal to String.Empty, Host is initialized using the settings in the application or machine configuration files.

詳細については、アプリケーションとマシンの構成ファイルを使用して、次を参照してください。 <mailSettings>要素 (ネットワーク設定)します。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(String, Int32) SmtpClient(String, Int32) SmtpClient(String, Int32)

指定した SMTP サーバーとポートを使用して電子メールを送信する SmtpClient クラスのインスタンスを初期化します。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 String String

SMTP トランザクションで使用されるホストの名前または IP アドレスを格納している StringA String that contains the name or IP address of the host used for SMTP transactions.

port
Int32 Int32 Int32 Int32

host 上で使用されるポートを格納している 1 以上の Int32An Int32 greater than zero that contains the port to be used on host.

例外

port は 0 未満には設定できません。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);
}

注釈

hostportパラメーターの値の設定、HostPortプロパティでは、それぞれします。The host and port parameters set the value of the Host and Port properties, respectively. 場合hostnull以上String.EmptyHostアプリケーションまたはマシン構成ファイルで設定を使用して初期化されます。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.

詳細については、アプリケーションとマシンの構成ファイルを使用して、次を参照してください。 <mailSettings>要素 (ネットワーク設定)します。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.

適用対象