UdpClient.SendAsync 方法

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

將 UDP 資料包非同步傳送至遠端主機。

多載

SendAsync(Byte[], Int32)	將 UDP 資料包非同步傳送至遠端主機。
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	將 UDP 資料包非同步傳送至遠端主機。
SendAsync(Byte[], Int32, IPEndPoint)	將 UDP 資料包非同步傳送至遠端主機。
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	將 UDP 資料包非同步傳送至遠端主機。
SendAsync(Byte[], Int32, String, Int32)	將 UDP 資料包非同步傳送至遠端主機。
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	將 UDP 資料包非同步傳送至遠端主機。

SendAsync(Byte[], Int32)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes);

member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)

參數

datagram

Byte[]

Byte 類型的陣列，指定您想傳送的 UDP 資料包，並以位元組陣列表示。

bytes

Int32

資料包中的位元組數目。

傳回

Task<Int32>

傳回 Task<TResult>。

例外狀況

ArgumentNullException

dgram 為 null。

InvalidOperationException

UdpClient 已建立預設遠端主機。

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

備註

此多載會將數據報傳送至 方法中建立的 Connect 遠端主機。 如果您在呼叫這個多載之前未呼叫 Connect ，方法會擲回 SocketException。 如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參考 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

如果您想要將數據報傳送至不同的遠端主機，您必須呼叫 Connect 方法並指定所需的遠端主機。 使用其他 SendAsync 任一方法多載，將數據報傳送至廣播位址。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 Send(Byte[], Int32)例外狀況。

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

參數

datagram

ReadOnlyMemory<Byte>

型Byte別的 ，ReadOnlyMemory<T>指定您想要傳送的 UDP 數據報。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值為 None。

傳回

ValueTask<Int32>

， ValueTask<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。

例外狀況

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

OperationCanceledException

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

SendAsync(Byte[], Int32, IPEndPoint)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);

member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)

參數

datagram

Byte[]

Byte 類型的陣列，指定您想傳送的 UDP 資料包，並以位元組陣列表示。

bytes

Int32

資料包中的位元組數目。

endPoint

IPEndPoint

IPEndPoint，表示傳送資料包的目標主機和通訊埠。

傳回

Task<Int32>

傳回 Task<TResult>。

例外狀況

ArgumentNullException

dgram 為 null。

InvalidOperationException

UdpClient 已建立預設遠端主機。

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

備註

這個方法會將數據報傳送至指定的端點。 在呼叫此多載之前，您必須先使用要傳遞資料報之遠端主機的IP位址和埠號碼來建立 IPEndPoint 。 您可以指定 SocketOptionName.BroadcastAddress 的 屬性 IPEndPoint，將數據報傳送至預設廣播位址 255.255.255.255。 建立這個 IPEndPoint之後，請將它傳遞至這個方法做為 endPoint 參數。

如果您要將資料報傳送至任何其他廣播位址，請使用 Client 方法來取得基礎 Socket，並將套接字選項設定為 SocketOptionName.Broadcast。 您也可以還原為使用 Socket 類別。

警告

如果您已經使用 方法建立遠端主機，請勿提供 endPoint 這個方法的參數 Connect 。 如果您這樣做，這個方法會擲回 SocketException。 如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參考 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 Send(Byte[], Int32, IPEndPoint)例外狀況。

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

參數

datagram

ReadOnlyMemory<Byte>

型Byte別的 ，ReadOnlyMemory<T>指定您想要傳送的 UDP 數據報。

endPoint

IPEndPoint

IPEndPoint，表示傳送資料包的目標主機和通訊埠。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值為 None。

傳回

ValueTask<Int32>

， ValueTask<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。

例外狀況

InvalidOperationException

UdpClient 已建立預設遠端主機，而不是 endPointnull。

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

OperationCanceledException

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

SendAsync(Byte[], Int32, String, Int32)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string? hostname, int port);

member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)

參數

datagram

Byte[]

Byte 類型的陣列，指定您想傳送的 UDP 資料包，並以位元組陣列表示。

bytes

Int32

資料包中的位元組數目。

hostname

String

您要傳送資料包之目標遠端主機的名稱。

port

Int32

您要用來通訊的遠端連接埠號碼。

傳回

Task<Int32>

傳回 Task<TResult>。

例外狀況

ArgumentNullException

dgram 為 null。

InvalidOperationException

UdpClient 已建立預設遠端主機。

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

備註

這個方法會將數據報傳送至 和 port 參數所hostname指定的值。 您可以指定參數值的 「255.255.255.255」， hostname 將數據報傳送至預設廣播位址。

如果您要將資料報傳送至任何其他廣播位址，請使用 Client 方法來取得基礎 Socket，並將套接字選項設定為 SocketOptionName.Broadcast。 您也可以還原為使用 Socket 類別。

警告

如果您已經使用 Connect 方法建立遠端主機，請勿提供這個方法的主機名或埠號碼。 如果您這樣做，這個方法會擲回 SocketException。 如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參考 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 Send(Byte[], Int32, String, Int32)例外狀況。

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

來源:

UDPClient.cs

將 UDP 資料包非同步傳送至遠端主機。

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

參數

datagram

ReadOnlyMemory<Byte>

ReadOnlyMemory<T>的 Byte ，指定您想要傳送的 UDP 數據報。

hostname

String

您要傳送資料包之目標遠端主機的名稱。

port

Int32

您要用來通訊的遠端連接埠號碼。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值為 None。

傳回

ValueTask<Int32>

， ValueTask<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。

例外狀況

InvalidOperationException

UdpClient 已建立預設遠端主機。

ObjectDisposedException

UdpClient 已關閉。

SocketException

存取通訊端時發生錯誤。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。