←Select platform

Connect(string,int,string,int,DicomNetIpTypeFlags) Method

Summary

Connects an Called AE to an Calling AE.

Syntax
C#
VB
C++
public void Connect( 
   string hostAddress, 
   int hostPort, 
   string peerAddress, 
   int peerPort, 
   DicomNetIpTypeFlags ipType 
) 
Public Overloads Sub Connect( _ 
   ByVal hostAddress As String, _ 
   ByVal hostPort As Integer, _ 
   ByVal peerAddress As String, _ 
   ByVal peerPort As Integer, _ 
   ByVal ipType As DicomNetIpTypeFlags _ 
)  
public: 
void Connect(  
   String^ hostAddress, 
   int hostPort, 
   String^ peerAddress, 
   int peerPort, 
   DicomNetIpTypeFlags ipType 
)  

Parameters

hostAddress
The IP address of the Called AE computer (the SCU's address).

hostPort
The port number of the Called AE computer (the SCU's port).

peerAddress
The IP address of the Calling AE computer to which to connect (the SCP's address).

peerPort
The port number of the Calling AE computer to which to connect (the SCP's port).

ipType
The type of ip address supported (IPv4, IPv6, or both)

Remarks

If hostAddress is an empty string or a null reference (Nothing in VB), the IP address will be the local computer's address. If hostPort is 0, the port number will be the number of the first available port. In most cases, pass 0 for this parameter. If you pass any port number other than 0, that port number will be used for the first connection and when you close the connection, LEADTOOLS will wait for the internal TCP timeout before releasing the port. This can lead to problems reconnecting. If you pass 0, then on subsequent connections LEADTOOLS will use the next available port.

To connect to an Calling AE as an Called AE, you must first create a DicomNet object. Then call Connect to establish the connection.

To use your computer as an Calling AE, you must first create a DicomNet object. Then call Listen to listen for incoming connection requests.

When an Called AE calls this method, it generates a call to OnAccept on the SCP.

This overload of the DicomNet.Connect method allows you to specify the type of Internet Protocol Version to use. Pass DicomNetIpTypeFlags.Ipv4 for [ipType](" id="iptypeparameterlink" class="popuplink.html) to support the Internet Protocol version 4 (IPv4), which is the standard "dotted quad" 32-bit address format that has been in use since 1981. An example of an IPv4 address is 192.168.0.195

Pass DicomNetIpTypeFlags.Ipv6 for [ipType](" id="iptypeparameterlink" class="popuplink.html) to support Internet Protocol Version 6 (IPv6). IPv6 uses a 128-bit address format. An example of an IPv6 address is fe80::18bd:81f:6b02:759f

To support both IPv4 and Ipv6 addresses, pass DicomNetIpTypeFlags.Ipv4OrIpv6 for [ipType](" id="iptypeparameterlink" class="popuplink.html).

If the call to Connect fails, make sure that the IP address that was passed for hostAddress is a valid address that is accessible within your network. You can verify the accessibility of both IPv4 and IPv6 addresses using the Windows ping command. For example, to verify that 192.168.0.195 is accessible within your network, perform the following steps:

  • Start command prompt, and type the following command
  • ping 192.168.0.195

Note that the following are equivalent:

  • Connect( hostAddress, hostPort, peerAddress, peerPort);
  • Connect( hostAddress, hostPort, peerAddress, peerPort, DicomNetIpTypeFlags.Ipv4);

Example

For an example, refer to DicomNetIpTypeFlags.

Requirements

Target Platforms

Help Version 20.0.2019.9.19
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Dicom Assembly