Socket.Close メソッド

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

Socket.Close メソッド (Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Socket 接続を閉じ、関連付けられたすべてのリソースを解放します。

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

Visual Basic (宣言)

Public Sub Close ( _
    timeout As Integer _
)

Visual Basic (使用法)

Dim instance As Socket
Dim timeout As Integer

instance.Close(timeout)

C#

public void Close (
    int timeout
)

C++

public:
void Close (
    int timeout
)

J#

public void Close (
    int timeout
)

JScript

public function Close (
    timeout : int
)

パラメータ

timeout

timeout 秒になるまで待機して残りのデータを送信し、ソケットを閉じます。

解説

Close メソッドは、リモート ホスト接続を閉じて、Socket に関連付けられたマネージ リソースとアンマネージ リソースすべてを解放します。閉じるときに、Connected プロパティは false に設定されます。

コネクション指向のプロトコルの場合は、Close の前に Shutdown を呼び出すことをお勧めします。これにより、閉じる前の接続ソケットですべてのデータが送受信されるようになります。

Shutdown を呼び出さずに Close を呼び出す必要がある場合は、DontLinger オプションを false に設定し、0 以外のタイムアウト間隔を指定することで、発信伝送キューに置かれたデータが送信されるようにします。この場合、Close は、このデータが送信されるか指定したタイムアウト時間が経過するまでブロックします。DontLinger を false に設定し、ゼロのタイムアウト間隔を指定すると、Close は接続を解放し、発信キューに置かれたデータは自動的に破棄されます。

メモ
DontLinger ソケット オプションを false に設定するには、LingerOption を作成し、有効にされたプロパティを true に設定して、LingerTime プロパティを必要なタイムアウト期限に設定します。この LingerOption と DontLinger ソケット オプションを使用して、SetSocketOption メソッドを呼び出します。

メモ
このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

Socket を閉じる方法を次のコード例に示します。

Visual Basic

    aSocket.Shutdown(SocketShutdown.Both)
    aSocket.Close()

End Sub 'SocketClose

C#

aSocket.Shutdown(SocketShutdown.Both);
aSocket.Close();

C++

aSocket->Shutdown( SocketShutdown::Both );
aSocket->Close();
if ( aSocket->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}

プラットフォーム

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

参照

関連項目
Socket クラス
Socket メンバ
System.Net.Sockets 名前空間
Shutdown
DontLinger

Socket.Close メソッド

Socket 接続を閉じ、関連付けられたすべてのリソースを解放します。
オーバーロードの一覧

名前	説明
Socket.Close ()	Socket 接続を閉じ、関連付けられたすべてのリソースを解放します。 .NET Compact Framework によってサポートされています。
Socket.Close (Int32)	Socket 接続を閉じ、関連付けられたすべてのリソースを解放します。

参照

関連項目

Socket クラス
Socket メンバ
System.Net.Sockets 名前空間
Shutdown
DontLinger

Socket.Close メソッド ()

Socket 接続を閉じ、関連付けられたすべてのリソースを解放します。

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

Visual Basic (宣言)

Public Sub Close

Visual Basic (使用法)

Dim instance As Socket

instance.Close

C#

public void Close ()

C++

public:
void Close ()

J#

public void Close ()

JScript

public function Close ()

解説

Close メソッドは、リモート ホスト接続を閉じて、Socket に関連付けられたマネージ リソースとアンマネージ リソースすべてを解放します。閉じるときに、Connected プロパティは false に設定されます。

コネクション指向のプロトコルの場合は、Close メソッドの前に Shutdown を呼び出すことをお勧めします。これにより、閉じる前の接続ソケットですべてのデータが送受信されるようになります。

Shutdown を呼び出さずに Close を呼び出す必要がある場合は、DontLingerSocket オプションを false に設定し、0 以外のタイムアウト間隔を指定することで、発信伝送キューに置かれたデータが送信されるようにします。この場合、Close は、このデータが送信されるか指定したタイムアウト時間が経過するまでブロックします。DontLinger を false に設定し、ゼロのタイムアウト間隔を指定すると、Close は接続を解放し、発信キューに置かれたデータは自動的に破棄されます。

メモ
DontLinger ソケット オプションを false に設定するには、LingerOption を作成し、有効にされたプロパティを true に設定して、LingerTime プロパティを必要なタイムアウト時間に設定します。この LingerOption と DontLinger ソケット オプションを使用して、SetSocketOption メソッドを呼び出します。

メモ
このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

Socket を閉じるコード例を次に示します。

Visual Basic

    aSocket.Shutdown(SocketShutdown.Both)
    aSocket.Close()

End Sub 'SocketClose

C#

aSocket.Shutdown(SocketShutdown.Both);
aSocket.Close();

C++

aSocket->Shutdown( SocketShutdown::Both );
aSocket->Close();
if ( aSocket->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Socket クラス
Socket メンバ
System.Net.Sockets 名前空間
Shutdown
DontLinger