Các định danh thẻ DICOM có thể xuất hiện dưới các dạng khác nhau: một từ khóa như PatientName trong tệp cấu hình, hoặc một định danh thập lục phân như 00100010 trong đầu vào của người dùng. Việc chuyển đổi bất kỳ dạng nào sang đối tượng Tag cho phép ứng dụng C# của bạn làm việc với định danh thuộc tính trước khi sử dụng nó trong một thao tác dataset.

Trong hướng dẫn này, bạn sẽ sử dụng Aspose.Medical for .NET và Tag.TryParse để phân tích các từ khóa DICOM và các định danh thập lục phân. Bạn cũng sẽ tra cứu một từ khóa bằng TagDictionary.Default.FindByKeyword và kiểm tra mỗi kết quả trước khi sử dụng. Các ví dụ này giải quyết các định danh thẻ; chúng không mở tệp DICOM hoặc đọc giá trị bệnh nhân.

Cài đặt Aspose.Medical for .NET

Thêm Aspose.Medical for .NET vào dự án của bạn thông qua Console Trình quản lý gói của Visual Studio:

Install-Package Aspose.Medical

Ngoài ra, hãy chạy lệnh này từ thư mục dự án của bạn:

dotnet add package Aspose.Medical

Nhập không gian tên được sử dụng bởi cả ba ví dụ:

using Aspose.Medical.Dicom.Tags;

Các đoạn mã sử dụng cú pháp tham chiếu nullable (Tag?). Sử dụng một dự án C# hỗ trợ cú pháp này và bật nullable reference types nếu bạn muốn phân tích nullable. Kiểm tra yêu cầu target‑framework cho phiên bản gói đã cài đặt của bạn.

Không cần tệp DICOM đầu vào hoặc điểm cuối DICOMweb cho các tra cứu định danh này.

Phân tích thẻ DICOM từ từ khóa trong C#

Một từ khóa DICOM xác định một thuộc tính bằng tên chuẩn của nó. Ví dụ, PatientName xác định thuộc tính tên bệnh nhân.

Truyền từ khóa vào Tag.TryParse và kiểm tra giá trị trả về kiểu Boolean:

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

Khi việc phân tích thành công, tham số đầu ra chứa Tag đã được giải quyết, và chương trình in ra biểu diễn của nó. Trong ví dụ này, PatientName tương ứng với thẻ (0010,0010).

Kết quả xác định thuộc tính. Nó không chứa tên bệnh nhân. Để lấy giá trị đó, bạn cần đọc phần tử tương ứng từ một bộ dữ liệu DICOM.

Phân tích bộ định danh thẻ thập lục phân tám ký tự

Một thẻ DICOM có số nhóm và số phần tử. Đối với (0010,0010), 0010 đầu tiên là nhóm và 0010 thứ hai là phần tử. Chuỗi tám ký tự 00100010 kết hợp chúng mà không có dấu phân cách.

Sử dụng Tag.TryParse để giải quyết định danh thập lục phân đó:

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

Đầu vào này giải quyết thành cùng một thẻ như PatientName. Sử dụng cách tiếp cận này khi ứng dụng của bạn nhận các định danh thẻ ở dạng thập lục phân gọn như được hiển thị ở đây.

Kiểm tra giá trị trả về trước khi sử dụng tham số đầu ra. Nếu việc phân tích không thành công, hãy xử lý kết quả không thành công trong mã gọi của bạn thay vì tiếp tục như thể một thẻ đã được giải quyết. Đoạn mã chỉ in kết quả khi việc phân tích thành công; nó không hiển thị thông báo lỗi cho đầu vào không thành công.

Tra cứu thẻ DICOM bằng TagDictionary

Khi đầu vào của bạn là một từ khóa, bạn cũng có thể sử dụng TagDictionary.Default.FindByKeyword. Ví dụ sau tìm kiếm StudyDate và kiểm tra kết quả có thể 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}");
}

Chương trình in ra thẻ đã giải quyết chỉ khi found không phải là null. Kết quả xác định thuộc tính study-date; nó không trả về ngày được lưu trong một nghiên cứu cụ thể.

Chọn phương pháp dựa trên loại đầu vào mà ứng dụng của bạn chấp nhận:

Đầu vàoPhương thứcKiểm tra kết quả
Từ khóa hoặc định danh thập lục phân tám ký tựTag.TryParseKiểm tra giá trị trả về kiểu Boolean.
Từ khóa để tra cứu trong từ điểnTagDictionary.Default.FindByKeywordKiểm tra kết quả có null hay không.

Chạy các ví dụ và kiểm tra kết quả

Để chạy các đoạn mã trong một dự án console, đặt lệnh nhập không gian tên ở đầu tệp Program.cs, sau đó thêm ba ví dụ tra cứu bên dưới. Tên biến của chúng khác nhau, vì vậy chúng có thể xuất hiện trong cùng một phạm vi.

