Socket.SendTo メソッド

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * int * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外

例

次のコード例では、指定したリモート ホストにコネクションレス データグラムを送信します。 オフセット、サイズ、および SocketFlags は、 SendTo メソッドに渡されます。

public static void SendTo4()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, 0, msg.Length, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo4() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, 0, msg.Length, SocketFlags.None, endPoint)
    s.Close()

End Sub

注釈

このオーバーロードでは、socketflags パラメーターとして DontRoute フラグを指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、SendToを呼び出す前に、Connect メソッドを使用して既定のリモート ホストを確立する必要はありません。 これは、 Send メソッドを呼び出す場合にのみ必要です。 SendToを呼び出す前に Connect メソッドを呼び出した場合、remoteEP パラメーターは、その送信操作に対してのみ指定された既定のリモート ホストをオーバーライドします。 また、基になるサービス プロバイダーによって最も適切なローカル ネットワーク アドレスとポート番号が割り当てられるため、 Bind メソッドを呼び出す必要はありません。 割り当てられたローカル ネットワーク アドレスとポート番号を識別する必要がある場合は、SendToメソッドが正常に完了した後に、LocalEndPoint プロパティを使用できます。

SendToはコネクションレス プロトコルを対象としていますが、接続指向プロトコルでも機能します。 接続指向プロトコルを使用している場合は、まず、 Connect メソッドを呼び出してリモート ホスト接続を確立するか、 Accept メソッドを使用して受信接続要求を受け入れる必要があります。 リモート ホスト接続を確立または受け入れなかった場合、 SendTo は SocketExceptionをスローします。 SendTo メソッドを呼び出す前に、コネクションレス プロトコルの既定のリモート ホストを確立することもできます。 いずれの場合も、 SendTo は remoteEP パラメーターを無視し、接続されているリモート ホストまたは既定のリモート ホストにのみデータを送信します。

ブロックソケットは、要求されたバイト数が送信されるまでブロックされます。 非ブロッキング Socket はすぐに完了するため、1 回の操作で要求されたすべてのバイトが送信されない場合があります。 アプリケーションは、送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行する必要があります。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 SendTo メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ブロッキング モードでコネクションレス プロトコルを使用している場合、 SendTo はデータグラムが送信されるまでブロックされます。 ブロードキャスト アドレスにデータを送信する場合は、最初に SetSocketOption メソッドを呼び出し、ソケット オプションを SocketOptionName.Broadcast に設定する必要があります。 また、サイズが基になるサービス プロバイダーの最大パケット サイズを超えないようにする必要があります。 送信された場合、データグラムは送信されず、 SendTo は SocketExceptionをスローします。

こちらもご覧ください

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo(byte[] buffer, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外

例

次のコード例では、指定したリモート ホストにコネクションレス データグラムを送信します。 サイズと SocketFlags は、 SendTo メソッドに渡されます。

public static void SendTo3()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, msg.Length, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo3() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, msg.Length, SocketFlags.None, endPoint)
    s.Close()

End Sub

注釈

このオーバーロードでは、バッファー オフセットの既定値は 0 です。 DontRoute フラグを socketflags パラメーターとして指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、SendToを呼び出す前に、Connect メソッドを使用して既定のリモート ホストを確立する必要はありません。 これは、 Send メソッドを呼び出す場合にのみ必要です。 SendToを呼び出す前に Connect メソッドを呼び出した場合、remoteEP パラメーターは、その送信操作に対してのみ指定された既定のリモート ホストをオーバーライドします。 また、基になるサービス プロバイダーによって最も適切なローカル ネットワーク アドレスとポート番号が割り当てられるため、 Bind メソッドを呼び出す必要はありません。 割り当てられたローカル ネットワーク アドレスとポート番号を識別する必要がある場合は、SendToメソッドが正常に完了した後に、LocalEndPoint プロパティを使用できます。

SendToはコネクションレス プロトコルを対象としていますが、接続指向プロトコルでも機能します。 接続指向プロトコルを使用している場合は、まず、 Connect メソッドを呼び出してリモート ホスト接続を確立するか、 Accept メソッドを使用して受信接続要求を受け入れる必要があります。 リモート ホスト接続を確立または受け入れなかった場合、 SendTo は SocketExceptionをスローします。 SendTo メソッドを呼び出す前に、コネクションレス プロトコルの既定のリモート ホストを確立することもできます。 いずれの場合も、 SendTo は remoteEP パラメーターを無視し、接続されているリモート ホストまたは既定のリモート ホストにのみデータを送信します。

ブロックソケットは、要求されたバイト数が送信されるまでブロックされます。 非ブロッキング Socket はすぐに完了するため、1 回の操作で要求されたすべてのバイトが送信されない場合があります。 送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 SendTo メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ブロッキング モードでコネクションレス プロトコルを使用している場合、 SendTo はデータグラムが送信されるまでブロックされます。 ブロードキャスト アドレスにデータを送信する場合は、最初に SetSocketOption メソッドを呼び出し、ソケット オプションを SocketOptionName.Broadcast に設定する必要があります。 また、送信されたバイト数が、基になるサービス プロバイダーの最大パケット サイズを超えていないことも確認する必要があります。 送信された場合、データグラムは送信されず、 SendTo は SocketExceptionをスローします。

こちらもご覧ください

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::SocketAddress ^ socketAddress);

public int SendTo(ReadOnlySpan<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.SocketAddress socketAddress);

member this.SendTo : ReadOnlySpan<byte> * System.Net.Sockets.SocketFlags * System.Net.SocketAddress -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags, socketAddress As SocketAddress) As Integer

パラメーター

返品

送信されたバイト数。

例外

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::EndPoint ^ remoteEP);

public int SendTo(ReadOnlySpan<byte> buffer, System.Net.EndPoint remoteEP);

