Die Vorbereitung einer DICOMweb‑Anfrage oder -Antwort beginnt mit der Auswahl der Inhaltsdarstellung, die Ihr Endpunkt erwartet. Möglicherweise benötigen Sie Inhalte, die aus einer DICOM‑Datei erzeugt wurden, oder einen Datensatz, der als DICOM JSON serialisiert ist. Diese Darstellungen verwenden unterschiedliche Medientypen, sodass die Auswahl zur implementierten Operation passen muss.

In diesem Tutorial verwenden Sie Aspose.Medical for .NET, um beide Darstellungen in C# zu erzeugen. Sie laden eine lokale DICOM-Datei, erstellen Inhalte mit DicomWebContent.FromDicomFile und verwenden DicomWebContent.FromDataset, um DICOM‑JSON‑Inhalte aus dessen Datensatz zu erzeugen. Jeder Beispiel gibt den resultierenden Inhaltstyp aus, damit Sie ihn prüfen können, bevor Sie den Inhalt in einen HTTP‑Workflow integrieren.

Installieren Sie Aspose.Medical für .NET

Fügen Sie Aspose.Medical for .NET zu Ihrem Projekt hinzu, indem Sie die Package Manager Console von Visual Studio verwenden:

Install-Package Aspose.Medical

Alternativ führen Sie den folgenden Befehl aus Ihrem Projektverzeichnis aus:

dotnet add package Aspose.Medical

Verwenden Sie eine Paketversion, die die unten gezeigten Aspose.Medical.Dicom.Web‑APIs enthält. Überprüfen Sie Ihr Ziel‑Framework anhand der Anforderungen für diese Paketversion, anstatt anzunehmen, dass jede Veröffentlichung dieselben Frameworks unterstützt.

Bevor Sie eines der Beispiele ausführen, legen Sie eine lesbare DICOM‑Datei mit dem Namen image.dcm im Arbeitsverzeichnis Ihrer Anwendung ab oder ersetzen Sie den relativen Pfad durch den vollständigen Pfad Ihrer Datei. Diese Beispiele laufen lokal; Sie benötigen keinen DICOMweb‑Server, um die Inhaltsobjekte zu erstellen.

Wenn Sie die API mit einer Lizenz evaluieren müssen, können Sie eine temporäre Lizenz anfordern. Die Snippets konzentrieren sich auf die Inhaltserstellung und enthalten keine Lizenzinitialisierung.

DICOMweb-Inhalt aus einer DICOM-Datei erstellen

Verwenden Sie DicomWebContent.FromDicomFile, wenn Sie eine Inhaltsdarstellung einer geladenen DICOM-Datei benötigen.

  1. Öffnen Sie die Quelldatei mit DicomFile.Open.
  2. Übergeben Sie das resultierende DicomFile an DicomWebContent.FromDicomFile.
  3. Lesen Sie ContentType, um den Medientyp des generierten Inhalts zu prüfen.
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Web;

// Create content from a single DICOM file
DicomFile file = DicomFile.Open("image.dcm");
DicomWebContent fileContent = DicomWebContent.FromDicomFile(file);
System.Console.WriteLine($"Content type: {fileContent.ContentType}");

DicomFile.Open("image.dcm") lädt die Quelldatei. FromDicomFile(file) erstellt dann die binäre DICOM‑Inhaltsdarstellung. Der Medientyp für diese Darstellung ist application/dicom.

Dieses Beispiel erstellt das Content‑Objekt und schreibt dessen Inhaltstyp in die Konsole. Es speichert keine neue DICOM‑Datei und sendet den Inhalt nicht an einen Server.

DICOMweb JSON-Inhalt aus einem Datensatz generieren

Verwenden Sie DicomWebContent.FromDataset, wenn Sie Inhalte aus einem In‑Memory‑Datensatz erstellen möchten. Für DICOM‑JSON geben Sie application/dicom+json mit DicomWebMediaTypes.ApplicationDicomJson an.

