LingerOption.LingerTime プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LingerOption.LingerTime プロパティ

送信するデータが残っている場合に、Socket.Close メソッドを呼び出した後で接続を維持する時間を取得または設定します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property LingerTime As
 Integer

Visual Basic (使用法)

Dim instance As LingerOption
Dim value As Integer

value = instance.LingerTime

instance.LingerTime = value

public int LingerTime { get;
 set; }

C++

public:
property int LingerTime {
    int get ();
    void set (int value);
}

/** @property */
public int get_LingerTime ()

/** @property */
public void set_LingerTime (int
 value)

JScript

public function get LingerTime
 () : int

public function set LingerTime
 (value : int)

プロパティ値
Socket.Close が呼び出された後、接続を維持する秒数。

解説

閉じられた Socket がタイムアウト前に未送信のデータを転送しようとする時間を確認する場合は、この値を使用します。また、この値を希望するタイムアウト時間 (秒) に設定することもできます。Enabled プロパティが true の場合、LingerTime を 0 に設定すると、Socket は発信ネットワークバッファに残っているデータがなくなるまでデータを送信しようとします。この値を変更する場合は、変更された LingerOption を SetSocketOption メソッドまたは LingerState メソッドに渡す必要があります。

使用例

このプロパティの値を表示する例を次に示します。

Visual Basic

    Console.WriteLine(("This application will timeout if Send does
 not return within " + Encoding.ASCII.GetString(s.GetSocketOption(SocketOptionLevel.Socket,
 SocketOptionName.SendTimeout, 4))))
    ' blocks until send returns
    Dim i As Integer = s.Send(msg)

    ' blocks until read returns
    Dim bytes(1024) As Byte
    s.Receive(bytes)

    'Display to the screen
    Console.WriteLine(Encoding.ASCII.GetString(bytes))
    s.Shutdown(SocketShutdown.Both)

    Console.WriteLine(("If data remains to be sent, this application
 will stay open for " + CType(s.GetSocketOption(SocketOptionLevel.Socket,
 SocketOptionName.Linger), LingerOption).LingerTime.ToString()))
    s.Close()
End Sub 'SetSocketOptions

Console.WriteLine ("This application will timeout if Send
 does not return within " + Encoding.ASCII.GetString (s.GetSocketOption
 (SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 4)));

// blocks until send returns
int i = s.Send (msg);

// blocks until read returns
byte[] bytes = new byte[1024];

s.Receive (bytes);

//Display to the screen
Console.WriteLine (Encoding.ASCII.GetString (bytes));
s.Shutdown (SocketShutdown.Both);
Console.WriteLine ("If data remains to be sent, this application
 will stay open for " + ((LingerOption)s.GetSocketOption
 (SocketOptionLevel.Socket, SocketOptionName.Linger)).LingerTime.ToString ());
s.Close ();

C++

Console::Write(  "This application will timeout if Send does
 not return within " );
Console::WriteLine( Encoding::ASCII->GetString( s->GetSocketOption( SocketOptionLevel::Socket,
 SocketOptionName::SendTimeout, 4 ) ) );

// Blocks until send returns.
int i = s->Send( msg );

// Blocks until read returns.
array<Byte>^ bytes = gcnew array<Byte>(1024);

s->Receive( bytes );

//Displays to the screen.
Console::WriteLine( Encoding::ASCII->GetString( bytes ) );
s->Shutdown( SocketShutdown::Both );
Console::Write(  "If data remains to be sent, this application
 will stay open for " );
Console::WriteLine( safe_cast<LingerOption^>(s->GetSocketOption( SocketOptionLevel::Socket,
 SocketOptionName::Linger ))->LingerTime.ToString() );
s->Close();

    Console.WriteLine("This application will timeout if Send
 does not "
        + "return within " + Encoding.get_ASCII().GetString(s.
        GetSocketOption(SocketOptionLevel.Socket, 
        SocketOptionName.SendTimeout, 4)));
    // blocks until send returns
    int i = s.Send(msg);
    // blocks until read returns
    ubyte bytes[] = new ubyte[1024];

    s.Receive(bytes);
    //Display to the screen
    Console.WriteLine(Encoding.get_ASCII().GetString(bytes));
    s.Shutdown(SocketShutdown.Both);
    Console.WriteLine("If data remains to be sent, this application
 "
        + "will stay open for " + ((LingerOption)(s.
        GetSocketOption(SocketOptionLevel.Socket, 
        SocketOptionName.Linger))).get_LingerTime());
    s.Close();
} //SetSocketOptions