Chạy dự án từ thư mục của nó:

dotnet run

Hai ví dụ Tag.TryParse in ra các dòng bắt đầu bằng Tag:. Cả hai đều giải quyết định danh patient-name. Ví dụ từ điển in ra một dòng bắt đầu bằng Study Date tag: khi việc tra cứu thành công.

Đầu vàoThuộc tính đã giải quyết dự kiến
PatientNameTên bệnh nhân, (0010,0010)
00100010Tên bệnh nhân, (0010,0010)
StudyDateNgày nghiên cứu

Các câu lệnh console sử dụng nội suy chuỗi để hiển thị các đối tượng thẻ được trả về. Bảng mô tả kết quả tra cứu mong đợi thay vì quy định định dạng chính xác của văn bản đó.

Khắc phục lỗi phân tích thẻ DICOM

Kiểm tra từ khóa hoặc đầu vào thập lục phân

Bắt đầu với các đầu vào chính xác như được hiển thị trong các ví dụ. Đối với ví dụ hệ thập lục phân, sử dụng chuỗi tám ký tự 00100010. Đừng giả định rằng các dấu câu bổ sung, khoảng trắng, cách viết thay thế, hoặc việc sử dụng chữ hoa/thường khác nhau sẽ được chấp nhận mà không kiểm tra hành vi của phiên bản đã cài đặt.

Xử lý kết quả không thành công một cách rõ ràng

Các câu lệnh if trong các đoạn mã cố ý chỉ in ra kết quả thành công. Nếu chương trình của bạn không xuất ra bất kỳ kết quả nào, hãy kiểm tra xem TryParse có trả về false hay FindByKeyword có trả về null không. Thêm một thông báo phù hợp hoặc phản hồi xác thực cho người dùng của ứng dụng của bạn.

Giữ các định danh tách biệt khỏi các giá trị dữ liệu

Một thẻ PatientName đã được giải quyết xác định vị trí mà giá trị tên bệnh nhân thuộc về trong một bộ dữ liệu. Nó không khẳng định rằng một tệp cụ thể chứa thuộc tính đó hoặc rằng giá trị của nó đã được điền. Giữ việc phân tích đầu vào và truy cập giá trị bộ dữ liệu như các bước riêng biệt trong ứng dụng của bạn.

Kiểm tra các tham chiếu gói và không gian tên

Nếu không thể giải quyết Tag hoặc TagDictionary, hãy xác nhận rằng dự án đã tham chiếu Aspose.Medical và bao gồm using Aspose.Medical.Dicom.Tags;. Nếu một không gian tên khác cũng định nghĩa Tag, hãy sử dụng tên kiểu đầy đủ Aspose.Medical.Dicom.Tags.Tag để phân biệt.

Kết luận

Sử dụng Tag.TryParse khi một định danh thẻ có thể được cung cấp dưới dạng từ khóa hoặc chuỗi thập lục phân. Đối với việc tra cứu từ điển chỉ dựa trên từ khóa, hãy sử dụng TagDictionary.Default.FindByKeyword. Kiểm tra kết quả trước khi truyền thẻ đã giải quyết vào mã xử lý bộ dữ liệu của bạn.

For related APIs, see the tài liệu Aspose.Medical and tham chiếu API. If you need a license for evaluation, you can yêu cầu giấy phép tạm thời.

Câu hỏi thường gặp

Tag.TryParse có thể xử lý cả từ khóa và ID dạng thập lục phân không?

Có. Các ví dụ phân tích PatientName và định danh thập lục phân tám ký tự 00100010 thành các đối tượng Tag tương ứng. Cả hai đầu vào đều xác định cùng một thuộc tính.

Namespace nào tôi phải import để sử dụng Tag và TagDictionary?

Thêm using Aspose.Medical.Dicom.Tags; vào tệp C# của bạn.

Việc phân tích PatientName có lấy được tên của bệnh nhân không?

Không. Nó giải quyết định danh thuộc tính. Đọc giá trị của nó yêu cầu một bộ dữ liệu chứa thuộc tính đó và một thao tác truy cập giá trị riêng biệt.

Tôi nên làm gì khi TryParse trả về false?

Xử lý kết quả không thành công trước khi tiếp tục. Ví dụ, yêu cầu nhập lại dữ liệu đã chỉnh sửa hoặc trả về một thông báo xác thực. Không sử dụng đầu ra như một thẻ đã được giải quyết thành công.

Khi nào tôi nên sử dụng FindByKeyword thay vì TryParse?

Sử dụng FindByKeyword để tra cứu từ khóa dựa trên từ điển. Sử dụng TryParse khi đầu vào của bạn có thể là một từ khóa hoặc một định danh thập lục phân.

Đọc thêm