Der Eingabe ist ein Dataset, nicht bereits ein serialisierter JSON‑String. In diesem Beispiel stammt das Dataset aus derselben lokalen DICOM‑Datei:

  1. Laden Sie image.dcm und greifen Sie auf file.Dataset zu.
  2. Erstellen Sie einen MediaTypeHeaderValue für DICOM JSON.
  3. Übergeben Sie das Dataset und den Medientyp an DicomWebContent.FromDataset.
  4. Untersuchen Sie den resultierenden ContentType.
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Web;

// Assume 'file' is a DicomFile loaded earlier
DicomFile file = DicomFile.Open("image.dcm");
Dataset dataset = file.Dataset;

// Create content from a dataset serialized as DICOM JSON
DicomWebContent jsonContent = DicomWebContent.FromDataset(
    dataset,
    new MediaTypeHeaderValue(DicomWebMediaTypes.ApplicationDicomJson));
System.Console.WriteLine($"JSON content type: {jsonContent.ContentType}");

file.Dataset stellt den Datensatz bereit, der zur Erstellung der JSON‑Darstellung verwendet wird. Der Aufruf von FromDataset liefert sowohl diesen Datensatz als auch den angeforderten Medientyp; Sie benötigen in diesem Beispiel keinen separaten JSON‑Serialisierungsschritt.

Die beiden Snippets sind unabhängig. Jeder lädt seine eigene Datei und deklariert eine Variable namens file. Wenn Sie sie zu einem einzigen Programm zusammenführen, behalten Sie die using‑Direktiven oben bei und verwenden die bereits vorhandene file‑Variable erneut.

Wählen Sie die Inhaltsdarstellung für Ihren HTTP-Workflow

Wählen Sie die Methode entsprechend der von Ihrer DICOMweb‑Operation benötigten Darstellung:

Eingabe und beabsichtigte DarstellungMethodeMedientyp
Geladene DICOM-Datei als binärer DICOM-InhaltDicomWebContent.FromDicomFile(file)application/dicom
Im Speicher befindlicher Datensatz als DICOM-JSON-InhaltDicomWebContent.FromDataset(dataset, mediaType)application/dicom+json

Das Erstellen beider Objekte ist ein lokaler Vorbereitungsschritt. Es lädt die Quelldatei nicht hoch, führt keine Abfrage aus und schließt keine DICOMweb‑Transaktion ab.

Wenn Sie den Inhalt in eine HTTP‑Anfrage oder -Antwort integrieren, beachten Sie die API‑ und Medientyp‑Anforderungen der Operation, die Sie implementieren. Die Snippets zeigen nicht die Konvertierung zu HttpContent, das Multipart‑Packaging, die Authentifizierung oder das Senden einer Anfrage mit HttpClient.

Beispiele ausführen und die Ergebnisse überprüfen

Führen Sie eines der Snippets in einer C#‑Konsolenanwendung aus, nachdem Sie das Paket installiert und image.dcm bereitgestellt haben. Wenn Sie ein Konsolenprojekt verwenden, platzieren Sie ein Snippet in Program.cs und führen Sie es aus:

dotnet run

Das dateibasierte Beispiel gibt eine Zeile aus, die mit Content type: beginnt. Das Dataset‑Beispiel gibt eine Zeile aus, die mit JSON content type: beginnt. Überprüfen Sie die angezeigten Medientypen gegenüber der von Ihnen angeforderten Darstellung:

BeispielErwarteter Medientyp
DICOM-Dateiinhaltapplication/dicom
Datensatz serialisiert als DICOM JSONapplication/dicom+json

Dies sind die erwarteten Media-Type‑Werte, kein Transkript eines ausgeführten Tests. Die Beispiele geben Inhalts‑Header aus; sie geben nicht die Binärdaten oder das serialisierte JSON aus.

Fehlerbehebung bei der DICOMweb-Inhaltserstellung

Überprüfen Sie den Eingabedateipfad