member this.SendTo : ReadOnlySpan<byte> * System.Net.EndPoint -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo(byte[] buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外

例

次のコード例では、指定したリモート ホストにコネクションレス データグラムを送信します。 SocketFlags は、 SendTo メソッドに渡されます。

public static void SendTo2()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo2() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, SocketFlags.None, endPoint)
    s.Close()

End Sub

注釈

このオーバーロードでは、バッファー オフセットの既定値は 0 で、送信するバイト数は既定で bufferのサイズになります。 DontRoute フラグを socketflags パラメーターとして指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、SendToを呼び出す前に、Connect メソッドを使用して既定のリモート ホストを確立する必要はありません。 これは、 Send メソッドを呼び出す場合にのみ必要です。 SendToを呼び出す前に Connect メソッドを呼び出した場合、remoteEP パラメーターは、その送信操作に対してのみ指定された既定のリモート ホストをオーバーライドします。 また、基になるサービス プロバイダーによって最も適切なローカル ネットワーク アドレスとポート番号が割り当てられるため、 Bind メソッドを呼び出す必要はありません。 割り当てられたローカル ネットワーク アドレスとポート番号を識別する必要がある場合は、SendToメソッドが正常に完了した後に、LocalEndPoint プロパティを使用できます。

SendToはコネクションレス プロトコルを対象としていますが、接続指向プロトコルでも機能します。 接続指向プロトコルを使用している場合は、まず、 Connect メソッドを呼び出してリモート ホスト接続を確立するか、 Accept メソッドを使用して受信接続要求を受け入れる必要があります。 リモート ホスト接続を確立または受け入れなかった場合、 SendTo は SocketExceptionをスローします。 SendTo メソッドを呼び出す前に、コネクションレス プロトコルの既定のリモート ホストを確立することもできます。 いずれの場合も、 SendTo は remoteEP パラメーターを無視し、接続されているリモート ホストまたは既定のリモート ホストにのみデータを送信します。

ブロックソケットは、要求された buffer 内のすべてのバイトが送信されるまでブロックされます。 非ブロッキング Socket はすぐに完了するため、 buffer内のすべてのバイトが送信されない場合があります。 送信されたバイト数を追跡し、アプリケーションが buffer内のすべてのバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 SendTo メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ブロッキング モードでコネクションレス プロトコルを使用している場合、 SendTo はデータグラムが送信されるまでブロックされます。 ブロードキャスト アドレスにデータを送信する場合は、最初に SetSocketOption メソッドを呼び出し、ソケット オプションを SocketOptionName.Broadcast に設定する必要があります。 また、送信されたバイト数が、基になるサービス プロバイダーの最大パケット サイズを超えていないことも確認する必要があります。 送信された場合、データグラムは送信されず、 SendTo は SocketExceptionをスローします。

こちらもご覧ください

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, System::Net::EndPoint ^ remoteEP);

public int SendTo(byte[] buffer, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外

例

次のコード例では、指定したリモート ホストにコネクションレス データグラムを送信します。

public static void SendTo1()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, endPoint);
    s.Close();
}

Public Shared Sub SendTo1() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, endPoint)
    s.Close()

End Sub

注釈

このオーバーロードでは、バッファー オフセットの既定値は 0、送信するバイト数は既定で buffer パラメーターのサイズ、 SocketFlags の値は既定値は 0 です。

コネクションレス プロトコルを使用している場合は、SendToを呼び出す前に、Connect メソッドを使用して既定のリモート ホストを確立する必要はありません。 これは、 Send メソッドを呼び出す場合にのみ必要です。 SendToを呼び出す前に Connect メソッドを呼び出した場合、remoteEP パラメーターは、その送信操作に対してのみ指定された既定のリモート ホストをオーバーライドします。 また、基になるサービス プロバイダーによって最も適切なローカル ネットワーク アドレスとポート番号が割り当てられるため、 Bind メソッドを呼び出す必要はありません。 割り当てられたローカル ネットワーク アドレスとポート番号を識別する必要がある場合は、SendToメソッドが正常に完了した後に、LocalEndPoint プロパティを使用できます。

SendToはコネクションレス プロトコルを対象としていますが、接続指向プロトコルでも機能します。 接続指向プロトコルを使用している場合は、まず、 Connect メソッドを呼び出してリモート ホスト接続を確立するか、 Accept メソッドを使用して受信接続要求を受け入れる必要があります。 リモート ホスト接続を確立または受け入れなかった場合、 SendTo は SocketExceptionをスローします。 SendTo メソッドを呼び出す前に、コネクションレス プロトコルの既定のリモート ホストを確立することもできます。 いずれの場合も、 SendTo は remoteEP パラメーターを無視し、接続されているリモート ホストまたは既定のリモート ホストにのみデータを送信します。

ブロッキング ソケットは、バッファー内のすべてのバイトが送信されるまでブロックされます。 非ブロッキング Socket はすぐに完了するため、 buffer内のすべてのバイトが送信されない場合があります。 送信されたバイト数を追跡し、アプリケーションが buffer内のすべてのバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 SendTo メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ブロッキング モードでコネクションレス プロトコルを使用している場合、 SendTo はデータグラムが送信されるまでブロックされます。 ブロードキャスト アドレスにデータを送信する場合は、最初に SetSocketOption メソッドを呼び出し、ソケット オプションを SocketOptionName.Broadcast に設定する必要があります。 また、送信されたバイト数が、基になるサービス プロバイダーの最大パケット サイズを超えていないことも確認する必要があります。 送信された場合、データグラムは送信されず、 SendTo は SocketExceptionをスローします。

こちらもご覧ください

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo(ReadOnlySpan<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : ReadOnlySpan<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

パラメーター

返品

送信されたバイト数。

例外