UdpClient.Send メソッド

定義

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

指定したリモート ホストの指定したポートに 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

パラメーター

dgram
Byte[]

バイトの配列として表された、送信する UDP データグラムを指定する Byte 型の配列。

bytes
Int32

データグラム内のバイト数。

hostname
String

データグラム送信先のリモート ホストの名前。

port
Int32

通信先のリモート ポート番号。

戻り値

送信されたバイト数。

例外

dgramnullです。

UdpClient が既定のリモート ホストを既に確立しました。

UdpClient が閉じています。

ソケットへのアクセス中にエラーが発生しました。

Sendメソッドの例を次に示します。 この例では、ホスト名とポート番号を使用してターゲット ホストを識別します。

UdpClient^ udpClient = gcnew UdpClient;

array<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() );
}
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、 パラメーターと port パラメーターで指定された値にデータグラムをhostname送信し、正常に送信されたバイト数を返します。 パラメーター値に "255.255.255.255" を指定することで、既定のブロードキャスト アドレスにデータグラムを hostname 送信できます。

データグラムを他のブロードキャスト アドレスに送信する場合は、 メソッドを Client 使用して基になる Socketを取得し、ソケット オプションを に SocketOptionName.Broadcast設定します。 クラスの使用 Socket に戻すこともできます。

注意

メソッドを使用してリモート ホストを既に確立している場合は、このメソッドにホスト名またはポート番号を Connect 指定しないでください。 その場合、 メソッドは SendSocketExceptionスローします。 を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

適用対象

Send(ReadOnlySpan<Byte>, String, Int32)

ソース:
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>

ReadOnlySpan<T>送信する UDP データグラムを指定する 型Byteの 。

hostname
String

データグラム送信先のリモート ホストの名前。

port
Int32

通信先のリモート ポート番号。

戻り値

送信されたバイト数。

例外

UdpClient が既定のリモート ホストを既に確立しました。

UdpClient が閉じています。

ソケットへのアクセス中にエラーが発生しました。

適用対象

Send(Byte[], Int32, IPEndPoint)

ソース:
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

パラメーター

dgram
Byte[]

バイトの配列として表された、送信する UDP データグラムを指定する Byte 型の配列。

bytes
Int32

データグラム内のバイト数。

endPoint
IPEndPoint

データグラムの送信先のホストとポートを表す IPEndPoint

戻り値

送信されたバイト数。

例外

dgramnullです。

UdpClient が既定のリモート ホストを既に確立しました。

UdpClient は閉じています。

ソケットへのアクセス中にエラーが発生しました。

Sendメソッドの例を次に示します。 この例では、 を IPEndPoint 使用してターゲット ホストを指定します。

UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );

array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there?" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length, ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
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 する必要があります。 の プロパティIPEndPointに を指定SocketOptionName.BroadcastAddressすることで、データグラムを既定のブロードキャスト アドレス 255.255.255.255 に送信できます。 この IPEndPointを作成したら、 パラメーターとして endPoint メソッドにSend渡します。

データグラムを他のブロードキャスト アドレスに送信する場合は、 メソッドを Client 使用して基になる Socketを取得し、ソケット オプションを に SocketOptionName.Broadcast設定します。 クラスの使用 Socket に戻すこともできます。

注意

メソッドを使用してリモート ホストを endPoint 既に確立している場合は、このメソッドにパラメーターを Connect 指定しないでください。 その場合、 メソッドは SendSocketExceptionスローします。 を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

適用対象

Send(Byte[], Int32)

ソース:
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

パラメーター

dgram
Byte[]

バイトの配列として表された、送信する UDP データグラムを指定する Byte 型の配列。

bytes
Int32

データグラム内のバイト数。

戻り値

送信されたバイト数。

例外

dgramnullです。

UdpClient が既定のリモート ホストを既に確立しました。

UdpClient が閉じています。

ソケットへのアクセス中にエラーが発生しました。

Sendメソッドの例を次に示します。 このオーバーロードを使用する前に、既定のリモート ホストを確立する必要があります。

UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
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

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>

ReadOnlySpan<T>送信する UDP データグラムを指定する 型Byteの 。

戻り値

送信されたバイト数。

例外

では UdpClient 、既定のリモート ホストが確立されていません。

UdpClient が閉じています。

ソケットへのアクセス中にエラーが発生しました。

適用対象

Send(ReadOnlySpan<Byte>, IPEndPoint)

ソース:
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>

ReadOnlySpan<T>送信する UDP データグラムを指定する 型Byteの 。

endPoint
IPEndPoint

データグラムの送信先のホストとポートを表す IPEndPoint

戻り値

送信されたバイト数。

例外

UdpClient は既に既定のリモート ホストを確立しており、 endPoint ではありません null

UdpClient は閉じています。

ソケットへのアクセス中にエラーが発生しました。

適用対象