Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion ocr/arabic/net/ocr-configuration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,8 @@ weight: 24
استفد من قدرات OCR القوية مع Aspose.OCR for .NET. استخراج النص من الصور بسلاسة.
### [OCROperation مع القائمة في التعرف على الصور باستخدام OCR](./ocr-operation-with-list/)
اكتشف إمكانات Aspose.OCR for .NET. تنفيذ التعرف على الصور باستخدام OCR مع القوائم بسهولة. عزّز الإنتاجية واستخراج البيانات في تطبيقاتك.
### [الحصول على إصدار Aspose OCR في C# – دليل كامل](./get-aspose-ocr-version-in-c-complete-guide/)
دليل شامل يوضح طريقة استخراج رقم إصدار Aspose OCR في تطبيق C# واستخدامه في بيئة .NET.

### حالات الاستخدام الشائعة
- **استخراج نصوص الصور** من الفواتير الممسوحة لأتمتة المحاسبة.
Expand Down Expand Up @@ -102,4 +104,4 @@ weight: 24
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}

{{< blocks/products/products-backtop-button >}}
{{< blocks/products/products-backtop-button >}}
Original file line number Diff line number Diff line change
@@ -0,0 +1,294 @@
---
category: general
date: 2026-06-03
description: احصل على نسخة Aspose OCR في C# باستخدام مقتطف بسيط. تعلم كيفية استرجاع
نسخة مكتبة Aspose OCR باستخدام OcrEngine GetVersion.
draft: false
keywords:
- get aspose ocr version
- aspose ocr library
- ocrengine getversion
- c# ocr example
- retrieve aspose version
language: ar
og_description: احصل على نسخة Aspose OCR في C# بسرعة. يوضح هذا الدرس بالضبط كيفية
استرجاع نسخة مكتبة Aspose OCR باستخدام OcrEngine GetVersion.
og_title: احصل على نسخة Aspose OCR في C# – الدليل الكامل
schemas:
- author: Aspose
dateModified: '2026-06-03'
description: Get Aspose OCR version in C# with a simple snippet. Learn how to retrieve
the Aspose OCR library version using OcrEngine GetVersion.
headline: Get Aspose OCR Version in C# – Complete Guide
type: TechArticle
- description: Get Aspose OCR version in C# with a simple snippet. Learn how to retrieve
the Aspose OCR library version using OcrEngine GetVersion.
name: Get Aspose OCR Version in C# – Complete Guide
steps:
- name: Why this matters
text: When you install the package, the assembly version on disk may differ from
the version reported by the library at runtime. Querying the version via code
ensures you’re reading the exact build that the CLR loaded, which is crucial
for debugging and for compliance audits.
- name: Expected output
text: 'When you run `dotnet run` inside the project folder, you should see something
similar to:'
- name: What if `GetVersion()` returns an empty string?
text: That usually signals a corrupted installation or a missing native dependency.
Re‑install the NuGet package and verify that the `Aspose.OCR.Native.dll` (or
the appropriate platform‑specific binary) sits alongside your executable.
- name: Does the method work on .NET Core 2.0?
text: Yes, **Aspose OCR** supports .NET Standard 2.0 and higher, so any .NET Core
version that implements that standard can call `OcrEngine.GetVersion()`. Just
make sure you reference the correct runtime identifiers (`win-x64`, `linux-x64`,
etc.) if you’re publishing a self‑contained app.
- name: Can I retrieve the version without a license file?
text: Absolutely. `GetVersion()` does **not** require a license; it simply reports
the library build number. However, if you attempt to perform OCR without a valid
license, you’ll get a runtime exception. That’s why the `try/catch` in our snippet
is valuable—it isolates the version check from the OCR exec
type: HowTo
tags:
- Aspose
- OCR
- C#
- .NET
title: احصل على نسخة Aspose OCR في C# – دليل كامل
url: /ar/net/ocr-configuration/get-aspose-ocr-version-in-c-complete-guide/
---

{{< blocks/products/pf/main-wrap-class >}}
{{< blocks/products/pf/main-container >}}
{{< blocks/products/pf/tutorial-page-section >}}

# احصل على نسخة Aspose OCR في C# – دليل كامل

