Interface IDicomClientConnection
Inherited Members
Namespace: Dicom.Network.Client
Assembly: cs.temp.dll.dll
Syntax
public interface IDicomClientConnection : IDisposable
Properties
IsSendNextMessageRequired
Gets whether or not SendNextMessage is required, i.e. if any requests still have to be sent and there is no send loop currently running.
Declaration
bool IsSendNextMessageRequired { get; }
Property Value
Type | Description |
---|---|
Boolean |
IsSendQueueEmpty
Gets whether or not the send queue is empty, i.e. if all requests are sent and handled
Declaration
bool IsSendQueueEmpty { get; }
Property Value
Type | Description |
---|---|
Boolean |
Listener
Gets the long running listener task that waits for incoming DICOM communication from the server.
Declaration
Task Listener { get; }
Property Value
Type | Description |
---|---|
Task |
NetworkStream
Gets the network stream of this connection
Declaration
INetworkStream NetworkStream { get; }
Property Value
Type | Description |
---|---|
INetworkStream |
Methods
OnConnectionClosedAsync(Exception)
Callback when connection is closed.
Declaration
Task OnConnectionClosedAsync(Exception exception)
Parameters
Type | Name | Description |
---|---|---|
Exception | exception | Exception, if any, that forced connection to close. |
Returns
Type | Description |
---|---|
Task |
OnCStoreRequestAsync(DicomCStoreRequest)
Callback for handling a client related C-STORE request, typically emanating from the client's C-GET request.
Declaration
Task<DicomResponse> OnCStoreRequestAsync(DicomCStoreRequest request)
Parameters
Type | Name | Description |
---|---|---|
DicomCStoreRequest | request | C-STORE request. |
Returns
Type | Description |
---|---|
Task<DicomResponse> | The DicomCStoreResponse related to the C-STORE |
OnNEventReportRequestAsync(DicomNEventReportRequest)
Callback for handling a client related N-EVENT-REPORT-RQ request, typically emanating from the client's N-ACTION request.
Declaration
Task<DicomResponse> OnNEventReportRequestAsync(DicomNEventReportRequest request)
Parameters
Type | Name | Description |
---|---|---|
DicomNEventReportRequest | request | N-EVENT-REPORT-RQ request. |
Returns
Type | Description |
---|---|
Task<DicomResponse> | The DicomNEventReportResponse related to the N-EVENT-REPORT-RQ |
OnReceiveAbortAsync(DicomAbortSource, DicomAbortReason)
Callback on receiving an abort message.
Declaration
Task OnReceiveAbortAsync(DicomAbortSource source, DicomAbortReason reason)
Parameters
Type | Name | Description |
---|---|---|
DicomAbortSource | source | Abort source. |
DicomAbortReason | reason | Detailed reason for abort. |
Returns
Type | Description |
---|---|
Task |
OnReceiveAssociationAcceptAsync(DicomAssociation)
Callback for handling association accept scenarios.
Declaration
Task OnReceiveAssociationAcceptAsync(DicomAssociation association)
Parameters
Type | Name | Description |
---|---|---|
DicomAssociation | association | Accepted association. |
Returns
Type | Description |
---|---|
Task |
OnReceiveAssociationRejectAsync(DicomRejectResult, DicomRejectSource, DicomRejectReason)
Callback for handling association reject scenarios.
Declaration
Task OnReceiveAssociationRejectAsync(DicomRejectResult result, DicomRejectSource source, DicomRejectReason reason)
Parameters
Type | Name | Description |
---|---|---|
DicomRejectResult | result | Specification of rejection result. |
DicomRejectSource | source | Source of rejection. |
DicomRejectReason | reason | Detailed reason for rejection. |
Returns
Type | Description |
---|---|
Task |
OnReceiveAssociationReleaseResponseAsync()
Callback on response from an association release.
Declaration
Task OnReceiveAssociationReleaseResponseAsync()
Returns
Type | Description |
---|---|
Task |
OnRequestCompletedAsync(DicomRequest, DicomResponse)
Callback when a request has been completed (a final response was received, causing it to be removed from the pending queue)
Declaration
Task OnRequestCompletedAsync(DicomRequest request, DicomResponse response)
Parameters
Type | Name | Description |
---|---|---|
DicomRequest | request | The original request that was sent, which has now been fulfilled |
DicomResponse | response | The final response from the DICOM server |
Returns
Type | Description |
---|---|
Task |
OnRequestTimedOutAsync(DicomRequest, TimeSpan)
Callback when a request has timed out (no final response was received, but the timeout was exceeded and the request has been removed from the pending queue)
Declaration
Task OnRequestTimedOutAsync(DicomRequest request, TimeSpan timeout)
Parameters
Type | Name | Description |
---|---|---|
DicomRequest | request | The original request that was sent, which could not be fulfilled |
TimeSpan | timeout | The timeout duration that has been exceeded |
Returns
Type | Description |
---|---|
Task |
SendAbortAsync(DicomAbortSource, DicomAbortReason)
Send abort request.
Declaration
Task SendAbortAsync(DicomAbortSource source, DicomAbortReason reason)
Parameters
Type | Name | Description |
---|---|---|
DicomAbortSource | source | Abort source. |
DicomAbortReason | reason | Abort reason. |
Returns
Type | Description |
---|---|
Task |
SendAssociationReleaseRequestAsync()
Send association release request.
Declaration
Task SendAssociationReleaseRequestAsync()
Returns
Type | Description |
---|---|
Task |
SendAssociationRequestAsync(DicomAssociation)
Send association request.
Declaration
Task SendAssociationRequestAsync(DicomAssociation association)
Parameters
Type | Name | Description |
---|---|---|
DicomAssociation | association | DICOM association. |
Returns
Type | Description |
---|---|
Task |
SendNextMessageAsync()
Sometimes, DICOM requests can be enqueued but not immediately sent. This can happen for the following reasons: -- The same DicomService is already sending other requests -- The active association is temporarily saturated (too many open pending requests), see MaxAsyncOpsInvoked
Declaration
Task SendNextMessageAsync()
Returns
Type | Description |
---|---|
Task |
SendRequestAsync(DicomRequest)
Send request from service.
Declaration
Task SendRequestAsync(DicomRequest request)
Parameters
Type | Name | Description |
---|---|---|
DicomRequest | request | Request to send. |
Returns
Type | Description |
---|---|
Task |
StartListener()
Opens a long running listener task that waits for incoming DICOM communication
Declaration
void StartListener()