Socket.Send メソッド

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Send(ReadOnlySpan<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Send : ReadOnlySpan<byte> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Send (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

注釈

Send は、 Connect メソッドまたは Accept メソッドで指定されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

このオーバーロードには、送信するデータを含むバッファーが必要です。 SocketFlags値の既定値は 0、バッファー オフセットの既定値は 0、送信するバイト数は既定でバッファーのサイズになります。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectを呼び出すたびに、Sendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendに別の呼び出しを行うことで、Connectを呼び出す前に既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「Network Tracing in .NET Framework」を参照してください。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(ReadOnlySpan<System::Byte> buffer);

public int Send(ReadOnlySpan<byte> buffer);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (buffer As ReadOnlySpan(Of Byte)) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

注釈

Send は、 Connect メソッドまたは Accept メソッドで指定されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

このオーバーロードには、送信するデータを含むバッファーが必要です。 SocketFlags値の既定値は 0、バッファー オフセットの既定値は 0、送信するバイト数は既定でバッファーのサイズになります。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectを呼び出すたびに、Sendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendに別の呼び出しを行うことで、Connectを呼び出す前に既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「Network Tracing in .NET Framework」を参照してください。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Send(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Send : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Send (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

例

次のコード例では、接続されたSocketFlagsにデータを送信するためのデータ バッファー、オフセット、サイズ、およびSocketを指定します。

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
public static int SendReceiveTest4(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, 0, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, 0, bytes.Length, SocketFlags.None);

        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, offset, message size, and socket flags.
Public Shared Function SendReceiveTest4(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, 0, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, 0, server.Available, SocketFlags.None)
        
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest4

注釈

Send は、 Connect メソッドまたは Accept メソッドで指定されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

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

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendToを使用する必要があります。 SendToを使用しない場合は、各呼び出しの前にConnectを呼び出Send必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用しても問題ありません。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

また、サイズが基になるサービス プロバイダーの最大パケット サイズを超えないようにする必要があります。 送信された場合、データグラムは送信されず、 Send は SocketExceptionをスローします。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、要求されたバイト数が送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、 Send は、要求したバイト数未満の送信でも正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Send(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Send : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Send (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

注釈

このオーバーロードには、送信するデータを含むバッファーが少なくとも 1 つ必要です。 SocketFlags値の既定値は 0 です。 DontRoute フラグを socketFlags パラメーターとして指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectの各呼び出しの前にSendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

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

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

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

Public Function Send (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

例

次のコード例では、接続されたSocketFlagsにデータを送信するためのデータ バッファー、オフセット、サイズ、およびSocketを指定します。

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
public static int SendReceiveTest4(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, 0, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, 0, bytes.Length, SocketFlags.None);

        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, offset, message size, and socket flags.
Public Shared Function SendReceiveTest4(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, 0, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, 0, server.Available, SocketFlags.None)
        
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest4

注釈

Send は、 Connect メソッドまたは Accept メソッドで指定されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

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

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendToを使用する必要があります。 SendToを使用しない場合は、各呼び出しの前にConnectを呼び出Send必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用しても問題ありません。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

また、サイズが基になるサービス プロバイダーの最大パケット サイズを超えないようにする必要があります。 送信された場合、データグラムは送信されず、 Send は SocketExceptionをスローします。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、要求されたバイト数が送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、 Send は、要求したバイト数未満の送信でも正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

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

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

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

Public Function Send (buffer As Byte(), size As Integer, socketFlags As SocketFlags) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

例

次のコード例では、バッファー内のデータを送信し、NoneのSocketFlagsを指定します。

// Displays sending with a connected socket
// using the overload that takes a buffer, message size, and socket flags.
public static int SendReceiveTest3(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int i = server.Send(msg, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", i);

        // Get reply from the server.
        int byteCount = server.Receive(bytes, bytes.Length, SocketFlags.None);
        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, message size, and socket flags.
Public Shared Function SendReceiveTest3(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim i As Integer = server.Send(msg, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", i)
        
        ' Get reply from the server.
        Dim byteCount As Integer = server.Receive(bytes, server.Available, SocketFlags.None)
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest3

注釈

Send Connectまたは Accept メソッドで確立されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

このオーバーロードには、送信するデータ、送信するバイト数、および任意の SocketFlagsのビットごとの組み合わせを含むバッファーが必要です。 DontRoute パラメーターとして socketflags フラグを指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connect メソッドを呼び出す前に、Send メソッドを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendに別の呼び出しを行うことで、Connectを呼び出す前に既定のリモート ホストを変更することもできます。

接続指向プロトコルでは、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、要求されたバイト数が送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、 Send は、要求したバイト数未満の送信でも正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「Network Tracing in .NET Framework」を参照してください。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public int Send(System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.Send : System.Collections.Generic.IList<ArraySegment<byte>> -> int

Public Function Send (buffers As IList(Of ArraySegment(Of Byte))) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

注釈

Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

このオーバーロードには、送信するデータを含むバッファーが少なくとも 1 つ必要です。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectの各呼び出しの前にSendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public int Send(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.Send : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> int

Public Function Send (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

注釈

このオーバーロードには、送信するデータを含むバッファーが少なくとも 1 つ必要です。 SocketFlags値の既定値は 0 です。 DontRoute フラグを socketFlags パラメーターとして指定した場合、送信するデータはルーティングされません。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectの各呼び出しの前にSendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

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

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

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

Public Function Send (buffer As Byte(), socketFlags As SocketFlags) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

例

次のコード例は、接続された Socketでデータを送信する方法を示しています。

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
public static int SendReceiveTest2(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None);
        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer and socket flags.
Public Shared Function SendReceiveTest2(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None)
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest2

注釈

Send Connectまたは Accept メソッドで確立されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Sendメソッドは、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

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

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectを呼び出すたびに、Send メソッドを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションが要求されたバイト数を送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

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

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

Public Function Send (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

こちらもご覧ください

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

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Send(cli::array <System::Byte> ^ buffer);

public int Send(byte[] buffer);

member this.Send : byte[] -> int

Public Function Send (buffer As Byte()) As Integer

パラメーター

返品

Socketに送信されたバイト数。

例外

例

次のコード例は、接続された Socketでデータを送信する方法を示しています。

// Displays sending with a connected socket
// using the overload that takes a buffer.
public static int SendReceiveTest1(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int i = server.Send(msg);
        Console.WriteLine("Sent {0} bytes.", i);

        // Get reply from the server.
        i = server.Receive(bytes);
        Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer.
Public Shared Function SendReceiveTest1(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim i As Integer = server.Send(msg)
        Console.WriteLine("Sent {0} bytes.", i)
        
        ' Get reply from the server.
        i = server.Receive(bytes)
        Console.WriteLine(Encoding.UTF8.GetString(bytes))
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest1

注釈

Send は、 Connect メソッドまたは Accept メソッドで指定されたリモート ホストにデータを同期的に送信し、正常に送信されたバイト数を返します。 Send は、接続指向プロトコルとコネクションレス プロトコルの両方に使用できます。

このオーバーロードには、送信するデータを含むバッファーが必要です。 SocketFlags値の既定値は 0、バッファー オフセットの既定値は 0、送信するバイト数は既定でバッファーのサイズになります。

コネクションレス プロトコルを使用している場合は、このメソッドを呼び出す前に Connect を呼び出す必要があります。または、 Send は SocketExceptionをスローします。 接続指向プロトコルを使用している場合は、 Connect を使用してリモート ホスト接続を確立するか、 Accept を使用して受信接続を受け入れる必要があります。

コネクションレス プロトコルを使用していて、複数の異なるホストにデータを送信する予定がある場合は、 SendTo メソッドを使用する必要があります。 SendTo メソッドを使用しない場合は、Connectの各呼び出しの前にSendを呼び出す必要があります。 SendToで既定のリモート ホストを確立した後でも、Connectを使用できます。 Sendを呼び出す前に、Connectの別の呼び出しを行うことで、既定のリモート ホストを変更することもできます。

接続指向プロトコルを使用している場合、 Send は、 Socket.SendTimeoutを使用してタイムアウトが設定されていない限り、バッファー内のすべてのバイトが送信されるまでブロックされます。 タイムアウト値を超えた場合、 Send 呼び出しは SocketExceptionをスローします。 非ブロッキング モードでは、バッファー内のバイト数より小さい場合でも、 Send が正常に完了する可能性があります。 送信されたバイト数を追跡し、アプリケーションがバッファー内のバイトを送信するまで操作を再試行するのは、アプリケーションの責任です。 また、送信したデータがネットワークにすぐに表示される保証もありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる可能性があります。 Send メソッドが正常に完了すると、基になるシステムに、ネットワーク送信用にデータをバッファーする領域があることを意味します。

こちらもご覧ください

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