هل تساءلت يومًا كيف **تحصل على نسخة Aspose OCR** من داخل مشروع .NET الخاص بك؟ ربما تحاول حل مشكلة عدم التوافق، أو تريد فقط تسجيل نسخة المكتبة الدقيقة التي تعمل في بيئة الإنتاج. مهما كان السبب، فقد وصلت إلى المكان الصحيح.

في هذا الدرس سنستعرض برنامج C# صغير ومستقل يستدعي `OcrEngine.GetVersion()` ويطبع النتيجة. بنهاية الدرس ستعرف ليس فقط *كيف* تسترجع النسخة، بل أيضًا *لماذا* فحص النسخة يمكن أن يوفر عليك المتاعب عند ترقية **مكتبة Aspose OCR**.

## ما ستتعلمه

- إضافة حزمة Aspose.OCR NuGet إلى مشروع C#
- استخدام طريقة `OcrEngine.GetVersion()` (نقطة الدخول **ocrengine getversion**)
- معالجة الاستثناءات المحتملة والتحقق من المخرجات
- توسيع المقتطف لسيناريوهات العالم الحقيقي مثل التسجيل أو تبديل الميزات الشرطية

لا تحتاج إلى خبرة سابقة في OCR — فقط فهم أساسي لـ C# و Visual Studio (أو بيئة التطوير المفضلة لديك). لنبدأ.

---

## الخطوة 1: إعداد المشروع وجلب مكتبة Aspose OCR

قبل أن تتمكن من استدعاء أي واجهات برمجة تطبيقات متعلقة بـ OCR، تحتاج إلى الإشارة إلى **مكتبة Aspose OCR** في مشروعك.

1. افتح الطرفية أو وحدة التحكم Package Manager Console في Visual Studio.
2. نفّذ الأمر التالي لتثبيت أحدث نسخة مستقرة:

```bash
dotnet add package Aspose.OCR
```

> **نصيحة احترافية:** إذا كنت تستهدف .NET Framework بدلاً من .NET Core، استخدم واجهة NuGet Package Manager UI واختر النسخة التي تتطابق مع بيئة التشغيل الخاصة بك. الحزمة تتضمن الفئة `OcrEngine` التي سنستخدمها لاحقًا.

### لماذا هذا مهم

عند تثبيت الحزمة، قد تختلف نسخة التجميع على القرص عن النسخة التي تُبلغ عنها المكتبة أثناء التشغيل. الاستعلام عن النسخة عبر الكود يضمن أنك تقرأ النسخة الدقيقة التي حمّلها CLR، وهو أمر حاسم للتصحيح ولتدقيق الامتثال.

---

## الخطوة 2: كتابة الكود الأدنى للحصول على **نسخة Aspose OCR**

أنشئ تطبيق console جديد (`dotnet new console -n OcrVersionDemo`) واستبدل ملف `Program.cs` الافتراضي بما يلي:

```csharp
using System;
using Aspose.OCR;

namespace OcrVersionDemo
{
class Program
{
static void Main()
{
try
{
// Step 2a: Retrieve the Aspose OCR library version.
// This is the core of the get aspose ocr version operation.
string version = OcrEngine.GetVersion(); // e.g., "24.5.7"

// Step 2b: Display the version information to the console.
Console.WriteLine($"Aspose OCR version: {version}");
}
catch (Exception ex)
{
// If something goes wrong (missing DLL, license issue, etc.)
Console.Error.WriteLine($"Failed to get Aspose OCR version: {ex.Message}");
}
}
}
}
```

**شرح كل جزء**

- `using Aspose.OCR;` يجلب مساحة الاسم OCR إلى النطاق، مما يسمح لنا باستدعاء `OcrEngine`.
- `OcrEngine.GetVersion()` هي الطريقة الساكنة **ocrengine getversion** التي تُعيد سلسلة مثل `"24.5.7"`.
- إحاطة الاستدعاء بكتلة `try/catch` تحميك من مفاجآت وقت التشغيل — ربما لا يتم العثور على الثنائيات الأصلية على الجهاز المستهدف.
- السلسلة المتداخلة `$"Aspose OCR version: {version}"` تطبع سطرًا واضحًا وقابلًا للقراءة للإنسان.

### النتيجة المتوقعة

عند تشغيل `dotnet run` داخل مجلد المشروع، يجب أن ترى شيئًا مشابهًا لـ:

