Crea una richiesta DICOMweb personalizzata in C# con l’API di basso livello SendAsync di Aspose.Medical. Questo tutorial è il companion lato client di Build a Custom DICOMweb Server with Aspose.Medical in C#. Quell tutorial crea e ospita il server e qui, un’applicazione console separata invia una query di studio QIDO‑RS al server e stampa i metadati restituiti.
Avvia il server
Crea il progetto DicomWebServer e usa il file Program.cs completo dal tutorial del server. Dal directory di quel progetto, avvia il server:
dotnet run -- --urls http://127.0.0.1:5000
Mantieni questo terminale in esecuzione. Il server espone il suo servizio Studies all’indirizzo http://127.0.0.1:5000/dicomweb/ e inserisce uno studio in memoria con questi valori:
| Attributo | Valore di semina |
|---|---|
| Nome del paziente | Doe^Jane |
| ID paziente | DEMO-001 |
| UID dell’istanza di studio | 1.2.826.0.1.3680043.10.999.1 |
Il client qui sotto ricerca per quel Study Instance UID. La modalità di valutazione può sostituire i valori demografici, quindi la query non dipende dal nome del paziente. Non è necessario caricare DICOM: il server crea lo studio sintetico all’avvio. I suoi dati sono tenuti in memoria e il seed viene ricreato ad ogni riavvio.
In un secondo terminale, verifica che il server risponda prima di creare il client:
curl.exe -H "Accept: application/dicom+json" "http://127.0.0.1:5000/dicomweb/studies?StudyInstanceUID=1.2.826.0.1.3680043.10.999.1&limit=5"
La risposta dovrebbe contenere uno studio con l’UID sopra. Questi sono metadati di studio sintetici, non un’immagine diagnostica.
Crea il progetto .NET 10
Usa lo stesso .NET 10 SDK e Aspose.Medical 26.10.0 del tutorial del server. Nel secondo terminale, crea un progetto client separato accanto a DicomWebServer e installa il pacchetto bloccato:
dotnet new console -n CustomDicomWebRequest -f net10.0
cd CustomDicomWebRequest
dotnet add package Aspose.Medical --version 26.10.0
Il progetto generato abilita gli usings impliciti e i tipi di riferimento nullable. Il suo file di progetto dovrebbe contenere:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Aspose.Medical" Version="26.10.0" />
</ItemGroup>
</Project>
Alternativa alla Console di Gestione dei Pacchetti
Per iniziare, aggiungi il pacchetto Aspose.Medical al tuo progetto .NET usando NuGet:
Install-Package Aspose.Medical
La pagina del prodotto e la documentazione sono disponibili ai seguenti link:
- Pagina del prodotto: https://products.aspose.com/medical/net/
- Documentazione: https://docs.aspose.com/medical/net/
Impostazioni di licenza e endpoint
Entrambi gli esempi caricano una licenza quando ASPOSE_MEDICAL_LICENSE contiene il percorso del file. Imposta quella variabile in ogni terminale sul tuo file di licenza prima di avviare l’applicazione corrispondente. L’analisi JSON DICOM lato client può essere limitata in modalità di valutazione anche quando il server restituisce HTTP 200; un’eccezione di licenza significa che il client non ha completato la lettura del risultato.
Il server companion non configura l’autenticazione, quindi lascia DICOMWEB_TOKEN non impostato per questo esempio locale. Se adatti il client a un endpoint che accetta un token bearer, imposta DICOMWEB_TOKEN su quel token. Altre configurazioni di autenticazione richiedono la corrispondente configurazione del trasporto.
Invia una Richiesta QIDO-RS Personalizzata Completa in C#
Sostituisci il file Program.cs del progetto client con il codice qui sotto. Per impostazione predefinita utilizza l’URI di base del server companion e lo Study Instance UID predefinito. Gli argomenti opzionali consentono di interrogare un altro servizio o studio.
Il programma richiede esplicitamente DICOM JSON, codifica l’UID in URL, richiede fino a cinque studi, verifica lo stato HTTP e rilascia la risposta in streaming. Se un attributo è assente, stampa (not returned).
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Tags;
using Aspose.Medical.Dicom.Web;
using Aspose.Medical.Dicom.Web.Transactions;
try
{
string? licensePath = Environment.GetEnvironmentVariable("ASPOSE_MEDICAL_LICENSE");
if (!string.IsNullOrWhiteSpace(licensePath))
new Aspose.Medical.License().SetLicense(licensePath);
using var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Accept.Add(
new MediaTypeWithQualityHeaderValue("application/dicom+json"));
string? token = Environment.GetEnvironmentVariable("DICOMWEB_TOKEN");
if (!string.IsNullOrWhiteSpace(token))
httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
var client = new DicomWebClient(httpClient, new DicomWebClientOptions
{
BaseUri = new Uri(args.Length > 0 ? args[0] : "http://127.0.0.1:5000/dicomweb/", UriKind.Absolute)
});
string studyUid = args.Length > 1 ? args[1] : "1.2.826.0.1.3680043.10.999.1";
var request = new DicomWebClientRequest(SearchStudies.Instance)
{
Query = DicomWebQueryParameters.Parse(
$"StudyInstanceUID={Uri.EscapeDataString(studyUid)}&limit=5")
};
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(30));
await using DicomWebClientResponse response = await client.SendAsync(request, timeout.Token);
response.EnsureSuccessStatusCode();
int count = 0;
await foreach (Dataset dataset in response.ReadDatasetsAsync(timeout.Token))
{
string name = dataset.GetValueOrDefault<string>(Tag.PatientName, 0, "(not returned)");
string uid = dataset.GetValueOrDefault<string>(Tag.StudyInstanceUID, 0, "(not returned)");
Console.WriteLine($"Patient: {name}, Study UID: {uid}");
count++;
}
Console.WriteLine($"Studies returned: {count}");
}
catch (Exception ex)
{
Console.Error.WriteLine($"{ex.GetType().Name}: {ex.Message}");
Environment.ExitCode = 1;
}
Esegui l’esempio
Con il server ancora in esecuzione, esegui questo comando da CustomDicomWebRequest:
dotnet run
Questo invia la stessa query di studio del precedente comando curl.exe. Con una licenza adeguata e il server companion appena avviato, l’output previsto è:
Patient: Doe^Jane, Study UID: 1.2.826.0.1.3680043.10.999.1
Studies returned: 1
La modalità di valutazione può modificare il nome del paziente visualizzato o impedire l’analisi JSON. Per fornire esplicitamente l’endpoint e lo studio, utilizzare:
dotnet run -- "http://127.0.0.1:5000/dicomweb/" "1.2.826.0.1.3680043.10.999.1"
Segui il flusso di richiesta e risposta
DicomWebClientRequest(SearchStudies.Instance) seleziona la transazione di ricerca di studio QIDO-RS. DicomWebQueryParameters.Parse fornisce StudyInstanceUID e limit=5; SendAsync invia quella richiesta con un token di cancellazione di 30 secondi a /dicomweb/studies sul server companion.
L’adattatore HTTP del server rimuove il prefisso /dicomweb e crea un DicomWebRequest lato server con il percorso /studies. Il suo DicomWebApplication.ProcessAsync invia la query al servizio Studies supportato da MemoryStudiesProvider. L’adattatore scrive la risposta indietro tramite HTTP affinché questo client la legga. DicomWebClientRequest è la descrizione della transazione lato client; DicomWebRequest è la rappresentazione lato server della richiesta HTTP in arrivo.
Dopo EnsureSuccessStatusCode(), ReadDatasetsAsync restituisce dataset per l’iterazione asincrona. Il ciclo legge Tag.PatientName e Tag.StudyInstanceUID, quindi stampa il numero totale di dataset restituiti. Questi sono risultati dei metadati dello studio, piuttosto che file immagine.
Una chiamata riuscita può restituire zero studi quando fornisci un UID che non è memorizzato sul server. Il client limit=5 richiede al massimo cinque risultati; il server companion imposta anche MaximumSearchResults = 100. Se il programma stampa un’eccezione ed esce con codice 1, la query non è stata completata; un’eccezione di licenza di valutazione non è un risultato di ricerca vuoto. Un errore di connessione significa che dovresti verificare che il server sia in esecuzione all’indirizzo configurato.
Conclusione
I due tutorial costituiscono un esempio completo di server e client locale: il tutorial complementare ospita il DICOMweb Studies Service e questa applicazione console interroga lo studio predefinito. Per personalizzare la richiesta, scegli una transazione supportata, fornisci i relativi parametri, chiama SendAsync e leggi il formato di risposta corrispondente.
Domande frequenti
Ho bisogno di un server DICOM per eseguire l’esempio? Sì. Avvia il server da Crea un server DICOMweb personalizzato in C# e lascialo in esecuzione su
http://127.0.0.1:5000/dicomweb/. Il client utilizza quell’endpoint per impostazione predefinita.Posso utilizzare questo approccio per altre transazioni DICOMweb? Utilizza una transazione supportata da
Aspose.Medical.Dicom.Web.Transactionse fornisci i parametri richiesti. La gestione della risposta deve corrispondere a quella transazione; l’iterazione del dataset è l’approccio mostrato per questa ricerca QIDO-RS.Come aggiungo le intestazioni di autenticazione alla richiesta? Imposta le
DefaultRequestHeadersdiHttpClient(ad es.,Authorization) prima di creare ilDicomWebClient; il client inoltrerà tali intestazioni con ogni richiesta.Qual è il formato restituito da
ReadDatasetsAsync?ReadDatasetsAsyncfornisce una sequenza di oggettiDatasetper l’iterazione asincrona conawait foreach. Ogni dataset contiene attributi DICOM che è possibile leggere per tag.Esiste un modo per limitare il numero di risultati restituiti?
Sì, includi un parametrolimitnella stringa di query quando costruisciDicomWebQueryParameters, ad esempio"limit=5".
