OnBeforeSendCGetRequest Method

Summary

Notifies an implementor before a DicomNet::SendCGetRequest is sent.

Syntax

C++

public virtual void OnBeforeSendCGetRequest( 
   DicomClient Client, 
   byte presentationID, 
   int messageID, 
   string affectedClass, 
   DicomCommandPriorityType priority, 
   DicomDataSet dataSet 
)

Public Overridable Sub OnBeforeSendCGetRequest( 
   ByVal Client As DicomClient, 
   ByVal presentationID As Byte, 
   ByVal messageID As Integer, 
   ByVal affectedClass As String, 
   ByVal priority As DicomCommandPriorityType, 
   ByVal dataSet As DicomDataSet 
)

public:  
   virtual void OnBeforeSendCGetRequest( 
       DicomClient^ Client, 
      Byte presentationID, 
      Int32 messageID, 
      String^ affectedClass, 
      DicomCommandPriorityType^ priority, 
      DicomDataSet^ dataSet 
   )

Parameters

Client

The client this notification applies to.

presentationID

The Presentation Context ID. The ID provides information about both the class type of the data and the Transfer Syntax to use when transferring the data.

messageID

The Message ID. Each message sent by a member of a connection should have a unique ID. Since a member of a connection may send several messages, this ID allows that member to identify when a specific request has been completed.

affectedClass

The class affected by the request. This will be a SOP Class or a Meta SOP Class.

status

The status of the original request.

priority

The priority level of the message. The Service Class Provider may or may not support priority. Therefore, setting this parameter may or may not have any effect.

dataSet

A DicomDataSet object that contains the Data Set to be found.

Remarks

Override this method to view or change arguments before a DicomNet::SendCGetRequest is sent.

This can be used with DICOM listening services in the High-level PACS Framework. For example, you can create an assembly that contains the following code, and copy the assembly into the DICOM listening service 'AddIns' folder.

public class SendNotify : NotifySendMessageBase 
{ 
      public override void OnBeforeSendCGetRequest(DicomClient Client, byte presentationID, int messageID, string affectedClass, DicomCommandPriorityType priority, DicomDataSet dataSet) 
      { 
         // View or change parameters 
         base.OnBeforeSendCGetRequest(Client, presentationID, messageID, affectedClass, priority, dataSet); 
      } 
}