Send(String,Int32,String,String) Method

In This Topic

Sends a DicomDataSet to a remote DICOM application

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function Send( _
   ByVal Node As System.String, _
   ByVal Port As System.Integer, _
   ByVal CallingAE As System.String, _
   ByVal CalledAE As System.String _
) As System.Integer

'Usage
 
Dim instance As DicomDataSet
Dim Node As System.String
Dim Port As System.Integer
Dim CallingAE As System.String
Dim CalledAE As System.String
Dim value As System.Integer
 
value = instance.Send(Node, Port, CallingAE, CalledAE)

public System.int Send( 
   System.string Node,
   System.int Port,
   System.string CallingAE,
   System.string CalledAE
)

public function Send( 
    Node: System.String;
    Port: System.Integer;
    CallingAE: System.String;
    CalledAE: System.String
): System.Integer;

public function Send( 
   Node : System.String,
   Port : System.int,
   CallingAE : System.String,
   CalledAE : System.String
) : System.int;

public: System.int Send( 
   System.string* Node,
   System.int Port,
   System.string* CallingAE,
   System.string* CalledAE
)

public:
System.int Send( 
   System.String^ Node,
   System.int Port,
   System.String^ CallingAE,
   System.String^ CalledAE
)

Parameters

Node: Network address (as dotted notation or resolvable name) to which the image is to be sent.
Port: Port on which remote application is listening.
CallingAE: Name of remote Application Entity.
CalledAE: Name to quote for this Application Entity

Return Value

The status as returned by the remote application. Zero indicates success.

Remarks

This method negotiates an association, sends one dataset over it, and then closes it. DICOM does not allow SCPs to draw any conclusion about the relationships between images based on the opening and closing of associations, so this should never be a problem (apart from slight network inefficiency). However, there are several badly written applications in the world, which incorrectly assume that the end of an association indicates the end of a series or a study etc., and if interfacing to such a faulty implementation, it is possible to send multiple images on one association by using DicomAssociation object, and its SendInstances methods.

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomDataSet Class
DicomDataSet Members
Overload List

Send Feedback