SmtpClient.Dispose SmtpClient.Dispose SmtpClient.Dispose SmtpClient.Dispose Method

定義

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, and releases all resources used by the current instance of the SmtpClient class.

オーバーロード

Dispose() Dispose() Dispose() Dispose()

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, and releases all resources used by the current instance of the SmtpClient class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。オプションでマネージド リソースも破棄します。Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, releases all resources used by the current instance of the SmtpClient class, and optionally disposes of the managed resources.

注釈

現在のインスタンスによって確立された接続、SmtpClientアプリケーションが同じ SMTP サーバーに複数のメッセージを送信する場合、SMTP サーバーへのクラスが再利用される可能性があります。The connection established by the current instance of the SmtpClient class to the SMTP server may be re-used if an application wishes to send multiple messages to the same SMTP server. 認証または暗号化を使用すると特に便利ですが、SMTP サーバーへの接続を確立します。This is particularly useful when authentication or encryption are used establish a connection to the SMTP server. 認証と TLS セッションの確立プロセスには、負荷の高い操作を指定できます。The process of authenticating and establishing a TLS session can be expensive operations. 同じ SMTP サーバーに大量の電子メールを送信するときに、メッセージごとに接続を再確立するための要件には、パフォーマンスに大きな影響を与える可能性があります。A requirement to re-establish a connection for each message when sending a large quantity of email to the same SMTP server could have a significant impact on performance. 送信メールのステータス更新のニュースレターの配布、または電子メールのアラートが大量の電子メール アプリケーションを数多くあります。There are a number of high-volume email applications that send email status updates, newsletter distributions, or email alerts. 多くの電子メール クライアント アプリケーションをサポートして、オフライン モードのユーザーが SMTP サーバーへの接続が確立されているときに後で送信される多くの電子メール メッセージを作成できます。Also many email client applications support an off-line mode where users can compose many email messages that are sent later when a connection to the SMTP server is established. 特定の SMTP サーバー (インターネット サービス プロバイダーによって提供される) し、他の SMTP サーバーにこの電子メールを転送するすべての SMTP メッセージを送信する電子メール クライアントの一般的なものになります。It is typical for an email client to send all SMTP messages to a specific SMTP server (provided by the Internet service provider) that then forwards this email to other SMTP servers.

SmtpClientクラスの実装が SMTP 接続をプールすべてのメッセージを同じサーバーへの接続が再確立のオーバーヘッドを回避できます。The SmtpClient class implementation pools SMTP connections so that it can avoid the overhead of re-establishing a connection for every message to the same server. アプリケーションで再利用、同じことがありますSmtpClientと多数のさまざまな SMTP サーバーに同じ SMTP サーバーには、多くのさまざまな電子メールを送信するオブジェクト。An application may re-use the same SmtpClient object to send many different emails to the same SMTP server and to many different SMTP servers. その結果、アプリケーションが終了したときに確認する方法はありませんを使用して、SmtpClientをオブジェクトをクリーンアップする必要があります。As a result, there is no way to determine when an application is finished using the SmtpClient object and it should be cleaned up.

SMTP セッションが終了し、クライアントが接続を終了する必要がある、ときに、サーバーに送信するメッセージがなくなったことを示す QUIT メッセージを送信する必要があります。When an SMTP session is finished and the client wishes to terminate the connection, it must send a QUIT message to the server to indicate that it has no more messages to send. これにより、クライアントからの接続に関連付けられているリソースを解放して、クライアントによって送信されたメッセージを処理するサーバー。This allows the server to free up resources associated with the connection from the client and process the messages which were sent by the client.

Dispose TCP 接続を正常に終了後にメソッドが確立されているすべての接続と、SMTP サーバーごとに QUIT メッセージを送信を反復処理します。The Dispose methods iterates through all established connections and send a QUIT message to each SMTP server, followed by gracefully ending the TCP connection. これらのメソッドによって使用されるアンマネージ リソースを解放します。、Socketして必要に応じてマネージ リソースを破棄します。These methods also release the unmanaged resources used by the Socket and optionally dispose of the managed resources.

Dispose() Dispose() Dispose() Dispose()

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, and releases all resources used by the current instance of the SmtpClient class.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

実装

注釈

