IDuplexSession.CloseOutputSession Method

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.0.0

Terminates the outbound session that indicates that no more messages will be sent from this endpoint on the channel associated with the session.

Overloads

CloseOutputSession()	Terminates the outbound session that indicates that no more messages will be sent from this endpoint on the channel associated with the session.
CloseOutputSession(TimeSpan)	Terminates the outbound session that indicates that no more messages will be sent from this endpoint on the channel associated with the session within a specified interval of time.

CloseOutputSession()

Source:

IDuplexSession.cs

Terminates the outbound session that indicates that no more messages will be sent from this endpoint on the channel associated with the session.

public:
 void CloseOutputSession();

public void CloseOutputSession ();

abstract member CloseOutputSession : unit -> unit

Public Sub CloseOutputSession ()

Remarks

Calling CloseOutputSession() signals to the other side of the session that it should return null from any outstanding or subsequent calls made to Receive. CloseOutputSession is idempotent, so calling it again has no effect.

Terminating the outbound session does not affect the incoming session and so makes no statement about the ability to receive messages on the session associated with the input channel.

Notes to Implementers

CloseOutputSession() is a session method that can interact with the IDuplexSessionChannel that owns the session. In particular, if your session lifetime is put together with your channel lifetime (like it is with TCP and reliable session and security):

• If CloseOutputSession() is called before Close() is called on the channel, Close() should wait for CloseOutputSession() to finish.

• If the channel is in the Created or Opening state, CloseOutputSession() should throw an InvalidOperationException.

• If the channel is in the Faulted state, CloseOutputSession() should throw a CommunicationObjectFaultedException.

• The channel should fault if CloseOutputSession() throws.

• The implementation of Close() on the channel should call CloseOutputSession() and then verify that Receive() returns null, which indicates that CloseOutputSession() was called from the other side of the session.

CloseOutputSession(TimeSpan)

Source:

IDuplexSession.cs

Terminates the outbound session that indicates that no more messages will be sent from this endpoint on the channel associated with the session within a specified interval of time.

public:
 void CloseOutputSession(TimeSpan timeout);

public void CloseOutputSession (TimeSpan timeout);

abstract member CloseOutputSession : TimeSpan -> unit

Public Sub CloseOutputSession (timeout As TimeSpan)

Parameters

timeout

TimeSpan

The TimeSpan that specifies the interval of time within which the operation must complete.

Remarks

Calling CloseOutputSession(TimeSpan) signals to the other side of the session that it should return null from any outstanding or subsequent calls made to Receive. CloseOutputSession is idempotent, so calling it again has no effect.

Terminating the outbound session does not affect the incoming session and so makes no statement about the ability to receive messages on the session associated with the input channel.

Notes to Implementers

CloseOutputSession() is a session method that can interact with the IDuplexSessionChannel that owns the session. In particular, if your session lifetime is put together with your channel lifetime (like it is with TCP and reliable session and security):

• If CloseOutputSession() is called before Close() is called on the channel, Close() should wait for CloseOutputSession() to finish.

• If the channel is in the Created or Opening state, CloseOutputSession() should throw an InvalidOperationException.

• If the channel is in the Faulted state, CloseOutputSession() should throw a CommunicationObjectFaultedException.

• The channel should fault if CloseOutputSession() throws.

• The implementation of Close() on the channel should call CloseOutputSession() and then verify that Receive() returns null, indicating that CloseOutputSession() was called from the other side of the session.