PreferredTS Property

In This Topic

Provides guidance for the choice of presentation context

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Property PreferredTS As String

'Usage
 
Dim instance As DicomAssociation
Dim value As String
 
instance.PreferredTS = value
 
value = instance.PreferredTS

public string PreferredTS {get; set;}

public:
property String^ PreferredTS {
   String^ get();
   void set (    String^ value);
}

Remarks

Under some circumstances, DicomObjects may have a choice of presentation contexts to use for a given operation, and PreferredTS and PreferredPCID, provide guidance on which of the available options to use.

DicomObjects cannot, however, guarantee that the values given will be honoured, as the requirements of the standard, and the negotiated presentation contexts available will always take priority. Note also, that they can only be effective at the application actually carrying out the operation involved, normally the SCP.

The default values for these parameters are a null string and zero respectively, and these values are taken to mean "no preference".

Presentation context will be selected according to the following procedure:

If the presentation context given by PreferredPCID is appropriate for the operation, it is used.
If not, and if any presentation context, using the transfer syntax given by PreferredTS is available, then that is used.
If neither of the above applies, then any suitable and negotiated presentation context is used.

These properties are particularly designed for teleradiology applications, where run-time selection of a compressed syntax may be appropriate.

For a list of the available presentation contexts, see the Contexts property.

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

DicomAssociation Class
DicomAssociation Members

Send Feedback