```
Aspose OCR version: 24.5.7
```

إذا تعذر تحميل المكتبة، سيطبع فرع الخطأ رسالة مختصرة، تساعدك على تحديد المشكلة بسرعة.

---

## الخطوة 3: التحقق من أن النسخة تتطابق مع حزمة NuGet الخاصة بك

من السهل الافتراض أن نسخة NuGet التي قمت بتثبيتها هي النسخة المستخدمة أثناء التشغيل، لكن قد تتدخل خصوصيات البيئة. للتحقق مرة أخرى:

```csharp
// After retrieving the version, compare it to the package metadata.
var assembly = typeof(OcrEngine).Assembly;
var fileVersion = System.Diagnostics.FileVersionInfo.GetVersionInfo(assembly.Location).FileVersion;

Console.WriteLine($"Assembly file version: {fileVersion}");
```

تشغيل هذا المقتطف الإضافي سيطبع شيئًا مثل:

```
Assembly file version: 24.5.7.0
```

إذا اختلفت القيمتان، قد تكون تقوم بتحميل DLL أقدم من الـ Global Assembly Cache (GAC) أو من مجلد بناء سابق. في هذه الحالة، نظّف الحل (`dotnet clean`) وأعد بناءه.

---

## الخطوة 4: وضع فحص النسخة في سجلات الإنتاج

معظم التطبيقات في العالم الحقيقي لا تقوم فقط بطباعة إلى وحدة التحكم؛ بل تكتب إلى ملف سجل أو نظام تتبع. إليك مثال سريع باستخدام `Microsoft.Extensions.Logging`:

```csharp
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.DependencyInjection;

// Set up a minimal logger.
var serviceProvider = new ServiceCollection()
.AddLogging(builder => builder.AddConsole())
.BuildServiceProvider();

var logger = serviceProvider.GetService<ILogger<Program>>();

try
{
string version = OcrEngine.GetVersion();
logger.LogInformation("Aspose OCR version: {Version}", version);
}
catch (Exception ex)
{
logger.LogError(ex, "Unable to retrieve Aspose OCR version");
}
```

الآن تظهر النسخة في سجلاتك المنظمة، مما يجعل من السهل تصفية السجلات حسب `{Version}` لاحقًا. هذا النمط مفيد بشكل خاص عندما يكون لديك عدة خدمات مصغرة كل منها يجلب DLL OCR قد تكون مختلفة.

---

## أسئلة شائعة وحالات خاصة

### ماذا لو أعاد `GetVersion()` سلسلة فارغة؟

عادةً ما يشير ذلك إلى تثبيت معطوب أو اعتماد أصلي مفقود. أعد تثبيت حزمة NuGet وتأكد من أن `Aspose.OCR.Native.dll` (أو الملف الثنائي المناسب للمنصة) موجود بجوار الملف التنفيذي.

### هل تعمل الطريقة على .NET Core 2.0؟

نعم، **Aspose OCR** يدعم .NET Standard 2.0 وما فوق، لذا أي نسخة من .NET Core تطبق هذا المعيار يمكنها استدعاء `OcrEngine.GetVersion()`. فقط تأكد من الإشارة إلى معرفات وقت التشغيل الصحيحة (`win‑x64`, `linux‑x64`, إلخ) إذا كنت تنشر تطبيقًا مستقلًا.

### هل يمكنني استرجاع النسخة بدون ملف ترخيص؟

بالطبع. `GetVersion()` **لا** يتطلب ترخيصًا؛ فهو ببساطة يُبلغ عن رقم بناء المكتبة. ومع ذلك، إذا حاولت تنفيذ OCR بدون ترخيص صالح، ستحصل على استثناء وقت تشغيل. لهذا السبب فإن كتلة `try/catch` في المقتطف مفيدة — فهي تعزل فحص النسخة عن تدفق تنفيذ OCR.

---

## مثال كامل جاهز للنسخ واللصق

فيما يلي البرنامج بالكامل، جاهز للإدراج في مشروع console جديد. يتضمن كتلة التسجيل الاختيارية، بحيث يمكنك رؤية كل من مخرجات وحدة التحكم والسجلات المنظمة في العمل.

