Aspose.Medical DICOM til Text Converter for .NET Knowledge Base
Hvordan konvertere DICOM til XML og tilbake ved hjelp av DicomXmlSerializer

Hvordan konvertere DICOM til XML og tilbake ved hjelp av DicomXmlSerializer

Denne veiledningen viser hvordan du konverterer DICOM-filer til XML-format og deserialiserer XML tilbake til C#. XML formatet er foretrukket for integrasjon med arv systemer, HL7 arbeidsflyter, og miljøer der XML verktøy er godt etablert.

Når å bruke XML over JSON

  • • Legacy Integration *:- Det eksisterende mediumprogrammet og systemene forventer ofte XML-format.

  • *HL7 Kompatibilitet- Helsesystemer som bruker HL7 v2/v3 fungerer vanligvis med XML.

  • • XML verktøy:- Organisasjoner med etablerte XSLT transforms og XPath queries.

    • Skema Validasjon *:- XML-skjemaer gir strenge valideringsfunksjoner.

Forutsetninger: Å forberede miljøet

  • Installer Visual Studio eller noe kompatibelt .NET IDE.
  • Skap et nytt .NET 8 konsolapplikasjon prosjekt.
  • Installere Aspose.Medical fra NuGet Package Manager.

Step-by-Step Guide for å konvertere DICOM til XML

Steg 1: Installere Aspose.Medical

Legg til Aspose.Medical Library til prosjektet ditt ved hjelp av NuGet.

Install-Package Aspose.Medical

Steg 2: Inkludere nødvendige navnområder

Legg til referanser til de nødvendige navnene i koden din.

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;

Trinn 3: Last ned DICOM-filen

Last ned DICOM-filen du ønsker å konvertere.

DicomFile dcm = DicomFile.Open("patient_scan.dcm");

Steg 4: Serialisere til XML

Bruk den DicomXmlSerializer.Serialize Metode for å konvertere til XML.

string xml = DicomXmlSerializer.Serialize(dcm.Dataset);

Steg 5: Lagre XML-utgangen

Lagre XML til en fil for lagring eller overføring.

File.WriteAllText("patient_scan.xml", xml);

Steg 6: Deserialisere XML tilbake til Dataset

For å konvertere XML tilbake til DICOM, bruk Deserialize Metoden er.

Dataset? dataset = DicomXmlSerializer.Deserialize(xml);

Komplett kodeksempel: DICOM til XML konvertering

Her er et komplett eksempel på å konvertere DICOM til XML:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;

// Load DICOM file
DicomFile dcm = DicomFile.Open("patient_scan.dcm");

// Convert to XML
string xml = DicomXmlSerializer.Serialize(dcm.Dataset);

// Save to file
File.WriteAllText("patient_scan.xml", xml);

Console.WriteLine("DICOM converted to XML successfully!");
Console.WriteLine($"Output saved to: patient_scan.xml");

Komplett kodeksempel: XML til DICOM konvertering

Her er et komplett eksempel på å konvertere XML tilbake til DICOM:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;

// Read XML from file
string xml = File.ReadAllText("patient_scan.xml");

// Deserialize to Dataset
Dataset? dataset = DicomXmlSerializer.Deserialize(xml);

if (dataset != null)
{
    // Create DicomFile from Dataset
    DicomFile dcm = new DicomFile(dataset);
    
    // Save as DICOM file
    dcm.Save("reconstructed.dcm");
    
    Console.WriteLine("XML converted back to DICOM successfully!");
}
else
{
    Console.WriteLine("Failed to deserialize XML.");
}

Round-Trip Eksempel: DICOM → XML → DIKOM

Komplett rund-trip konvertering som demonstrerer data integritet:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;

// Load original DICOM file
DicomFile original = DicomFile.Open("original_scan.dcm");
Console.WriteLine("Original DICOM loaded.");

// Convert to XML
string xml = DicomXmlSerializer.Serialize(original.Dataset);
Console.WriteLine($"Converted to XML ({xml.Length} characters).");

// Save XML (for transmission or storage)
File.WriteAllText("intermediate.xml", xml);

// Later: Deserialize XML back to Dataset
string loadedXml = File.ReadAllText("intermediate.xml");
Dataset? reconstructedDataset = DicomXmlSerializer.Deserialize(loadedXml);

