Document
Document()
إنشاء مستند Word فارغ.
public Document()
ملاحظات
حجم ورق المستند هو Letter بشكل افتراضي. إذا كنت تريد تغيير إعداد الصفحة، فاستخدم PageSetup
.
بعد الإنشاء، يمكنك استخدامDocumentBuilder
لإضافة محتوى المستند بسهولة.
أمثلة
يوضح كيفية تنسيق مجموعة من النص باستخدام خاصية الخط الخاصة به.
Document doc = new Document();
Run run = new Run(doc, "Hello world!");
Aspose.Words.Font font = run.Font;
font.Name = "Courier New";
font.Size = 36;
font.HighlightColor = Color.Yellow;
doc.FirstSection.Body.FirstParagraph.AppendChild(run);
doc.Save(ArtifactsDir + "Font.CreateFormattedRun.docx");
يوضح كيفية إنشاء المستندات وتحميلها.
// هناك طريقتان لإنشاء كائن مستند باستخدام Aspose.Words.
// 1 - إنشاء مستند فارغ:
Document doc = new Document();
// تأتي كائنات المستند الجديدة بشكل افتراضي مع الحد الأدنى من العقد
// مطلوب لبدء إضافة محتوى مثل النص والأشكال: قسم، ونص، وفقرة.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));
// 2 - تحميل مستند موجود في نظام الملفات المحلي:
doc = new Document(MyDir + "Document.docx");
// ستحتوي المستندات المحملة على محتويات يمكننا الوصول إليها وتحريرها.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());
// بعض العمليات التي يجب إجراؤها أثناء التحميل، مثل استخدام كلمة مرور لفك تشفير مستند،
// يمكن القيام بذلك عن طريق تمرير كائن LoadOptions عند تحميل المستند.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));
Assert.AreEqual("Test encrypted document.", doc.FirstSection.Body.FirstParagraph.GetText().Trim());
أنظر أيضا
- class Document
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
Document(string)
فتح مستند موجود من ملف. يكتشف تنسيق الملف تلقائيًا.
public Document(string fileName)
معامل | يكتب | وصف |
---|---|---|
fileName | String | اسم الملف للمستند الذي سيتم فتحه. |
استثناءات
استثناء | حالة |
---|---|
UnsupportedFileFormatException | لم يتم التعرف على تنسيق المستند أو أنه غير مدعوم. |
FileCorruptedException | يبدو أن المستند تالف ولا يمكن تحميله. |
Exception | توجد مشكلة في المستند ويجب إبلاغ مطوري Aspose.Words بها. |
IOException | هناك استثناء الإدخال/الإخراج. |
IncorrectPasswordException | المستند مشفر ويتطلب كلمة مرور لفتحه، ولكنك أدخلت كلمة مرور غير صحيحة. |
ArgumentException | لا يمكن أن يكون اسم الملف سلسلة فارغة أو فارغة. |
أمثلة
يوضح كيفية فتح مستند وتحويله إلى .PDF.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "Document.ConvertToPdf.pdf");
يوضح كيفية تحويل ملف PDF إلى ملف .docx.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
// قم بتحميل مستند PDF الذي حفظناه للتو، وقم بتحويله إلى .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.docx");
يوضح كيفية تحميل ملف PDF.
Aspose.Words.Document doc = new Aspose.Words.Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.LoadPdf.pdf");
// فيما يلي طريقتان لتحميل مستندات PDF باستخدام منتجات Aspose.
// 1 - تحميل كمستند Aspose.Words:
Aspose.Words.Document asposeWordsDoc = new Aspose.Words.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");
Assert.AreEqual("Hello world!", asposeWordsDoc.GetText().Trim());
// 2 - تحميل كمستند Aspose.Pdf:
Aspose.Pdf.Document asposePdfDoc = new Aspose.Pdf.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");
TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber();
asposePdfDoc.Pages.Accept(textFragmentAbsorber);
Assert.AreEqual("Hello world!", textFragmentAbsorber.Text.Trim());
أنظر أيضا
- class Document
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
Document(string, LoadOptions)
فتح مستند موجود من ملف. يسمح بتحديد خيارات إضافية مثل كلمة مرور التشفير.
public Document(string fileName, LoadOptions loadOptions)
معامل | يكتب | وصف |
---|---|---|
fileName | String | اسم الملف للمستند الذي سيتم فتحه. |
loadOptions | LoadOptions | خيارات إضافية لاستخدامها عند تحميل مستند. يمكن ان يكونباطل . |
استثناءات
استثناء | حالة |
---|---|
UnsupportedFileFormatException | لم يتم التعرف على تنسيق المستند أو أنه غير مدعوم. |
FileCorruptedException | يبدو أن المستند تالف ولا يمكن تحميله. |
Exception | توجد مشكلة في المستند ويجب إبلاغ مطوري Aspose.Words بها. |
IOException | هناك استثناء الإدخال/الإخراج. |
IncorrectPasswordException | المستند مشفر ويتطلب كلمة مرور لفتحه، ولكنك أدخلت كلمة مرور غير صحيحة. |
ArgumentException | لا يمكن أن يكون اسم الملف سلسلة فارغة أو فارغة. |
أمثلة
يوضح كيفية تحميل مستند Microsoft Word المشفر.
Document doc;
// Aspose.Words يطرح استثناءً إذا حاولنا فتح مستند مشفر بدون كلمة المرور الخاصة به.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));
// عند تحميل مثل هذا المستند، يتم تمرير كلمة المرور إلى مُنشئ المستند باستخدام كائن LoadOptions.
LoadOptions options = new LoadOptions("docPassword");
// هناك طريقتان لتحميل مستند مشفر باستخدام كائن LoadOptions.
// 1 - قم بتحميل المستند من نظام الملفات المحلي حسب اسم الملف:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - تحميل المستند من الدفق:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
doc = new Document(stream, options);
}
يوضح كيفية إنشاء المستندات وتحميلها.
// هناك طريقتان لإنشاء كائن مستند باستخدام Aspose.Words.
// 1 - إنشاء مستند فارغ:
Document doc = new Document();
// تأتي كائنات المستند الجديدة بشكل افتراضي مع الحد الأدنى من العقد
// مطلوب لبدء إضافة محتوى مثل النص والأشكال: قسم، ونص، وفقرة.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));
// 2 - تحميل مستند موجود في نظام الملفات المحلي:
doc = new Document(MyDir + "Document.docx");
// ستحتوي المستندات المحملة على محتويات يمكننا الوصول إليها وتحريرها.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());
// بعض العمليات التي يجب إجراؤها أثناء التحميل، مثل استخدام كلمة مرور لفك تشفير مستند،
// يمكن القيام بذلك عن طريق تمرير كائن LoadOptions عند تحميل المستند.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));
Assert.AreEqual("Test encrypted document.", doc.FirstSection.Body.FirstParagraph.GetText().Trim());
أنظر أيضا
- class LoadOptions
- class Document
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
Document(Stream)
فتح مستند موجود من الدفق. يكتشف تنسيق الملف تلقائيًا.
public Document(Stream stream)
معامل | يكتب | وصف |
---|---|---|
stream | Stream | دفق من أين سيتم تحميل المستند. |
استثناءات
استثناء | حالة |
---|---|
UnsupportedFileFormatException | لم يتم التعرف على تنسيق المستند أو أنه غير مدعوم. |
FileCorruptedException | يبدو أن المستند تالف ولا يمكن تحميله. |
Exception | توجد مشكلة في المستند ويجب إبلاغ مطوري Aspose.Words بها. |
IOException | هناك استثناء الإدخال/الإخراج. |
IncorrectPasswordException | المستند مشفر ويتطلب كلمة مرور لفتحه، ولكنك أدخلت كلمة مرور غير صحيحة. |
ArgumentNullException | لا يمكن أن يكون الدفق فارغًا. |
NotSupportedException | الدفق لا يدعم القراءة أو البحث. |
ObjectDisposedException | الدفق هو كائن تم التخلص منه. |
ملاحظات
يجب تخزين المستند في بداية الدفق. يجب أن يدعم الدفق تحديد المواقع العشوائية.
أمثلة
يوضح كيفية تحميل مستند باستخدام الدفق.
using (Stream stream = File.OpenRead(MyDir + "Document.docx"))
{
Document doc = new Document(stream);
Assert.AreEqual("Hello World!\r\rHello Word!\r\r\rHello World!", doc.GetText().Trim());
}
يوضح كيفية تحميل مستند من عنوان URL.
// قم بإنشاء عنوان URL الذي يشير إلى مستند Microsoft Word.
const string url = "https://filesamples.com/samples/document/docx/sample3.docx";
// قم بتنزيل المستند إلى مصفوفة بايت، ثم قم بتحميل هذا المصفوفة إلى مستند باستخدام دفق الذاكرة.
using (HttpClient webClient = new HttpClient())
{
byte[] dataBytes = await webClient.GetByteArrayAsync(url);
using (MemoryStream byteStream = new MemoryStream(dataBytes))
{
Document doc = new Document(byteStream);
// في هذه المرحلة، يمكننا قراءة محتويات المستند وتحريرها ثم حفظها في نظام الملفات المحلي.
Assert.AreEqual("There are eight section headings in this document. At the beginning, \"Sample Document\" is a level 1 heading. " +
"The main section headings, such as \"Headings\" and \"Lists\" are level 2 headings. " +
"The Tables section contains two sub-headings, \"Simple Table\" and \"Complex Table,\" which are both level 3 headings.",
doc.FirstSection.Body.Paragraphs[3].GetText().Trim());
doc.Save(ArtifactsDir + "Document.LoadFromWeb.docx");
}
}
أنظر أيضا
- class Document
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
Document(Stream, LoadOptions)
فتح مستند موجود من الدفق. يسمح بتحديد خيارات إضافية مثل كلمة مرور التشفير.
public Document(Stream stream, LoadOptions loadOptions)
معامل | يكتب | وصف |
---|---|---|
stream | Stream | الدفق الذي سيتم تحميل المستند منه. |
loadOptions | LoadOptions | خيارات إضافية لاستخدامها عند تحميل مستند. يمكن ان يكونباطل . |
استثناءات
استثناء | حالة |
---|---|
UnsupportedFileFormatException | لم يتم التعرف على تنسيق المستند أو أنه غير مدعوم. |
FileCorruptedException | يبدو أن المستند تالف ولا يمكن تحميله. |
Exception | توجد مشكلة في المستند ويجب إبلاغ مطوري Aspose.Words بها. |
IOException | هناك استثناء الإدخال/الإخراج. |
IncorrectPasswordException | المستند مشفر ويتطلب كلمة مرور لفتحه، ولكنك أدخلت كلمة مرور غير صحيحة. |
ArgumentNullException | لا يمكن أن يكون الدفق فارغًا. |
NotSupportedException | الدفق لا يدعم القراءة أو البحث. |
ObjectDisposedException | الدفق هو كائن تم التخلص منه. |
ملاحظات
يجب تخزين المستند في بداية الدفق. يجب أن يدعم الدفق تحديد المواقع العشوائية.
أمثلة
يوضح كيفية فتح مستند HTML يحتوي على صور من دفق باستخدام عنوان URI أساسي.
using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
// قم بتمرير URI للمجلد الأساسي أثناء تحميله
// بحيث يمكن العثور على أي صور ذات عناوين URI نسبية في مستند HTML.
LoadOptions loadOptions = new LoadOptions();
loadOptions.BaseUri = ImageDir;
Document doc = new Document(stream, loadOptions);
// تحقق من أن الشكل الأول للمستند يحتوي على صورة صالحة.
Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);
Assert.IsTrue(shape.IsImage);
Assert.IsNotNull(shape.ImageData.ImageBytes);
Assert.AreEqual(32.0, ConvertUtil.PointToPixel(shape.Width), 0.01);
Assert.AreEqual(32.0, ConvertUtil.PointToPixel(shape.Height), 0.01);
}
يوضح كيفية حفظ صفحة ويب كملف .docx.
const string url = "https://www.aspose.com/";
using (HttpClient client = new HttpClient())
{
var bytes = await client.GetByteArrayAsync(url);
using (MemoryStream stream = new MemoryStream(bytes))
{
// يتم استخدام عنوان URL مرة أخرى باعتباره BaseUri لضمان استرداد أي مسارات صور نسبية بشكل صحيح.
LoadOptions options = new LoadOptions(LoadFormat.Html, "", url);
// قم بتحميل مستند HTML من الدفق وتمرير كائن LoadOptions.
Document doc = new Document(stream, options);
// في هذه المرحلة، يمكننا قراءة محتويات المستند وتحريرها ثم حفظها في نظام الملفات المحلي.
doc.Save(ArtifactsDir + "Document.InsertHtmlFromWebPage.docx");
}
}
يوضح كيفية تحميل مستند Microsoft Word المشفر.
Document doc;
// Aspose.Words يطرح استثناءً إذا حاولنا فتح مستند مشفر بدون كلمة المرور الخاصة به.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));
// عند تحميل مثل هذا المستند، يتم تمرير كلمة المرور إلى مُنشئ المستند باستخدام كائن LoadOptions.
LoadOptions options = new LoadOptions("docPassword");
// هناك طريقتان لتحميل مستند مشفر باستخدام كائن LoadOptions.
// 1 - قم بتحميل المستند من نظام الملفات المحلي حسب اسم الملف:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - تحميل المستند من الدفق:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
doc = new Document(stream, options);
}
أنظر أيضا
- class LoadOptions
- class Document
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words