現在のインスタンスによって確立された接続、SmtpClientアプリケーションが同じ SMTP サーバーに複数のメッセージを送信する場合、SMTP サーバーへのクラスが再利用される可能性があります。The connection established by the current instance of the SmtpClient class to the SMTP server may be re-used if an application wishes to send multiple messages to the same SMTP server. 認証または暗号化を使用すると特に便利ですが、SMTP サーバーへの接続を確立します。This is particularly useful when authentication or encryption are used establish a connection to the SMTP server. 認証と TLS セッションの確立プロセスには、負荷の高い操作を指定できます。The process of authenticating and establishing a TLS session can be expensive operations. 同じ SMTP サーバーに大量の電子メールを送信するときに、メッセージごとに接続を再確立するための要件には、パフォーマンスに大きな影響を与える可能性があります。A requirement to re-establish a connection for each message when sending a large quantity of email to the same SMTP server could have a significant impact on performance. 送信メールのステータス更新のニュースレターの配布、または電子メールのアラートが大量の電子メール アプリケーションを数多くあります。There are a number of high-volume email applications that send email status updates, newsletter distributions, or email alerts. 多くの電子メール クライアント アプリケーションをサポートして、オフライン モードのユーザーが SMTP サーバーへの接続が確立されているときに後で送信される多くの電子メール メッセージを作成できます。Also many email client applications support an off-line mode where users can compose many email messages that are sent later when a connection to the SMTP server is established. 特定の SMTP サーバー (インターネット サービス プロバイダーによって提供される) し、他の SMTP サーバーにこの電子メールを転送するすべての SMTP メッセージを送信する電子メール クライアントの一般的なものになります。It is typical for an email client to send all SMTP messages to a specific SMTP server (provided by the Internet service provider) that then forwards this email to other SMTP servers.

SmtpClientクラスの実装が SMTP 接続をプールすべてのメッセージを同じサーバーへの接続が再確立のオーバーヘッドを回避できます。The SmtpClient class implementation pools SMTP connections so that it can avoid the overhead of re-establishing a connection for every message to the same server. アプリケーションで再利用、同じことがありますSmtpClientと多数のさまざまな SMTP サーバーに同じ SMTP サーバーには、多くのさまざまな電子メールを送信するオブジェクト。An application may re-use the same SmtpClient object to send many different emails to the same SMTP server and to many different SMTP servers. その結果、アプリケーションが終了したときに確認する方法はありませんを使用して、SmtpClientをオブジェクトをクリーンアップする必要があります。As a result, there is no way to determine when an application is finished using the SmtpClient object and it should be cleaned up.

SMTP セッションが終了し、クライアントが接続を終了する必要がある、ときに、サーバーに送信するメッセージがなくなったことを示す QUIT メッセージを送信する必要があります。When an SMTP session is finished and the client wishes to terminate the connection, it must send a QUIT message to the server to indicate that it has no more messages to send. これにより、クライアントからの接続に関連付けられているリソースを解放して、クライアントによって送信されたメッセージを処理するサーバー。This allows the server to free up resources associated with the connection from the client and process the messages which were sent by the client.

呼び出す、DisposeメソッドをSmtpClient非同期で実行されているオブジェクトSendAsync操作がいなくても、送信操作をキャンセルは、SendAsyncCancelメソッドが呼び出されました。Calling the Dispose method on a SmtpClient object that is executing an asynchronous SendAsync operation will cancel the send operation as though the SendAsyncCancel method had been called.

SmtpClientクラスを持たないFinalizeメソッド。The SmtpClient class has no Finalize method. アプリケーションを呼び出す必要がありますようにDisposeリソースを明示的に解放します。So an application must call Dispose to explicitly free up resources.

Disposeメソッド反復処理で指定された SMTP サーバーに確立されているすべての接続、Hostプロパティと、TCP 接続を正常に終了後に終了メッセージを送信します。The Dispose method iterates through all established connections to the SMTP server specified in the Host property and sends a QUIT message followed by gracefully ending the TCP connection. Disposeメソッドは、基になるによって使用されるアンマネージ リソースも解放Socketします。The Dispose method also releases the unmanaged resources used by the underlying Socket.

SmtpClient を使い終わったら、Disposeを呼び出します。Call Dispose when you are finished using the SmtpClient. Disposeメソッドによって、SmtpClient は使用不可の状態になります。The Dispose method leaves the SmtpClient in an unusable state. Dispose呼び出し後は、SmtpClientによって占有されていたメモリをガベージ コレクターがクリアできるよう、SmtpClient へのすべての参照を解放する必要があります。After calling Dispose, you must release all references to the SmtpClient so the garbage collector can reclaim the memory that the SmtpClient was occupying.

詳細については、アンマネージ リソースのクリーンアップおよびDispose メソッドの実装を参照してください。For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

注意

SmtpClientへの最後の参照を解放する前に、必ずDisposeを呼び出してください。Always call Dispose before you release your last reference to the SmtpClient. それ以外の場合、ガベージ コレクターがメモリをクリアできるように、使用されているリソースは解放されません。Otherwise, the resources it is using will not be freed so the garbage collector can reclaim the memory.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。オプションでマネージド リソースも破棄します。Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, releases all resources used by the current instance of the SmtpClient class, and optionally disposes of the managed resources.

protected:
 virtual void Dispose(bool disposing);
protected virtual void Dispose (bool disposing);
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable Sub Dispose (disposing As Boolean)

パラメーター

disposing
Boolean Boolean Boolean Boolean

マネージド リソースとアンマネージド リソースの両方を解放する場合は true。アンマネージド リソースだけを解放する場合は falsetrue to release both managed and unmanaged resources; false to releases only unmanaged resources.

注釈

