DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomAssociation Class / SendInstances Method / SendInstances(DicomDataSet,String) Method
The DicomDataSet to send
The abstract syntax to use






In This Topic
    SendInstances(DicomDataSet,String) Method
    In This Topic
    Sends an DataSet over a DicomAssociation with a defined abstract syntax.
    Syntax
    'Declaration
     
    
    Public Overloads Sub SendInstances( _
       ByVal DataSet As DicomDataSet, _
       ByVal AbstractSyntax As System.String _
    ) 
    'Usage
     
    
    Dim instance As DicomAssociation
    Dim DataSet As DicomDataSet
    Dim AbstractSyntax As System.String
     
    instance.SendInstances(DataSet, AbstractSyntax)
    public void SendInstances( 
       DicomDataSet DataSet,
       System.string AbstractSyntax
    )
    public procedure SendInstances( 
        DataSet: DicomDataSet;
        AbstractSyntax: System.String
    ); 
    public function SendInstances( 
       DataSet : DicomDataSet,
       AbstractSyntax : System.String
    );
    public: void SendInstances( 
       DicomDataSet* DataSet,
       System.string* AbstractSyntax
    ) 
    public:
    void SendInstances( 
       DicomDataSet^ DataSet,
       System.String^ AbstractSyntax
    ) 

    Parameters

    DataSet
    The DicomDataSet to send
    AbstractSyntax
    The abstract syntax to use
    Remarks

    The primary purpose of this overload is to send data where the asbtract syntax cannot be determined from the SOP class of the data being sent (e.g. when using meta-SOP classes), but it may also be useful when dealing with faulty remote entities.

    For automatically generated DicomAssociation objects, this method is used in response to a C-GET or C-MOVE request, but it may also be used to send any images the client chooses over a "stand-alone" DicomAssociation.

    Data sent by this method are sent either to the requesting application (C-GET) or to another (C-MOVE or stand-alone) as a series of C-STORE actions.

    For C-MOVE operations, if this Association has been linked internally to the request (i.e. if it is the DicomObjects.EventArguments.QueryReceivedArgs.InstanceAssociation), then:

    • "pending" responses are generated automatically by this method.
    • The number of images remaining, failed, warning, and successful associated with the request are automatically updated by the method, and the Failures property maintains a list of refused images UIDs. If all images are to be returned via a single call to SendImages, then no specific client action is required, as NumberRemaining is set automatically to the number of images in Data if previously 0. If, however, the client wishes to return images via multiple calls to this method (e.g. to enable pending status messages), then NumberRemaining must be set correctly before the first image is returned.

    For C-MOVE requests, or "stand-alone" DicomAssociation objects, Open must be called before this method.

    Requirements

    Target Platforms: .NET CLR 4.8 or higher

    See Also