DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomAssociation Class / PreferredTSList Property






In This Topic
    PreferredTSList Property
    In This Topic
    Provides guidance for the choice of presentation context
    Syntax
    'Declaration
     
    
    Public Property PreferredTSList As System.Collections.Generic.IEnumerable(Of String)
    'Usage
     
    
    Dim instance As DicomAssociation
    Dim value As System.Collections.Generic.IEnumerable(Of String)
     
    instance.PreferredTSList = value
     
    value = instance.PreferredTSList
    public System.Collections.Generic.IEnumerable<string> PreferredTSList {get; set;}
    public read-write property PreferredTSList: System.Collections.Generic.IEnumerable; 
    public function get,set PreferredTSList : System.Collections.Generic.IEnumerable
    public: __property System.Collections.Generic.IEnumerable<string*>* get_PreferredTSList();
    public: __property void set_PreferredTSList( 
       System.Collections.Generic.IEnumerable<string*>* value
    );
    public:
    property System.Collections.Generic.IEnumerable<String^>^ PreferredTSList {
       System.Collections.Generic.IEnumerable<String^>^ get();
       void set (    System.Collections.Generic.IEnumerable<String^>^ value);
    }
    Remarks

    Under some circumstances, DicomObjects may have a choice of presentation contexts to use for a given operation, and PreferredTSList, 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, empty array 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 not, and if any presentation context, using any of the transfer syntaxes given by PreferredTSList is available, then that is used. The list is in order of decreasing priority, so the first TS in the list with a matching negotiated presentation context will be used.
    • If none 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: .NET CLR 4.8 or higher

    See Also