```csharp
using System;
using Aspose.OCR;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.DependencyInjection;

namespace OcrVersionDemo
{
class Program
{
static void Main()
{
// Set up a simple console logger.
var services = new ServiceCollection()
.AddLogging(builder => builder.AddConsole())
.BuildServiceProvider();

var logger = services.GetService<ILogger<Program>>();

try
{
// Retrieve the Aspose OCR library version.
string version = OcrEngine.GetVersion(); // get aspose ocr version

// Log and display the version.
logger.LogInformation("Aspose OCR version: {Version}", version);
Console.WriteLine($"Aspose OCR version: {version}");

// Extra verification – compare with assembly file version.
var assembly = typeof(OcrEngine).Assembly;
var fileVersion = System.Diagnostics.FileVersionInfo
.GetVersionInfo(assembly.Location).FileVersion;
logger.LogDebug("Assembly file version: {FileVersion}", fileVersion);
Console.WriteLine($"Assembly file version: {fileVersion}");
}
catch (Exception ex)
{
logger.LogError(ex, "Failed to get Aspose OCR version");
Console.Error.WriteLine($"Error: {ex.Message}");
}
}
}
}
```

شغّله باستخدام `dotnet run` وسترى سطرين يؤكدان النسخة، بالإضافة إلى سطر تصحيح إذا فعلت `LogLevel.Debug`.

---

## الخلاصة

لقد غطينا كل ما تحتاجه **للحصول على نسخة Aspose OCR** في بيئة C# — من تثبيت **مكتبة Aspose OCR**، واستدعاء طريقة **ocrengine getversion**، ومعالجة الأخطاء، إلى دمج النتيجة في سجلات الإنتاج. مسلحين بهذه المعرفة، يمكنك الآن التحقق بثقة من نسخة OCR الدقيقة التي يستخدمها تطبيقك، وتجنب الأخطاء المتعلقة بالنسخة، وتلبية متطلبات الامتثال دون عناء.

الخطوات التالية؟ جرّب ربط فحص النسخة باستدعاء OCR فعلي (`OcrEngine` → `RecognizeImage`) وسجّل كل من النسخة ونتيجة التعرف. يمكنك أيضًا استكشاف نمط **retrieve aspose version** للمنتجات الأخرى من Aspose (PDF, Slides, Cells) للحفاظ على تزامن مجموعة الأدوات بالكامل.

برمجة سعيدة، ولتظل خطوط أنابيب OCR حادة!

---

## ماذا يجب أن تتعلم بعد ذلك؟

الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات التي تم توضيحها في هذا الدليل. كل مورد يتضمن أمثلة كود كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك.

- [كيفية الحصول على نتائج OCR باستخدام Aspose.OCR لـ .NET](/ocr/english/net/text-recognition/get-recognition-result/)
- [استخراج نص الصورة C# مع اختيار اللغة باستخدام Aspose.OCR](/ocr/english/net/ocr-configuration/ocr-operation-with-language-selection/)
- [كيفية معالجة مجموعة من صور OCR باستخدام List في Aspose.OCR لـ .NET](/ocr/english/net/ocr-configuration/ocr-operation-with-list/)

{{< /blocks/products/pf/tutorial-page-section >}}
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}
{{< blocks/products/products-backtop-button >}}
2 changes: 2 additions & 0 deletions ocr/arabic/net/ocr-optimization/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,8 @@ weight: 25
حسّن دقة OCR مع Aspose.OCR for .NET. صحّح الأخطاء الإملائية، خصّص القواميس، واحصل على نص خالٍ من الأخطاء بسهولة.
### [حفظ النتيجة متعددة الصفحات كمستند في التعرف على الصور باستخدام OCR](./save-multipage-result-as-document/)
افتح إمكانات Aspose.OCR for .NET. احفظ نتائج OCR متعددة الصفحات كمستندات بسهولة من خلال هذا الدليل الشامل خطوة بخطوة.
### [مثال Aspose OCR C# – تمكين GPU، ضبط حد الذاكرة ومعالجة صور TIF](./aspose-ocr-c-example-enable-gpu-set-memory-limit-process-tif/)
تعلم كيفية تمكين معالجة GPU، ضبط حد الذاكرة ومعالجة ملفات TIF باستخدام Aspose OCR في C#.

## الأسئلة المتكررة

Expand Down
Loading