現在のインスタンスによって確立された接続、SmtpClientアプリケーションが同じ SMTP サーバーに複数のメッセージを送信する場合、SMTP サーバーへのクラスが再利用される可能性があります。The connection established by the current instance of the SmtpClient class to the SMTP server may be re-used if an application wishes to send multiple messages to the same SMTP server. 認証または暗号化を使用すると特に便利ですが、SMTP サーバーへの接続を確立します。This is particularly useful when authentication or encryption are used establish a connection to the SMTP server. 認証と TLS セッションの確立プロセスには、負荷の高い操作を指定できます。The process of authenticating and establishing a TLS session can be expensive operations. 同じ SMTP サーバーに大量の電子メールを送信するときに、メッセージごとに接続を再確立するための要件には、パフォーマンスに大きな影響を与える可能性があります。A requirement to re-establish a connection for each message when sending a large quantity of email to the same SMTP server could have a significant impact on performance. 送信メールのステータス更新のニュースレターの配布、または電子メールのアラートが大量の電子メール アプリケーションを数多くあります。There are a number of high-volume email applications that send email status updates, newsletter distributions, or email alerts. 多くの電子メール クライアント アプリケーションをサポートして、オフライン モードのユーザーが SMTP サーバーへの接続が確立されているときに後で送信される多くの電子メール メッセージを作成できます。Also many email client applications support an off-line mode where users can compose many email messages that are sent later when a connection to the SMTP server is established. 特定の SMTP サーバー (インターネット サービス プロバイダーによって提供される) し、他の SMTP サーバーにこの電子メールを転送するすべての SMTP メッセージを送信する電子メール クライアントの一般的なものになります。It is typical for an email client to send all SMTP messages to a specific SMTP server (provided by the Internet service provider) that then forwards this email to other SMTP servers.

SmtpClientクラスの実装が SMTP 接続をプールすべてのメッセージを同じサーバーへの接続が再確立のオーバーヘッドを回避できます。The SmtpClient class implementation pools SMTP connections so that it can avoid the overhead of re-establishing a connection for every message to the same server. アプリケーションで再利用、同じことがありますSmtpClientと多数のさまざまな SMTP サーバーに同じ SMTP サーバーには、多くのさまざまな電子メールを送信するオブジェクト。An application may re-use the same SmtpClient object to send many different emails to the same SMTP server and to many different SMTP servers. その結果、アプリケーションが終了したときに確認する方法はありませんを使用して、SmtpClientをオブジェクトをクリーンアップする必要があります。As a result, there is no way to determine when an application is finished using the SmtpClient object and it should be cleaned up.

SMTP セッションが終了し、クライアントが接続を終了する必要がある、ときに、サーバーに送信するメッセージがなくなったことを示す QUIT メッセージを送信する必要があります。When an SMTP session is finished and the client wishes to terminate the connection, it must send a QUIT message to the server to indicate that it has no more messages to send. これにより、クライアントからの接続に関連付けられているリソースを解放して、クライアントによって送信されたメッセージを処理するサーバー。This allows the server to free up resources associated with the connection from the client and process the messages which were sent by the client.

呼び出す、DisposeメソッドをSmtpClient非同期で実行されているオブジェクトSendAsync操作がいなくても、送信操作をキャンセルは、SendAsyncCancelメソッドが呼び出されました。Calling the Dispose method on a SmtpClient object that is executing an asynchronous SendAsync operation will cancel the send operation as though the SendAsyncCancel method had been called.

SmtpClientクラスを持たないFinalizeメソッド。The SmtpClient class has no Finalize method. アプリケーションを呼び出す必要がありますようにDisposeリソースを明示的に解放します。So an application must call Dispose to explicitly free up resources.

Disposeメソッド反復処理で指定された SMTP サーバーに確立されているすべての接続、Hostプロパティと、TCP 接続を正常に終了後に終了メッセージを送信します。The Dispose method iterates through all established connections to the SMTP server specified in the Host property and sends a QUIT message followed by gracefully ending the TCP connection. Disposeメソッドで使用されるアンマネージ リソースも解放、Socketとマネージ リソースも破棄します。The Dispose method also releases the unmanaged resources used by the Socket and optionally disposes of the managed resources.

SmtpClient を使い終わったら、Disposeを呼び出します。Call Dispose when you are finished using the SmtpClient. Disposeメソッドによって、SmtpClient は使用不可の状態になります。The Dispose method leaves the SmtpClient in an unusable state. Dispose呼び出し後は、SmtpClientによって占有されていたメモリをガベージ コレクターがクリアできるよう、SmtpClient へのすべての参照を解放する必要があります。After calling Dispose, you must release all references to the SmtpClient so the garbage collector can reclaim the memory that the SmtpClient was occupying.

詳細については、アンマネージ リソースのクリーンアップおよびDispose メソッドの実装を参照してください。For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

注意

SmtpClientへの最後の参照を解放する前に、必ずDisposeを呼び出してください。Always call Dispose before you release your last reference to the SmtpClient. それ以外の場合、ガベージ コレクターがメモリをクリアできるように、使用されているリソースは解放されません。Otherwise, the resources it is using will not be freed so the garbage collector can reclaim the memory.

適用対象