NCreate Method

Visual Basic
C#

'Declaration
 
Public Sub NCreate( _
   ByVal SOPClassUID As System.String, _
   ByVal InstanceUID As System.String, _
   ByVal DataSet As DicomDataSet _
)

public void NCreate( 
   System.string SOPClassUID,
   System.string InstanceUID,
   DicomDataSet DataSet
)

Parameters

SOPClassUID: The requested SOP Class UID
InstanceUID: The requested SOP InstanceUID
DataSet: The attributes to be set, with their values

This method sends an N-CREATE request, using the quoted SOP Class and Instance UIDs.

If appropriate, the SCP may use the values in DataSet to initialise the object.

If the operation succeeds, then the UID of the object created may be found, once the operation has completed, in the LastInstanceUID property.

C#

using (var cn = new DicomAssociation())
{
    DicomDataSetCollection emptydss = new DicomDataSetCollection();
    var dataset = new DicomDataSet();
    dataset.Add(Keyword.PerformedProtocolCodeSequence, emptydss);
    dataset.Add(Keyword.ProcedureCodeSequence, emptydss);
    dataset.Add(Keyword.PerformedSeriesSequence, emptydss);
    dataset.Add(Keyword.PerformedProcedureStepStatus, "IN PROGRESS");
    dataset.Add(Keyword.PerformedProcedureStepStartDate, "20240225");
    dataset.Add(Keyword.PerformedProcedureStepStartTime, "140000");
    
    cn.RequestedContexts.Add(SOPClasses.ModalityPerformedProcedureStep);
    cn.Open("localhost", 104, "callingAET", "calledAET");
    
    string sopClassUID = SOPClasses.ModalityPerformedProcedureStep;
    string instanceUID = "1.2.840.113619.2.55.3.604688745.703";
    cn.NCreate(sopClassUID, instanceUID, dataset);
    
    // List containing result status codes returned
    var moveStatus = cn.Status;
    // Result of last status code - 0 means success
    var status = cn.LastStatus;
    
    cn.Close();

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomAssociation Class
DicomAssociation Members

Send Feedback