Listen Method (DicomWebServer)

In This Topic

Configure a web server to handle DicomWeb. A WebHostBuilder instance will be created internally to do the http listening and handles incoming requests

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Sub Listen( _
   ByVal BaseUri As String, _
   Optional ByVal CertficatePath As String, _
   Optional ByVal CertificatePassword As String _
)

'Usage
 
Dim instance As DicomWebServer
Dim BaseUri As String
Dim CertficatePath As String
Dim CertificatePassword As String
 
instance.Listen(BaseUri, CertficatePath, CertificatePassword)

public void Listen( 
   string BaseUri,
   string CertficatePath,
   string CertificatePassword
)

public:
void Listen( 
   String^ BaseUri,
   String^ CertficatePath,
   String^ CertificatePassword
)

Parameters

BaseUri: The uri on which the server will be listening on
CertficatePath: Absolute path to the Certificate file if need to listen on https
CertificatePassword: Password for the server certificate, CertficatePath must also be set

Remarks

The actual coordination with the web interface is handled by the WebHostBuilder object, and this must therefore by created (either in conjunction with a web server, or self-hosting) and must listen on the stated URL, using code like this

string BaseUri = "http://localhost:81/dicom"; HttpSelfHostConfiguration config = new HttpSelfHostConfiguration(BaseUri); server.Configure(config, BaseUri, "stow", "qido", "wado", "bulk"); server.StowReceived += Server_StowReceived; server.QidoReceived += Server_QidoReceived; server.WadoReceived += Server_WadoReceived; listen = new HttpSelfHostServer(config); listen.OpenAsync().Wait();

The prupose of the BaseUri parameter is simply to provide the details needed for "back links" in bulk data URIs and WADO resposnses

The prefixes used for the individual services are appended to that base URI as necessary, and are used for the configuration

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

DicomWebServer Class
DicomWebServer Members

Send Feedback