UdpClient.SendAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 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
- 來源:
- UDPClient.cs
- 來源:
- 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)參數
- bytes
- Int32
資料包中的位元組數目。
傳回
傳回 Task<TResult>。
例外狀況
dgram 為 null。
UdpClient 已建立預設遠端主機。
存取通訊端時發生錯誤。
備註
此多載會將數據報傳送至 方法中建立的 Connect 遠端主機。 如果您在呼叫這個多載之前未呼叫 Connect ，方法會擲回 SocketException。 如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參考 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。
如果您想要將數據報傳送至不同的遠端主機，您必須呼叫 Connect 方法並指定所需的遠端主機。 使用其他 SendAsync 任一方法多載，將數據報傳送至廣播位址。
這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 Send(Byte[], Int32)例外狀況。
適用於
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)
- 來源:
- UDPClient.cs
- 來源:
- UDPClient.cs
- 來源:
- 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<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。
例外狀況
存取通訊端時發生錯誤。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
適用於
SendAsync(Byte[], Int32, IPEndPoint)
- 來源:
- UDPClient.cs
- 來源:
- UDPClient.cs
- 來源:
- 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);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)參數
- bytes
- Int32
資料包中的位元組數目。
- endPoint
- IPEndPoint
IPEndPoint，表示傳送資料包的目標主機和通訊埠。
傳回
傳回 Task<TResult>。
例外狀況
dgram 為 null。
UdpClient 已建立預設遠端主機。
存取通訊端時發生錯誤。
備註
這個方法會將數據報傳送至指定的端點。 在呼叫此多載之前，您必須先使用要傳遞資料報之遠端主機的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
- 來源:
- UDPClient.cs
- 來源:
- 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<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。
例外狀況
UdpClient 已建立預設遠端主機，而不是 endPointnull。
存取通訊端時發生錯誤。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
適用於
SendAsync(Byte[], Int32, String, Int32)
- 來源:
- UDPClient.cs
- 來源:
- UDPClient.cs
- 來源:
- 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);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)參數
- bytes
- Int32
資料包中的位元組數目。
- hostname
- String
您要傳送資料包之目標遠端主機的名稱。
- port
- Int32
您要用來通訊的遠端連接埠號碼。
傳回
傳回 Task<TResult>。
例外狀況
dgram 為 null。
UdpClient 已建立預設遠端主機。
存取通訊端時發生錯誤。
備註
這個方法會將數據報傳送至 和 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
- 來源:
- UDPClient.cs
- 來源:
- 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<TResult> 表示異步傳送作業。 其 Result 屬性的值包含傳送的位元元組數目。
例外狀況
UdpClient 已建立預設遠端主機。
存取通訊端時發生錯誤。
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
