الفئة Notebook

Notebook class

يمثل دفتر ملاحظات Aspose.Note.

public class Notebook : IEnumerable<INotebookChildNode>, INotebookChildNode

المُنشئات

الاسمالوصف
Notebook()يُهيئ مثيلًا جديدًا من الفئة Notebook.
Notebook(Stream)يُهيئ مثيلًا جديدًا من الفئة Notebook. يفتح دفتر ملاحظات OneNote موجود من تدفق.
Notebook(string)يُهيئ مثيلًا جديدًا من الفئة Notebook. يفتح دفتر ملاحظات OneNote موجود من ملف.
Notebook(Stream, NotebookLoadOptions)يُهيئ مثيلًا جديدًا من الفئة Notebook. يفتح دفتر ملاحظات OneNote موجود من تدفق. يسمح بتحديد خيارات تحميل إضافية.
Notebook(string, NotebookLoadOptions)يُهيئ مثيلًا جديدًا من الفئة Notebook. يفتح دفتر ملاحظات OneNote موجود من ملف. يسمح بتحديد خيارات إضافية مثل استراتيجية تحميل العناصر الفرعية ("lazy"/instant).

الخصائص

الاسمالوصف
Color { get; set; }يحصل على اللون أو يضبطه.
Count { get; }يحصل على عدد العناصر الموجودة في Notebook.
DisplayName { get; set; }يحصل أو يضبط اسم العرض.
FileFormat { get; }يحصل على تنسيق الملف (OneNote 2010، OneNote Online).
Guid { get; }يحصل على المعرف الفريد عالميًا للكائن.
IsHistoryEnabled { get; set; }يحصل أو يضبط قيمة تشير إلى ما إذا كان السجل مفعلاً.
Item { get; }يحصل على عقدة الطفل للمفكرة وفق الفهرس المعطى.

الطرق

الاسمالوصف
AppendChild(INotebookChildNode)يضيف العقدة إلى نهاية القائمة.
GetChildNodes<T1>()احصل على جميع عقد الطفل حسب نوع العقدة.
GetEnumerator()يعيد عدادًا يتنقل عبر عقد الطفل في Notebook.
LoadChildDocument(Stream)يضيف عقدة وثيقة طفل. يفتح مستند OneNote موجود من تدفق.
LoadChildDocument(string)يضيف عقدة وثيقة طفل. يفتح مستند OneNote موجود من ملف.
LoadChildDocument(Stream, LoadOptions)يضيف عقدة وثيقة طفل. يفتح مستند OneNote موجود من تدفق. يسمح بتحديد خيارات تحميل إضافية.
LoadChildDocument(string, LoadOptions)يضيف عقدة وثيقة طفل. يفتح مستند OneNote موجود من ملف. يسمح بتحديد خيارات تحميل إضافية.
LoadChildNotebook(Stream)يضيف عقدة مفكرة طفل. يفتح مفكرة OneNote موجودة من تدفق.
LoadChildNotebook(string)يضيف عقدة مفكرة طفل. يفتح مفكرة OneNote موجودة من ملف.
LoadChildNotebook(Stream, NotebookLoadOptions)يضيف عقدة مفكرة طفل. يفتح مفكرة OneNote موجودة من تدفق. يسمح بتحديد خيارات تحميل إضافية.
LoadChildNotebook(string, NotebookLoadOptions)يضيف عقدة مفكرة طفل. يفتح مفكرة OneNote موجودة من ملف. يسمح بتحديد خيارات تحميل إضافية.
RemoveChild(INotebookChildNode)يزيل عقدة الطفل.
Save(Stream)يحفظ مستند OneNote إلى تدفق.
Save(string)يحفظ مستند OneNote إلى ملف.
Save(Stream, NotebookSaveOptions)يحفظ مستند OneNote إلى تدفق باستخدام خيارات الحفظ المحددة.
Save(Stream, SaveFormat)يحفظ مستند OneNote إلى تدفق بالتنسيق المحدد.
Save(string, NotebookSaveOptions)يحفظ مستند OneNote إلى ملف باستخدام خيارات الحفظ المحددة.
Save(string, SaveFormat)يحفظ مستند OneNote إلى ملف بالتنسيق المحدد.

أمثلة

يعرض كيفية حفظ المفكرة.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

var notebook = new Notebook();

dataDir = dataDir + "test_out.onetoc2";

// احفظ الدفتر
notebook.Save(dataDir);

يظهر كيفية حفظ الدفتر بصيغة PDF.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

dataDir = dataDir + "ConvertToPDF_out.pdf";

// احفظ الدفتر
notebook.Save(dataDir);

يظهر كيفية حفظ الدفتر كصورة.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

dataDir = dataDir + "ConvertToImage_out.png";

// احفظ الدفتر
notebook.Save(dataDir);

يظهر كيفية الحصول على كل النص من الدفتر.

string inputFile = "notebook.onetoc2";
string dataDir = RunExamples.GetDataDir_NoteBook();

Notebook rootNotebook = new Notebook(dataDir + inputFile);

IList<RichText> allRichTextNodes = rootNotebook.GetChildNodes<RichText>();
foreach (RichText richTextNode in allRichTextNodes)
{
    Console.WriteLine(richTextNode.Text);
}

