UdpClient.Send メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
UDP データグラムをリモート ホストに送信します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Send(Byte[], Int32, String, Int32) |
指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。 |
| Send(ReadOnlySpan<Byte>, String, Int32) |
指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。 |
| Send(Byte[], Int32, IPEndPoint) |
指定したリモート エンドポイントのホストに UDP データグラムを送信します。 |
| Send(Byte[], Int32) |
UDP データグラムをリモート ホストに送信します。 |
| Send(ReadOnlySpan<Byte>) |
UDP データグラムをリモート ホストに送信します。 |
| Send(ReadOnlySpan<Byte>, IPEndPoint) |
指定したリモート エンドポイントのホストに UDP データグラムを送信します。 |
Send(Byte[], Int32, String, Int32)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。
public:
int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);
public int Send(byte[] dgram, int bytes, string? hostname, int port);
public int Send(byte[] dgram, int bytes, string hostname, int port);
member this.Send : byte[] * int * string * int -> int
Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer
パラメーター
- bytes
- Int32
データグラム内のバイト数。
- hostname
- String
データグラムを送信するリモート ホストの名前。
- port
- Int32
通信するリモート ポート番号。
返品
送信されたバイト数。
例外
dgram は nullです。
UdpClientでは、既定のリモート ホストが既に確立されています。
UdpClient は閉じられます。
ソケットにアクセスするときにエラーが発生しました。
例
次の例では、 Send メソッドを示します。 この例では、ホスト名とポート番号を使用してターゲット ホストを識別します。
UdpClient udpClient = new UdpClient();
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
Console.WriteLine(e.ToString());
}
Dim udpClient As New UdpClient()
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
注釈
Send メソッドは、hostnameおよびportパラメーターで指定された値にデータグラムを送信し、正常に送信されたバイト数を返します。
hostname パラメーター値に "255.255.255.255" を指定することで、既定のブロードキャスト アドレスにデータグラムを送信できます。
データグラムを他のブロードキャスト アドレスに送信する場合は、 Client メソッドを使用して基になる Socketを取得し、ソケット オプションを SocketOptionName.Broadcast に設定します。 Socket クラスの使用に戻すこともできます。
Note
Connect メソッドを使用してリモート ホストを既に確立している場合は、このメソッドにホスト名またはポート番号を指定しないでください。 その場合、 Send メソッドは SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
こちらもご覧ください
適用対象
Send(ReadOnlySpan<Byte>, String, Int32)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。
public:
int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);
public int Send(ReadOnlySpan<byte> datagram, string? hostname, int port);
member this.Send : ReadOnlySpan<byte> * string * int -> int
Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer
パラメーター
- datagram
- ReadOnlySpan<Byte>
送信する UDP データグラムを指定する型ReadOnlySpan<T>のByte。
- hostname
- String
データグラムを送信するリモート ホストの名前。
- port
- Int32
通信するリモート ポート番号。
返品
送信されたバイト数。
例外
UdpClientでは、既定のリモート ホストが既に確立されています。
UdpClient は閉じられます。
ソケットにアクセスするときにエラーが発生しました。
適用対象
Send(Byte[], Int32, IPEndPoint)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
指定したリモート エンドポイントのホストに UDP データグラムを送信します。
public:
int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);
public int Send(byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);
public int Send(byte[] dgram, int bytes, System.Net.IPEndPoint endPoint);
member this.Send : byte[] * int * System.Net.IPEndPoint -> int
Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer
パラメーター
- bytes
- Int32
データグラム内のバイト数。
- endPoint
- IPEndPoint
データグラムを送信するホストとポートを表す IPEndPoint 。
返品
送信されたバイト数。
例外
dgram は nullです。
UdpClient は、既定のリモート ホストを既に確立しています。
UdpClient は閉じています。
ソケットにアクセスするときにエラーが発生しました。
例
次の例では、 Send メソッドを示します。 この例では、 IPEndPoint を使用してターゲット ホストを指定します。
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
Console.WriteLine(e.ToString());
}
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
注釈
Send メソッドは、指定したエンドポイントにデータグラムを送信し、正常に送信されたバイト数を返します。 このオーバーロードを呼び出す前に、まず、データグラムを配信するリモート ホストの IP アドレスとポート番号を使用して、 IPEndPoint を作成する必要があります。
SocketOptionName.BroadcastのAddress プロパティにIPEndPointを指定することで、既定のブロードキャスト アドレス 255.255.255.255 にデータグラムを送信できます。 このIPEndPointを作成したら、Send パラメーターとして endPoint メソッドに渡します。
データグラムを他のブロードキャスト アドレスに送信する場合は、 Client メソッドを使用して基になる Socketを取得し、ソケット オプションを SocketOptionName.Broadcast に設定します。 Socket クラスの使用に戻すこともできます。
Note
endPoint メソッドを使用してリモート ホストを既に確立している場合は、このメソッドに Connect パラメーターを指定しないでください。 その場合、 Send メソッドは SocketExceptionをスローします。
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
こちらもご覧ください
適用対象
Send(Byte[], Int32)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
UDP データグラムをリモート ホストに送信します。
public:
int Send(cli::array <System::Byte> ^ dgram, int bytes);
public int Send(byte[] dgram, int bytes);
member this.Send : byte[] * int -> int
Public Function Send (dgram As Byte(), bytes As Integer) As Integer
パラメーター
- bytes
- Int32
データグラム内のバイト数。
返品
送信されたバイト数。
例外
dgram は nullです。
UdpClientでは、既定のリモート ホストが既に確立されています。
UdpClient は閉じられます。
ソケットにアクセスするときにエラーが発生しました。
例
次の例では、 Send メソッドを示します。 このオーバーロードを使用する前に、既定のリモート ホストを確立する必要があります。
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());
}
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
注釈
このオーバーロードは、 Connect メソッドで確立されたリモート ホストにデータグラムを送信し、送信されたバイト数を返します。 このオーバーロードを呼び出す前に Connect を呼び出さない場合、 Send メソッドは SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
データグラムを別のリモート ホストに送信する場合は、 Connect メソッドを呼び出し、目的のリモート ホストを指定する必要があります。 ブロードキャスト アドレスにデータグラムを送信するには、他の Send メソッドオーバーロードのいずれかを使用します。
こちらもご覧ください
適用対象
Send(ReadOnlySpan<Byte>)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
UDP データグラムをリモート ホストに送信します。
public:
int Send(ReadOnlySpan<System::Byte> datagram);
public int Send(ReadOnlySpan<byte> datagram);
member this.Send : ReadOnlySpan<byte> -> int
Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer
パラメーター
- datagram
- ReadOnlySpan<Byte>
送信する UDP データグラムを指定する型ReadOnlySpan<T>のByte。
返品
送信されたバイト数。
例外
UdpClientは、既定のリモート ホストを確立していません。
UdpClient は閉じられます。
ソケットにアクセスするときにエラーが発生しました。
適用対象
Send(ReadOnlySpan<Byte>, IPEndPoint)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
指定したリモート エンドポイントのホストに UDP データグラムを送信します。
public:
int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);
public int Send(ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);
member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int
Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer
パラメーター
- datagram
- ReadOnlySpan<Byte>
送信する UDP データグラムを指定する型ReadOnlySpan<T>のByte。
- endPoint
- IPEndPoint
データグラムを送信するホストとポートを表す IPEndPoint 。
返品
送信されたバイト数。
例外
UdpClient は既定のリモート ホストを既に確立しており、 endPoint は nullされていません。
UdpClient は閉じています。
ソケットにアクセスするときにエラーが発生しました。