Ідентифікатори тегів DICOM можуть надходити у різних формах: ключове слово, наприклад PatientName, у файлі конфігурації, або шістнадцятковий ідентифікатор, наприклад 00100010, у вводі користувача. Перетворення будь‑якої форми у об’єкт Tag дозволяє вашому застосунку C# працювати з ідентифікатором атрибуту перед його використанням у операції з набором даних.

У цьому підручнику ви використаєте Aspose.Medical for .NET та Tag.TryParse для розбору ключових слів DICOM та шістнадцяткових ідентифікаторів. Ви також знайдете ключове слово за допомогою TagDictionary.Default.FindByKeyword і перевірите кожен результат перед його використанням. Ці приклади визначають ідентифікатори тегів; вони не відкривають файл DICOM і не читають дані пацієнта.

Встановити Aspose.Medical for .NET

Додайте Aspose.Medical for .NET до вашого проєкту через консоль менеджера пакетів Visual Studio:

Install-Package Aspose.Medical

Альтернативно, запустіть цю команду з каталогу вашого проєкту:

dotnet add package Aspose.Medical

Імпортуйте простір імен, який використовується у всіх трьох прикладах:

using Aspose.Medical.Dicom.Tags;

Фрагменти коду використовують синтаксис nullable‑reference (Tag?). Використовуйте проект C#, який підтримує цей синтаксис, і увімкніть nullable‑reference типи, якщо ви хочете аналіз nullable. Перевірте вимоги до цільового фреймворку для встановленої у вас версії пакета.

Для цих пошуків ідентифікаторів не потрібен вхідний файл DICOM або кінцева точка DICOMweb.

Розбір DICOM-тегу за ключовим словом у C#

Ключове слово DICOM ідентифікує атрибут, використовуючи його стандартну назву. Наприклад, PatientName ідентифікує атрибут імені пацієнта.

Передайте ключове слово у Tag.TryParse і перевірте булеве значення, що повертається:

// Parse a tag from a DICOM keyword
if (Tag.TryParse("PatientName", out Tag? patientNameTag))
{
    System.Console.WriteLine($"Tag: {patientNameTag}");
}

Коли розбір успішний, параметр output містить розв’язаний Tag, і програма виводить його представлення. У цьому прикладі PatientName відповідає тегу (0010,0010).

Результат ідентифікує атрибут. Він не містить ім’я пацієнта. Щоб отримати це значення, вам потрібно прочитати відповідний елемент з набору даних DICOM.

Розбір восьмисимвольного шістнадцяткового ідентифікатора тегу

Тег DICOM має номер групи та номер елемента. Для (0010,0010) перший 0010 — це група, а другий — елемент. Вісімсимвольний рядок 00100010 об’єднує їх без розділювача.

Використовуйте Tag.TryParse, щоб розв’язати цей шістнадцятковий ідентифікатор:

// Parse a tag from an eight-character hexadecimal identifier
if (Tag.TryParse("00100010", out Tag? hexTag))
{
    System.Console.WriteLine($"Tag: {hexTag}");
}

Цей ввід розв’язується до того ж самого тегу, що й PatientName. Використовуйте цей підхід, коли ваш застосунок отримує ідентифікатори тегів у компактній шістнадцятковій формі, показаній тут.

Перевірте значення, що повертається, перед використанням вихідного параметра. Якщо розбір не вдається, обробіть невдалий результат у вашому викликаючому коді, замість того, щоб продовжувати, ніби тег був розпізнаний. Фрагмент виводить результат лише коли розбір успішний; він не відображає повідомлення про помилку для невдалого вводу.

Пошук DICOM‑тегу за допомогою TagDictionary

Коли ваш вхід — це ключове слово, ви також можете використати TagDictionary.Default.FindByKeyword. Наступний приклад шукає StudyDate і перевіряє результат, який може бути null:

// Look up a tag by keyword in the dictionary
Tag? found = TagDictionary.Default.FindByKeyword("StudyDate");
if (found != null)
{
    System.Console.WriteLine($"Study Date tag: {found}");
}

Програма виводить розв’язаний тег лише тоді, коли found не дорівнює null. Результат ідентифікує атрибут study-date; він не повертає дату, збережену в конкретному дослідженні.

Виберіть метод відповідно до типу вхідних даних, які приймає ваш застосунок:

ВхідМетодПеревірка результату
Ключове слово або восьмисимвольний шістнадцятковий ідентифікаторTag.TryParseПеревірте булеве значення, що повертається.
Ключове слово для пошуку в словникуTagDictionary.Default.FindByKeywordПеревірте, чи результат є null.

Запустіть приклади та перевірте результати

Щоб запустити фрагменти коду в консольному проєкті, розмістіть імпорт простору імен у верхній частині Program.cs, а потім додайте три приклади пошуку під ним. Їхні імена змінних різні, тому вони можуть існувати в одному просторі видимості.

Запустіть проект з його каталогу:

dotnet run

Два приклади Tag.TryParse виводять рядки, що починаються з Tag:. Обидва розв’язують ідентифікатор patient-name. Приклад зі словником виводить рядок, що починається з Study Date tag:, коли його пошук успішний.

ВхідОчікуваний розв’язаний атрибут
PatientNameІм’я пацієнта, (0010,0010)
00100010Ім’я пацієнта, (0010,0010)
StudyDateДата дослідження

Консольні оператори використовують інтерполяцію рядків для відображення повернутих об’єктів тегів. Таблиця описує очікувані результати пошуку, а не задає точне форматування цього тексту.

Усунення проблем розбору тегів DICOM

Перевірте ключове слово або шістнадцятковий ввід

Починайте з точних вхідних даних, показаних у прикладах. Для прикладу з шістнадцятковим числом використовуйте восьмисимвольний рядок 00100010. Не припускайте, що додаткова пунктуація, пробіли, альтернативні написання або інший регістр приймаються без перевірки поведінки вашої встановленої версії.

Обробляйте неуспішні результати явно

if оператори у фрагментах навмисно виводять лише успішні результати. Якщо ваша програма не виводить нічого, перевірте, чи TryParse повернув false або FindByKeyword повернув null. Додайте відповідне повідомлення або відповідь валідації для користувача вашого застосунку.

Тримайте ідентифікатори окремо від значень набору даних

Вирішений PatientName тег визначає, де у наборі даних має знаходитись значення імені пацієнта. Це не встановлює, що конкретний файл містить цей атрибут або що його значення заповнене. Зберігайте розбір вхідних даних та доступ до значень набору даних як окремі кроки у вашому застосунку.

Перевірте посилання на пакети та простори імен

Якщо Tag або TagDictionary не можуть бути розв’язані, переконайтеся, що проєкт посилається на Aspose.Medical і включає using Aspose.Medical.Dicom.Tags;. Якщо інший імпортований простір імен також визначає Tag, використайте повністю кваліфіковану назву типу Aspose.Medical.Dicom.Tags.Tag, щоб розрізнити його.

Висновок

Використовуйте Tag.TryParse, коли ідентифікатор тегу може бути заданий як ключове слово або шістнадцятковий рядок. Для пошуку лише за ключовим словом у словнику використовуйте TagDictionary.Default.FindByKeyword. Перевірте результат перед тим, як передати розв’язаний тег у ваш код обробки набору даних.

Для пов’язаних API перегляньте Документація Aspose.Medical та довідник API. Якщо вам потрібна ліцензія для оцінки, ви можете запросити тимчасову ліцензію.

Поширені запитання

Чи може Tag.TryParse обробляти як ключові слова, так і шістнадцяткові ідентифікатори?

Так. Приклади розбирають PatientName та восьмисимвольний шістнадцятковий ідентифікатор 00100010 у відповідні об’єкти Tag. Обидва входи ідентифікують один і той самий атрибут.

Який простір імен потрібно імпортувати для використання Tag і TagDictionary?

Додайте using Aspose.Medical.Dicom.Tags; до вашого файлу C#.

Чи отримує розбір PatientName ім’я пацієнта?

Ні. Він визначає ідентифікатор атрибута. Читання його значення вимагає набору даних, що містить цей атрибут, і окремої операції доступу до значення.

Що робити, коли TryParse повертає false?

Обробіть невдалий результат перед продовженням. Наприклад, попросіть виправлені дані або поверніть повідомлення про валідацію. Не використовуйте вихідні дані як успішно вирішений тег.

Коли слід використовувати FindByKeyword замість TryParse?

Використовуйте FindByKeyword для пошуку за ключовим словом у словнику. Використовуйте TryParse, коли ваш вхід може бути або ключовим словом, або шістнадцятковим ідентифікатором.

Читати далі