Der relative Pfad image.dcm wird aus dem Arbeitsverzeichnis der Anwendung aufgelöst. Wenn die Datei nicht geöffnet werden kann, überprüfen Sie ihren Speicherort, die Zugriffsberechtigungen und ob es sich um eine lesbare DICOM‑Datei handelt. Verwenden Sie einen absoluten Pfad, wenn sich das Arbeitsverzeichnis zwischen Ihrer IDE und Befehlszeilenaufrufen unterscheidet.

Bestätigen Sie, dass das installierte Paket die erforderlichen APIs bereitstellt

Wenn Aspose.Medical.Dicom.Web oder DicomWebContent nicht aufgelöst werden können, prüfen Sie die installierte Paketversion und deren API‑Verfügbarkeit. Das Hinzufügen einer using‑Anweisung macht eine API nicht verfügbar, wenn das referenzierte Paket sie nicht enthält.

Halten Sie den Datensatz und die JSON‑Eingaben getrennt

Das Dataset‑Beispiel übergibt file.Dataset direkt an FromDataset. Ersetzen Sie es nicht durch einen JSON‑String und gehen Sie nicht davon aus, dass dieselbe Überladung diese Eingabe akzeptiert. Das media-type‑Argument gibt die zu erstellende Darstellung an.

Überprüfen Sie die Zieloperation, bevor Sie Inhalte senden

Ein Inhaltsobjekt mit dem erwarteten Medientyp ist nur ein Teil eines HTTP‑Workflows. Bestätigen Sie den Zielendpunkt, die Anfragemethode, Header, Authentifizierung und etwaige Multipart‑Anforderungen, bevor Sie eine Send‑Operation hinzufügen. Ein erfolgreicher lokaler Aufruf zur Inhaltserzeugung bestätigt nicht, dass ein Server die endgültige Anfrage akzeptiert.

Fazit

Verwenden Sie FromDicomFile für Inhalte, die aus einer DICOM‑Datei generiert wurden, und FromDataset mit application/dicom+json für eine DICOM‑JSON‑Darstellung. Führen Sie das entsprechende Snippet mit Ihrer eigenen Datei aus, prüfen Sie ContentType und integrieren Sie anschließend den Inhalt in die von Ihrem Endpunkt erforderliche Anforderung oder Antwort.

Siehe die Aspose.Medical-Dokumentation und die API-Referenz für die zugehörige Konfiguration und API-Details.

Häufig gestellte Fragen

Was ist der Unterschied zwischen den beiden Methoden zur Inhaltserzeugung?

FromDicomFile erstellt Inhalt aus einer geladenen DICOM‑Datei. FromDataset erstellt eine Inhaltsdarstellung aus einem In‑Memory‑Datensatz unter Verwendung des bereitgestellten Medientyps. Dieses Tutorial verwendet Letzteres, um DICOM‑JSON‑Inhalt zu erzeugen.

Muss ich den Datensatz zuerst in JSON serialisieren?

Nein. Das Beispiel übergibt ein Dataset an FromDataset mit dem Medientyp application/dicom+json. Es nimmt keinen vorhandenen JSON‑String als Eingabe.

Welcher Medientyp wird für DICOM JSON‑Inhalte verwendet?

Verwenden Sie application/dicom+json, dargestellt im Beispiel durch DicomWebMediaTypes.ApplicationDicomJson.

Laden diese Beispiele eine DICOM-Datei auf einen Server hoch?

Nein. Sie erstellen Inhaltsobjekte lokal und geben deren Inhaltstypen aus. Das Senden des Inhalts erfordert zusätzlichen HTTP-Integrationscode.

Kann ich die beiden Beispiele in einem Programm kombinieren?

Ja. Behalten Sie die using‑Direktiven am Anfang bei und verwenden Sie die geladene DicomFile erneut, anstatt die Variable file zweimal im selben Gültigkeitsbereich zu deklarieren.

Mehr lesen