SmtpClient.Host プロパティ

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

SmtpClient.Host プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SMTP トランザクションで使用されるホストの名前または IP アドレスを取得または設定します。

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

Visual Basic (宣言)

Public Property Host As
 String

Visual Basic (使用法)

Dim instance As SmtpClient
Dim value As String

value = instance.Host

instance.Host = value

C#

public string Host { get;
 set; }

C++

public:
property String^ Host {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Host ()

/** @property */
public void set_Host (String value)

JScript

public function get Host
 () : String

public function set Host
 (value : String)

プロパティ値
SMTP トランザクションで使用するコンピュータの名前または IP アドレスを格納している String。

例外

例外の種類	条件
ArgumentNullException	設定操作として指定した値が null 参照 (Visual Basic では Nothing) です。
ArgumentException	設定操作として指定した値が String.Empty ("") です。
InvalidOperationException	電子メールが送信中の場合、このプロパティの値は変更できません。

解説

Host プロパティの値は、コンストラクタを使用するか、アプリケーションまたはコンピュータの構成ファイルを使用して設定することもできます。詳細については、「mailSettings 要素 (ネットワーク設定)」を参照してください。

このプロパティを使用して情報が指定された場合、この情報によって構成ファイルの設定がオーバーライドされます。

使用例

アプリケーションの構成ファイルで指定されたホストとポートを使用して、電子メール メッセージを送信するコード例を次に示します。

C#

public static void CreateTestMessage4(string
 server)
{
    MailAddress from = new MailAddress("ben@contoso.com");
    MailAddress to = new MailAddress("Jane@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an
 e-mail message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Sending an e-mail message to {0} by using
 SMTP host {1} port {2}.",
         to.ToString(), client.Host, client.Port);
    client.Send(message);
}

プラットフォーム

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 名前空間
Port