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)

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

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 クラスの新しいインスタンスを初期化します。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).

注釈

このコンストラクターは、アプリケーションまたはコンピューターの構成ファイルの設定を使用して、新しい SmtpClientHostCredentials、および Port の各プロパティを初期化します。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).

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

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. hostString.Emptynull か等しい場合は、アプリケーションまたはコンピューターの構成ファイルの設定を使用して Host が初期化されます。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.

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

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

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

注釈

host パラメーターと port パラメーターによって、HostPort プロパティの値がそれぞれ設定されます。The host and port parameters set the value of the Host and Port properties, respectively. hostString.Emptynull か等しい場合は、アプリケーションまたはコンピューターの構成ファイルの設定を使用して 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.

アプリケーションとコンピューターの構成ファイルの使用方法の詳細については、「 <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.

適用対象