يظهر كيفية حفظ دفتر مسطح بصيغة PDF.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

// احفظ الدفتر
dataDir = dataDir + "ConvertToPDFAsFlattened_out.pdf";
notebook.Save(
    dataDir,
    new NotebookPdfSaveOptions
    {
        Flatten = true
    });

يظهر كيفية التنقل عبر مستندات الدفتر وتحميلها بشكل كسول.

string inputFile = "Notebook.onetoc2";
string dataDir = RunExamples.GetDataDir_NoteBook();

// بشكل افتراضي، تحميل العناصر الفرعية هو "كسول".
Notebook notebook = new Notebook(dataDir + inputFile);

foreach (var notebookChildNode in notebook.OfType<Document>()) 
{
    // يحدث التحميل الفعلي للمستند الفرعي هنا فقط.
    // قم بعمل شيء مع المستند الفرعي
}

يظهر كيفية إضافة قسم جديد إلى الدفتر.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

// إلحاق عنصر فرعي جديد إلى الدفتر
notebook.AppendChild(new Document(dataDir + "Neuer Abschnitt 1.one"));

dataDir = dataDir + "AddChildNode_out.onetoc2";

// احفظ الدفتر
notebook.Save(dataDir);

يظهر كيفية تحميل الدفتر من تدفق.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

FileStream stream = new FileStream(dataDir + "Notebook.onetoc2", FileMode.Open);

var notebook = new Notebook(stream);

using (FileStream childStream = new FileStream(dataDir + "Aspose.one", FileMode.Open))
{
    notebook.LoadChildDocument(childStream);
}

notebook.LoadChildDocument(dataDir + "Sample1.one");

يظهر كيفية دفتر مشفر.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();
var notebook = new Notebook(dataDir + "test.onetoc2", new NotebookLoadOptions() { DeferredLoading = true });

notebook.LoadChildDocument(dataDir + "Aspose.one");  
notebook.LoadChildDocument(dataDir + "Locked Pass1.one", new LoadOptions() { DocumentPassword = "pass" });
notebook.LoadChildDocument(dataDir + "Locked Pass2.one", new LoadOptions() { DocumentPassword = "pass2" });

يظهر كيفية حفظ الدفتر كصورة مع خيارات محددة.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

var notebookSaveOptions = new NotebookImageSaveOptions(SaveFormat.Png);

var documentSaveOptions = notebookSaveOptions.DocumentSaveOptions;

documentSaveOptions.Resolution = 400;

dataDir = dataDir + "ConvertToImageWithOptions_out.png";

// احفظ الدفتر
notebook.Save(dataDir, notebookSaveOptions);

يظهر كيفية حفظ دفتر مسطح كصورة.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "Notebook.onetoc2");

var notebookSaveOptions = new NotebookImageSaveOptions(SaveFormat.Png);

var documentSaveOptions = notebookSaveOptions.DocumentSaveOptions;

documentSaveOptions.Resolution = 400;
notebookSaveOptions.Flatten = true;

dataDir = dataDir + "ConvertToImageAsFlattenedNotebook_out.png";

// احفظ الدفتر
notebook.Save(dataDir, notebookSaveOptions);

يظهر كيفية إزالة قسم من الدفتر.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_NoteBook();

// تحميل دفتر OneNote
var notebook = new Notebook(dataDir + "test.onetoc2");

// التنقل عبر العقد الفرعية للبحث عن العنصر الفرعي المطلوب
foreach (var child in new List<INotebookChildNode>(notebook))
{
    if (child.DisplayName == "Remove Me")
    {
        // إزالة العنصر الفرعي من الدفتر
        notebook.RemoveChild(child);
    }
}

dataDir = dataDir + "RemoveChildNode_out.onetoc2";

// احفظ الدفتر
notebook.Save(dataDir);

يظهر كيفية التنقل عبر المستندات المحملة مسبقًا للدفتر.

// بشكل افتراضي، تحميل العناصر الفرعية هو "كسول".
// لذلك، تم حدوث التحميل الفوري،
// من الضروري ضبط علم NotebookLoadOptions.InstantLoading.
NotebookLoadOptions loadOptions = new NotebookLoadOptions { InstantLoading = true };

String inputFile = "Notebook.onetoc2";
String dataDir = RunExamples.GetDataDir_NoteBook();
Notebook notebook = new Notebook(dataDir + inputFile, loadOptions);

// جميع المستندات الفرعية تم تحميلها بالفعل.
foreach (INotebookChildNode notebookChildNode in notebook.OfType<Document>()) 
{
   // قم بعمل شيء مع المستند الفرعي
}

يظهر كيفية المرور عبر محتوى الدفتر.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
string fileName = "Open Notebook.onetoc2";
try
{
    var notebook = new Notebook(dataDir + fileName);
    foreach (var notebookChildNode in notebook)
    {
        Console.WriteLine(notebookChildNode.DisplayName);
        if (notebookChildNode is Document)
        {
            // قم بعمل شيء مع المستند الفرعي
        }
        else if (notebookChildNode is Notebook)
        {
            // قم بعمل شيء مع دفتر فرعي
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

انظر أيضًا