SmtpClient コンストラクタ ()

.NET Framework クラス ライブラリ リファレンス

SmtpClient コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

構成ファイルの設定を使用して SmtpClient クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SmtpClient

C#

public SmtpClient ()

C++

public:
SmtpClient ()

J#

public SmtpClient ()

JScript

public function SmtpClient ()

解説

このコンストラクタは、アプリケーションまたはコンピュータの構成ファイルの設定を使用して、新しい SmtpClient に対する Host、Credentials、および Port の各プロパティを初期化します。詳細については、「mailSettings 要素 (ネットワーク設定)」を参照してください。

使用例

電子メール メッセージを送信するコード例を次に示します。

C#

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 e-mail 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 e-mail message to {0} at {1} by using
 the SMTP host {2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

アプリケーションまたはコンピュータの構成ファイルの <mailSettings> ノードの例については、「mailSettings 要素 (ネットワーク設定)」を参照してください。

.NET Framework のセキュリティ

• SmtpPermission  (SmtpClient を構築するために必要なアクセス許可)。SmtpAccess.Connect (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間

SmtpClient コンストラクタ (String, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    host As String, _
    port As Integer _
)

Visual Basic (使用法)

Dim host As String
Dim port As Integer

Dim instance As New SmtpClient(host,
 port)

C#

public SmtpClient (
    string host,
    int port
)

C++

public:
SmtpClient (
    String^ host, 
    int port
)

J#

public SmtpClient (
    String host, 
    int port
)

JScript

public function SmtpClient (
    host : String, 
    port : int
)

パラメータ

host

SMTP トランザクションで使用されるホストの名前または IP アドレスを格納している String。

port

host 上で使用されるポートを格納している 1 以上の Int32。

例外

例外の種類	条件
ArgumentOutOfRangeException	port は 0 未満には設定できません。

解説

host パラメータは Host プロパティの値を設定し、port パラメータは Port プロパティの値を設定します。host が null 参照 (Visual Basic では Nothing) か、String.Empty と等しい場合、Host は、アプリケーションまたはコンピュータの構成ファイルの設定を使用して初期化されます。port が 0 の場合、Port は、アプリケーションまたはコンピュータの構成ファイルの設定を使用して初期化されます。Credentials プロパティは、アプリケーションまたはコンピュータの構成ファイルの設定を使用して初期化されます。

アプリケーションの構成ファイルおよびコンピュータの構成ファイルの使用方法の詳細については、「mailSettings 要素 (ネットワーク設定)」を参照してください。SmtpClient のコンストラクタまたはプロパティを使用して情報が指定されている場合、この情報によって構成ファイルの設定がオーバーライドされます。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

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 e-mail 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 e-mail on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    client.Send(message);
}

.NET Framework のセキュリティ

• SmtpPermission  (ポートを指定するために必要なアクセス許可)。SmtpAccess.ConnectToUnrestrictedPort (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間

SmtpClient コンストラクタ (String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定した SMTP サーバーを使用して電子メールを送信する SmtpClient クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    host As String _
)

Visual Basic (使用法)

Dim host As String

Dim instance As New SmtpClient(host)

C#

public SmtpClient (
    string host
)

C++

public:
SmtpClient (
    String^ host
)

J#

public SmtpClient (
    String host
)

JScript

public function SmtpClient (
    host : String
)

パラメータ

host

SMTP トランザクションで使用されるホスト コンピュータの名前または IP アドレスを格納している String。

解説

host パラメータは、Host プロパティの値の初期化に使用されます。Credentials プロパティと Port プロパティは、アプリケーションまたはコンピュータの構成ファイルの設定を使用して初期化されます。host が null 参照 (Visual Basic では Nothing) か、String.Empty と等しい場合、Host は、アプリケーションまたはコンピュータの構成ファイルの設定を使用して初期化されます。

アプリケーションの構成ファイルおよびコンピュータの構成ファイルの使用方法の詳細については、「mailSettings 要素 (ネットワーク設定)」を参照してください。SmtpClient のコンストラクタまたはプロパティを使用して情報が指定されている場合、この情報によって構成ファイルの設定がオーバーライドされます。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

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 e-mail 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 e-mail on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

.NET Framework のセキュリティ

• SmtpPermission  (SmtpClient を構築するために必要なアクセス許可)。SmtpAccess.Connect (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間

SmtpClient コンストラクタ

SmtpClient クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
SmtpClient ()	構成ファイルの設定を使用して SmtpClient クラスの新しいインスタンスを初期化します。
SmtpClient (String)	指定した SMTP サーバーを使用して電子メールを送信する SmtpClient クラスの新しいインスタンスを初期化します。
SmtpClient (String, Int32)	指定した SMTP サーバーとポートを使用して電子メールを送信する SmtpClient クラスのインスタンスを初期化します。

参照

関連項目

SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間