TcpListener 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
接聽 TCP 網路用戶端的連接。
public ref class TcpListenerpublic ref class TcpListener : IDisposablepublic class TcpListenerpublic class TcpListener : IDisposabletype TcpListener = classtype TcpListener = class
interface IDisposablePublic Class TcpListenerPublic Class TcpListener
Implements IDisposable- 繼承
-
TcpListener
- 實作
範例
下列程式代碼範例會建立 TcpListener。
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Net::Sockets;
using namespace System::Text;
using namespace System::Threading;
void main()
{
try
{
// Set the TcpListener on port 13000.
Int32 port = 13000;
IPAddress^ localAddr = IPAddress::Parse( "127.0.0.1" );
// TcpListener* server = new TcpListener(port);
TcpListener^ server = gcnew TcpListener( localAddr,port );
// Start listening for client requests.
server->Start();
// Buffer for reading data
array<Byte>^bytes = gcnew array<Byte>(256);
String^ data = nullptr;
// Enter the listening loop.
while ( true )
{
Console::Write( "Waiting for a connection... " );
// Perform a blocking call to accept requests.
// You could also use server.AcceptSocket() here.
TcpClient^ client = server->AcceptTcpClient();
Console::WriteLine( "Connected!" );
data = nullptr;
// Get a stream Object* for reading and writing
NetworkStream^ stream = client->GetStream();
Int32 i;
// Loop to receive all the data sent by the client.
while ( i = stream->Read( bytes, 0, bytes->Length ) )
{
// Translate data bytes to a ASCII String*.
data = Text::Encoding::ASCII->GetString( bytes, 0, i );
Console::WriteLine( "Received: {0}", data );
// Process the data sent by the client.
data = data->ToUpper();
array<Byte>^msg = Text::Encoding::ASCII->GetBytes( data );
// Send back a response.
stream->Write( msg, 0, msg->Length );
Console::WriteLine( "Sent: {0}", data );
}
// Shutdown and end connection
client->Close();
}
}
catch ( SocketException^ e )
{
Console::WriteLine( "SocketException: {0}", e );
}
Console::WriteLine( "\nHit enter to continue..." );
Console::Read();
}
using System;
using System.IO;
using System.Net;
using System.Net.Sockets;
using System.Text;
class MyTcpListener
{
public static void Main()
{
TcpListener server = null;
try
{
// Set the TcpListener on port 13000.
Int32 port = 13000;
IPAddress localAddr = IPAddress.Parse("127.0.0.1");
// TcpListener server = new TcpListener(port);
server = new TcpListener(localAddr, port);
// Start listening for client requests.
server.Start();
// Buffer for reading data
Byte[] bytes = new Byte[256];
String data = null;
// Enter the listening loop.
while(true)
{
Console.Write("Waiting for a connection... ");
// Perform a blocking call to accept requests.
// You could also use server.AcceptSocket() here.
using TcpClient client = server.AcceptTcpClient();
Console.WriteLine("Connected!");
data = null;
// Get a stream object for reading and writing
NetworkStream stream = client.GetStream();
int i;
// Loop to receive all the data sent by the client.
while((i = stream.Read(bytes, 0, bytes.Length))!=0)
{
// Translate data bytes to a ASCII string.
data = System.Text.Encoding.ASCII.GetString(bytes, 0, i);
Console.WriteLine("Received: {0}", data);
// Process the data sent by the client.
data = data.ToUpper();
byte[] msg = System.Text.Encoding.ASCII.GetBytes(data);
// Send back a response.
stream.Write(msg, 0, msg.Length);
Console.WriteLine("Sent: {0}", data);
}
}
}
catch(SocketException e)
{
Console.WriteLine("SocketException: {0}", e);
}
finally
{
server.Stop();
}
Console.WriteLine("\nHit enter to continue...");
Console.Read();
}
}
Imports System.IO
Imports System.Net
Imports System.Net.Sockets
Imports System.Text
Class MyTcpListener
Public Shared Sub Main()
Dim server As TcpListener
server=nothing
Try
' Set the TcpListener on port 13000.
Dim port As Int32 = 13000
Dim localAddr As IPAddress = IPAddress.Parse("127.0.0.1")
server = New TcpListener(localAddr, port)
' Start listening for client requests.
server.Start()
' Buffer for reading data
Dim bytes(1024) As Byte
Dim data As String = Nothing
' Enter the listening loop.
While True
Console.Write("Waiting for a connection... ")
' Perform a blocking call to accept requests.
' You could also use server.AcceptSocket() here.
Dim client As TcpClient = server.AcceptTcpClient()
Console.WriteLine("Connected!")
data = Nothing
' Get a stream object for reading and writing
Dim stream As NetworkStream = client.GetStream()
Dim i As Int32
' Loop to receive all the data sent by the client.
i = stream.Read(bytes, 0, bytes.Length)
While (i <> 0)
' Translate data bytes to a ASCII string.
data = System.Text.Encoding.ASCII.GetString(bytes, 0, i)
Console.WriteLine("Received: {0}", data)
' Process the data sent by the client.
data = data.ToUpper()
Dim msg As Byte() = System.Text.Encoding.ASCII.GetBytes(data)
' Send back a response.
stream.Write(msg, 0, msg.Length)
Console.WriteLine("Sent: {0}", data)
i = stream.Read(bytes, 0, bytes.Length)
End While
' Shutdown and end connection
client.Close()
End While
Catch e As SocketException
Console.WriteLine("SocketException: {0}", e)
Finally
server.Stop()
End Try
Console.WriteLine(ControlChars.Cr + "Hit enter to continue....")
Console.Read()
End Sub
End Class
如需用戶端範例，請參閱 TcpClient 。
備註
類別 TcpListener 提供簡單的方法，可在封鎖同步模式中接聽並接受連入連線要求。 您可以使用 TcpClient 或 Socket 來與 連線 TcpListener。 TcpListenerCreate 使用 IPEndPoint、本機IP位址和埠號碼，或只是埠號碼。 如果您想要基礎服務提供者為您指派這些值，請為本機 IP 位址指定 Any 本機 IP 位址和 0。 如果您選擇這樣做，您可以在套接字連線之後，使用 LocalEndpoint 屬性來識別指派的資訊。
Start使用方法來開始接聽連入連線要求。 Start 將會將連入連線排入佇列， Stop 直到您呼叫 方法或已排入佇列 MaxConnections為止。 AcceptSocket使用 或 AcceptTcpClient 從連入連線要求佇列提取連線。 這兩種方法將會封鎖。 如果您想要避免封鎖，您可以先使用 Pending 方法來判斷佇列中是否有可用的連線要求。
Stop呼叫 方法以關閉 TcpListener。
注意
方法 Stop 不會關閉任何已接受的連接。 您必須負責個別關閉這些專案。
建構函式
| TcpListener(Int32) |
已淘汰.
已淘汰.
已淘汰.
已淘汰.
初始化 TcpListener 類別的新執行個體，這個執行個體包含指定的設計工具。 |
| TcpListener(IPAddress, Int32) |
初始化 TcpListener 類別的新執行個體，這個執行個體會在指定的本機 IP 位址和通訊埠編號上接聽連入的連接嘗試。 |
| TcpListener(IPEndPoint) |
使用指定的本機端點，初始化 TcpListener 類別的新執行個體。 |
屬性
| Active |
取得值，指出 TcpListener 是否正在接聽用戶端連接。 |
| ExclusiveAddressUse |
取得或設定 Boolean 值，其指定 TcpListener 是否只允許一個基礎通訊端接聽特定的通訊埠。 |
| LocalEndpoint |
取得目前 EndPoint 的 TcpListener。 |
| Server |
取得基礎網路 Socket。 |
