UdpClient.Send メソッド

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

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

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

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

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

ObjectDisposedException

UdpClient が閉じています。

SocketException

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

例

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 指定しないでください。その場合、メソッドは Send を SocketExceptionスローします。を受け取った場合は、 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

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

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

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

ObjectDisposedException

UdpClient が閉じています。

SocketException

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

適用対象

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。

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

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

ObjectDisposedException

UdpClient は閉じています。

SocketException

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

例

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.Broadcast Addressすることで、データグラムを既定のブロードキャストアドレス 255.255.255.255 に送信できます。この IPEndPointを作成したら、パラメーターとして endPoint メソッドにSend渡します。

注意

メソッドを使用してリモートホストを endPoint 既に確立している場合は、このメソッドにパラメーターを Connect 指定しないでください。その場合、メソッドは Send を SocketExceptionスローします。を受け取った場合は、 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

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

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

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

ObjectDisposedException

UdpClient が閉じています。

SocketException

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

例

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 のメソッドオーバーロードのいずれかを使用して、ブロードキャストアドレスにデータグラムを送信します。

こちらもご覧ください

Connect(String, Int32)

適用対象

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の。

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

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

ObjectDisposedException

UdpClient が閉じています。

SocketException

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

適用対象

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。

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

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

ObjectDisposedException

UdpClient は閉じています。

SocketException

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

適用対象

次の方法で共有

UdpClient.Send メソッド

定義

オーバーロード

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

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Send(ReadOnlySpan<Byte>, String, Int32)

パラメーター

戻り値

例外

適用対象

Send(Byte[], Int32, IPEndPoint)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Send(Byte[], Int32)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Send(ReadOnlySpan<Byte>)

パラメーター

戻り値

例外

適用対象

Send(ReadOnlySpan<Byte>, IPEndPoint)

パラメーター

戻り値

例外

適用対象

その他のリソース