if (reconstructedDataset != null)
{
    // Create new DicomFile
    DicomFile reconstructed = new DicomFile(reconstructedDataset);
    reconstructed.Save("reconstructed_scan.dcm");
    
    Console.WriteLine("Round-trip complete: DICOM → XML → DICOM");
}

Eksempel på XML utgangsstruktur

XML-utgaven representerer DICOM-tegn i et strukturert format:

<?xml version="1.0" encoding="utf-8"?>
<NativeDicomModel>
  <DicomAttribute tag="00080005" vr="CS" keyword="SpecificCharacterSet">
    <Value number="1">ISO_IR 100</Value>
  </DicomAttribute>
  <DicomAttribute tag="00080020" vr="DA" keyword="StudyDate">
    <Value number="1">20240115</Value>
  </DicomAttribute>
  <DicomAttribute tag="00100010" vr="PN" keyword="PatientName">
    <PersonName number="1">
      <Alphabetic>
        <FamilyName>DOE</FamilyName>
        <GivenName>JOHN</GivenName>
      </Alphabetic>
    </PersonName>
  </DicomAttribute>
  <DicomAttribute tag="00100020" vr="LO" keyword="PatientID">
    <Value number="1">12345</Value>
  </DicomAttribute>
</NativeDicomModel>

Sammenligning av JSON vs XML Output

Storhet sammenligning 

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;

DicomFile dcm = DicomFile.Open("sample.dcm");

string json = DicomJsonSerializer.Serialize(dcm);
string xml = DicomXmlSerializer.Serialize(dcm.Dataset);

Console.WriteLine($"JSON size: {json.Length:N0} characters");
Console.WriteLine($"XML size: {xml.Length:N0} characters");
// XML is typically 20-40% larger than JSON

Bruker tilfelle anbefalinger

ScenarioAnbefalt format
Nye webtjenesterJSON
Legacy PACS integrasjonXML
HL7 mellomleddXML
JavaScript frontendeneJSON
XSLT transformasjonerXML
NoSQL databaserJSON
Validering av schemaXML

Integrasjon med Legacy-systemer

Eksempler på integrering med legacy middleware:

using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Serialization;
using System.Net.Http;
using System.Text;

DicomFile dcm = DicomFile.Open("patient_scan.dcm");
string xml = DicomXmlSerializer.Serialize(dcm.Dataset);

// Send to legacy SOAP service
using HttpClient client = new();
var content = new StringContent(xml, Encoding.UTF8, "application/xml");

HttpResponseMessage response = await client.PostAsync(
    "http://legacy-pacs/dicom/import",
    content
);

if (response.IsSuccessStatusCode)
{
    Console.WriteLine("XML successfully sent to legacy system!");
}

Troubleshooting

Behandling av Invalid XML

Wrap deserialization i try-catch for feilbehandling:

try
{
    Dataset? dataset = DicomXmlSerializer.Deserialize(xml);
    if (dataset == null)
    {
        Console.WriteLine("Deserialization returned null.");
    }
}
catch (System.Xml.XmlException ex)
{
    Console.WriteLine($"XML parsing error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Deserialization error: {ex.Message}");
}

Karakter koder spørsmål

Sørg for riktig koding når du leser/skriver XML-filer:

// Write with explicit encoding
using (StreamWriter writer = new StreamWriter("output.xml", false, Encoding.UTF8))
{
    writer.Write(xml);
}

// Read with explicit encoding
using (StreamReader reader = new StreamReader("input.xml", Encoding.UTF8))
{
    string xml = reader.ReadToEnd();
}

Store filhåndtering

For veldig store DICOM-filer, tenk på streaming:

using (FileStream fs = File.Create("large_output.xml"))
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8))
{
    string xml = DicomXmlSerializer.Serialize(dcm.Dataset);
    writer.Write(xml);
}

Ytterligere informasjon

  • XML-format gir bedre menneskelig lesbarhet med riktig indentasjon.
  • XML er mer verbøs enn JSON, noe som resulterer i større filstørrelser.
  • Overveie komprimering for lagring eller overføring av store XML-filer.
  • Både JSON og XML støtter de samme DICOM-datatyper og strukturer.

Conclusion

Denne veiledningen har vist hvordan å konvertere DICOM-filer til XML-format og deserialisere XML tilbake til DIKOM i C# ved hjelp av Aspose.Medical. XML serialisering er viktig for å integrere med legacy helsevesenet systemer og miljøer som er avhengig av XML verktøy og arbeidsflyter.

 Norsk