Send(String,Int32,String,String) Method

In This Topic

Sends a DicomDataSet to a remote DICOM application

Syntax

Visual Basic
C#
C++/CLI

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

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

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

public:
int Send( 
   String^ Node,
   int Port,
   String^ CallingAE,
   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: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DicomDataSet Class
DicomDataSet Members
Overload List

Send Feedback