リモート ホストに UDP データグラムを送信します。
Overloads Public Function Send( _
ByVal dgram() As Byte, _ ByVal bytes As Integer _) As Integer
[C#]
public int Send(byte[] dgram,intbytes);
[C++]
public: int Send(unsigned chardgram __gc[],intbytes);
[JScript]
public function Send(
dgram : Byte[],bytes : int) : int;
パラメータ
- dgram
バイトの配列として表された、送信する UDP データグラムを指定する Byte 型の配列。 - bytes
データグラム内のバイト数。
戻り値
送信されたバイト数。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | dgram が null 参照 (Visual Basic では Nothing) です。 |
InvalidOperationException | UdpClient が既定のリモート ホストを既に確立しました。 |
ObjectDisposedException | UdpClient が閉じています。 |
SocketException | ソケットへのアクセス中にエラーが発生しました。詳細については、「解説」を参照してください。 |
解説
このオーバーロードは、 Connect メソッドで確立されたリモート ホストにデータグラムを送信し、送信されたバイト数を返します。このオーバーロードの前に Connect を呼び出さない場合、 Send メソッドは SocketException をスローします。 SocketException が発生した場合は、 SocketException.ErrorCode を使用して具体的なエラー コードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラー コードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。
データグラムを別のリモート ホストに送信する場合は、 Connect メソッドを呼び出して必要なリモート ホストを指定する必要があります。ブロードキャスト アドレスにデータグラムを送信する場合は、他の Send メソッド オーバーロードのいずれかを使用します。
使用例
[Visual Basic, C#, C++] Send メソッドの例を次に示します。このオーバーロードを使用する前に既定のリモート ホストを確立しておく必要があります。
Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
[C#]
UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
Console.WriteLine( e.ToString());
}
[C++]
UdpClient* udpClient = new UdpClient(S"www.contoso.com", 11000);
Byte sendBytes[] = Encoding::ASCII->GetBytes(S"Is anybody there");
try{
udpClient->Send(sendBytes, sendBytes->Length);
}
catch ( Exception* e ){
Console::WriteLine( e->ToString());
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
UdpClient クラス | UdpClient メンバ | System.Net.Sockets 名前空間 | UdpClient.Send オーバーロードの一覧 | Connect | 基本型のエンコーディング