צור מסמכי OneNote (.ONE) באופן פרוגרמטי ב-C#

Aspose.Note for .NET הוא API עשיר בתכונות OneNote למניפולציה של מסמכים המאפשר לך ליצור, לקרוא ולהמיר מסמכי OneNote באופן תכנותי באמצעות C# או VB.NET. במאמר קודם, סקרנו כיצד להשתמש ב-Aspose.Note עבור .NET כדי להמיר, לקרוא ולנתח מסמכי OneNote. היום, נבדוק כיצד ליצור מסמכי OneNote מאפס באמצעות C#.

MS OneNote מספקת לך דרך לארגן ולנהל את המידע בצורה של הערות דיגיטליות (.ONE). הדפים במסמכי OneNote משמשים להכיל את התוכן המוגדר על ידי המשתמש שעשוי להיות מורכב מטקסט, טבלאות, תמונות, רשימות וכו’. במאמר זה, נסקור את כל ההיבטים הבסיסיים של יצירת דפים והתוכן שלהם במסמכי OneNote .

צור מסמך OneNote ריק
הוסף דפים למסמך OneNote
הוסף תמונות למסמכי OneNote
הוסף טבלה במסמכי OneNote
הוסף תגים במסמכי OneNote
הוסף היפר-קישורים במסמכי OneNote

צור מסמך OneNote (.ONE) באמצעות C#

נתחיל ביצירת מסמך OneNote ריק עם כותרת עמוד בלבד. להלן השלבים ליצירת מסמך OneNote עם עמוד ריק ולשמור אותו כקובץ .one.

צור מופע של המחלקה Document.
צור עמוד חדש על-ידי אתחול אובייקט ה-Page עם האובייקט של המחלקה Document.
הגדר את כותרת העמוד באמצעות מאפיין Page.Title.
קראו לשיטת Document.AppendChild() והעבירו את האובייקט Page.
לבסוף, שמור את מסמך OneNote באמצעות שיטת Document.Save() .

דוגמת הקוד הבאה מראה כיצד ליצור מסמך OneNote ריק באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// צור אובייקט של המחלקה Document
Document doc = new Aspose.Note.Document();
// אתחול אובייקט מחלקת עמוד
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// סגנון ברירת מחדל עבור כל הטקסט במסמך.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// הגדר את מאפייני כותרת העמוד
page.Title = new Title(doc)
{
    TitleText = new RichText(doc) { Text = "Title text.", ParagraphStyle = textStyle },
    TitleDate = new RichText(doc) { Text = new DateTime(2011, 11, 11).ToString("D", CultureInfo.InvariantCulture), ParagraphStyle = textStyle },
    TitleTime = new RichText(doc) { Text = "12:34", ParagraphStyle = textStyle }
};
// הוסף צומת עמוד במסמך
doc.AppendChildLast(page);

dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// שמור מסמך OneNote
doc.Save(dataDir);

הוסף דפים למסמך OneNote באמצעות C#

בחלק זה, נלך צעד אחד קדימה ונוסיף טקסט לעמוד במסמך OneNote. עמוד במסמך OneNote יכול להיות העמוד הראשי או עמוד משנה. לדוגמה, אתה יוצר דוח שנתי המכיל עוד את סעיפי המשנה של הדוחות החודשיים. במקרה כזה, ניתן לשים את תיאור הדוח בעמוד הראשי ואת הדוחות החודשיים בדפי המשנה. במסמך OneNote, ניתן לטפל בכך באמצעות רמות העמוד.

להלן השלבים ליצירת דפים במסמך OneNote.

צור מסמך OneNote חדש באמצעות מחלקת Document.
צור דפים חדשים עבור המסמך והגדר את רמתם באמצעות מחלקת עמוד.
השתמש במחלקות Outline ו-OutlineElement כדי ליצור הערות.
הוסף הערות לדפים באמצעות שיטת Page.AppendChildLast()‎.
הוסף דפים למסמך OneNote באמצעות שיטת Document.AppendChildLast() .
שמור את המסמך באמצעות שיטת Document.Save() .

דוגמת הקוד הבאה מראה כיצד ליצור ולהוסיף דפים למסמכי OneNote באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Pages();

// צור אובייקט של המחלקה Document
Document doc = new Document();
// אתחול אובייקט מחלקת עמוד והגדר את רמתו
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// אתחול אובייקט מחלקת עמוד והגדר את רמתו
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// אתחול אובייקט מחלקת עמוד והגדר את רמתו
Aspose.Note.Page page3 = new Aspose.Note.Page(doc) { Level = 1 };

/*---------- Adding nodes to first Page ----------*/
Outline outline = new Outline(doc);
OutlineElement outlineElem = new OutlineElement(doc);
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
RichText text = new RichText(doc) { Text = "First page.", ParagraphStyle = textStyle };
outlineElem.AppendChildLast(text);
outline.AppendChildLast(outlineElem);
page1.AppendChildLast(outline);

/*---------- Adding nodes to second Page ----------*/
var outline2 = new Outline(doc);
var outlineElem2 = new OutlineElement(doc);
var textStyle2 = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
var text2 = new RichText(doc) { Text = "Second page.", ParagraphStyle = textStyle2 };
outlineElem2.AppendChildLast(text2);
outline2.AppendChildLast(outlineElem2);
page2.AppendChildLast(outline2);

/*---------- Adding nodes to third Page ----------*/
var outline3 = new Outline(doc);
var outlineElem3 = new OutlineElement(doc);
var textStyle3 = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
var text3 = new RichText(doc) { Text = "Third page.", ParagraphStyle = textStyle3 };
outlineElem3.AppendChildLast(text3);
outline3.AppendChildLast(outlineElem3);
page3.AppendChildLast(outline3);

/*---------- Add pages to the OneNote Document ----------*/
doc.AppendChildLast(page1);
doc.AppendChildLast(page2);
doc.AppendChildLast(page3);

dataDir = dataDir + "CreateDocWithRootAndSubPages_out.one";
// שמור מסמך OneNote
doc.Save(dataDir);

הוסף תמונות למסמך OneNote באמצעות C#

אתה יכול גם להוסיף תמונות לדפי OneNote. להלן השלבים ליצירת מסמך OneNote הכולל תמונות.

צור מופע של מחלקה Document עבור מסמך OneNote חדש.
השתמש במחלקת עמוד כדי ליצור עמוד חדש עבור המסמך.
צור מופע חדש של מחלקה Image ואתחול אותו עם הנתיב של התמונה.
הוסף תמונה לדף באמצעות שיטת OutlineElement.AppendChildLast().
הוסף עמוד למסמך באמצעות שיטת Document.AppendChildLast() .
שמור את מסמך OneNote.

דוגמת הקוד הבאה מראה כיצד להוסיף תמונות למסמך OneNote באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Images();

// צור אובייקט של המחלקה Document
Document doc = new Document();
// אתחול אובייקט מחלקת עמוד
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// אתחול אובייקט מחלקה Outline והגדר מאפייני היסט
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// אתחול אובייקט המחלקה OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// טען תמונה לפי נתיב הקובץ.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// הגדר יישור תמונה
image.Alignment = HorizontalAlignment.Right;
// להוסיף תמונה
outlineElem.AppendChildLast(image);
// הוסף רכיבי מתאר
outline.AppendChildLast(outlineElem);
// הוסף צומת Outline
page.AppendChildLast(outline);
// הוסף צומת עמוד
doc.AppendChildLast(page);

dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// שמור מסמך OneNote
doc.Save(dataDir);

הוסף טבלאות למסמך OneNote באמצעות C#

טבלאות הן דרך מצוינת לארגן ולסכם את הנתונים בצורה של שורות ועמודות. יחד עם ארגון יעיל, טבלאות מאפשרות לך לאתר את הנתונים הרצויים במהירות. מסמכי OneNote תומכים גם בטבלאות. להלן השלבים להוספת טבלאות במסמכי OneNote.

צור מסמך OneNote חדש באמצעות מחלקת Document.
צור דף חדש באמצעות מחלקת עמוד.
הוסף שורת טבלה חדשה ותאי טבלה באמצעות מחלקות TableRow ו-TableCell בהתאמה.
הכנס אלמנטים לתאי הטבלה באמצעות שיטת TableCell.AppendChildLast.
הוסף תאים לשורה בטבלה באמצעות שיטת TableRow.AppendChildLast() .
צור מופע של מחלקה Table והוסף לו שורת טבלה.
הוסף את הטבלה לדף באמצעות מחלקות OutlineElement ו-Outline.
הוסף עמוד למסמך ושמור את המסמך באמצעות שיטת Document.Save().

דוגמת הקוד הבאה מראה כיצד להוסיף טבלה למסמך OneNote באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Tables();

// צור אובייקט של המחלקה Document
Document doc = new Document();
// אתחול אובייקט מחלקת עמוד
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// אתחול אובייקט המחלקה TableRow
TableRow row1 = new TableRow(doc);
// אתחול אובייקטי מחלקה TableCell
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);

// הוסף רכיבי מתאר בתא הטבלה
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// טבלת תאים לשורות
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);

// אתחול אובייקט המחלקה TableRow
TableRow row2 = new TableRow(doc);
// אתחול אובייקטי מחלקה TableCell
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);

// הוסף רכיבי מתאר בתא הטבלה
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));

// הוסף תאי טבלה לשורות
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);

// אתחול אובייקט מחלקת טבלה והגדר רוחב עמודות
Table table = new Table(doc)
{
    IsBordersVisible = true,
    Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// הוסף שורות טבלה לטבלה
table.AppendChildLast(row1);
table.AppendChildLast(row2);

// אתחול אובייקט Outline
Outline outline = new Outline(doc);
// אתחול אובייקט OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// הוסף טבלה לצומת רכיב מתאר
outlineElem.AppendChildLast(table);
// הוסף רכיב מתאר למתאר
outline.AppendChildLast(outlineElem);
// הוסף קווי מתאר לצומת העמוד
page.AppendChildLast(outline);
// הוסף עמוד לצומת המסמך
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);

הוסף תגים במסמך OneNote באמצעות C#

תגים משמשים כדי לסווג או לתעדף את ההערות במסמכי OneNote. אתה יכול להחיל תגים על טקסט או פסקה כדי למצוא או לסנן במהירות את ההערות הקשורות. להלן השלבים ליצירה והוספה של תגים במסמכי OneNote.

צור מופע של מחלקה Document.
צור דף חדש באמצעות מחלקת עמוד.
אתחול אובייקטי Outline ו-OutlineElement.
צור אובייקט RichText חדש והגדר את הטקסט שלו ומאפיינים אחרים.
הוסף תג לטקסט באמצעות שיטת RichText.Tags.Add() .
הוסף טקסט לדף.
הוסף עמוד למסמך OneNote ושמור אותו.

דוגמת הקוד הבאה מראה כיצד להוסיף תגים לטקסט במסמכי OneNote באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Tags();

// צור אובייקט של המחלקה Document
Document doc = new Document();
// אתחול אובייקט מחלקת עמוד
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// אתחול אובייקט המחלקה Outline
Outline outline = new Outline(doc);
// אתחול אובייקט המחלקה OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
RichText text = new RichText(doc) { Text = "OneNote text.", ParagraphStyle = textStyle };
text.Tags.Add(new NoteTag
{
    Icon = TagIcon.YellowStar,
});

// הוסף צומת טקסט
outlineElem.AppendChildLast(text);
// הוסף צומת רכיב מתאר
outline.AppendChildLast(outlineElem);
// הוסף צומת מתאר
page.AppendChildLast(outline);
// הוסף צומת עמוד
doc.AppendChildLast(page);

dataDir = dataDir + "AddTextNodeWithTag_out.one";
// שמור מסמך OneNote
doc.Save(dataDir);

הוסף היפר-קישורים במסמך OneNote באמצעות C#

אחרון חביב, בואו נראה כיצד להכניס היפר-קישורים למסמכי OneNote באמצעות השלבים הבאים.

צור מופע של המחלקה Document.
צור עמוד חדש עבור המסמך באמצעות מחלקת עמוד.
הגדר את סגנון הטקסט של ההיפר-קישור ואת כתובת האתר שלו באמצעות המחלקה TextStyle.
צור מופע של מחלקה RichText, הוסף את הטקסט שלו ואתחול אותו בסגנון טקסט שנוצר בעבר עבור ההיפר-קישור.
הוסף טקסט לעמוד של מסמך OneNote.
שמור את המסמך כקובץ .one.

דוגמת הקוד הבאה מראה כיצד להוסיף היפר-קישור למסמך OneNote באמצעות C#.

// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Tasks();

// צור אובייקט של המחלקה Document
Document doc = new Document();
// אתחול אובייקט מחלקת עמוד
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// אתחול אובייקט מחלקה Title
Title title = new Title(doc);

ParagraphStyle defaultTextStyle = new ParagraphStyle
{
    FontName = "Arial",
    FontSize = 10,
    FontColor = SystemColors.WindowText
};
RichText titleText = new RichText(doc)
{
    Text = "Title!",
    ParagraphStyle = defaultTextStyle
};
Outline outline = new Outline(doc)
{
    MaxWidth = 200,
    MaxHeight = 200,
    VerticalOffset = 100,
    HorizontalOffset = 100
};
OutlineElement outlineElem = new OutlineElement(doc);
TextStyle textStyleRed = new TextStyle
{
    FontColor = Color.Red,
    FontName = "Arial",
    FontSize = 10,
    RunIndex = 8//this style will be applied to 0-7 characters.
};
TextStyle textStyleHyperlink = new TextStyle
{
    RunIndex = 17,//this style will be applied to 8-16 characters.
    IsHyperlink = true,
    HyperlinkAddress = "www.google.com"
};
RichText text = new RichText(doc)
{
    Text = "This is hyperlink. This text is not a hyperlink.",
    ParagraphStyle = defaultTextStyle,
    Styles = { textStyleRed, textStyleHyperlink }
};

title.TitleText = titleText;
page.Title = title;
outlineElem.AppendChildLast(text);
// הוסף רכיבי מתאר
outline.AppendChildLast(outlineElem);
// הוסף צומת Outline
page.AppendChildLast(outline);
// הוסף צומת עמוד
doc.AppendChildLast(page);

dataDir = dataDir + "AddHyperlink_out.one";
// שמור מסמך OneNote
doc.Save(dataDir);

סיכום

במאמר זה, למדת כיצד ליצור מסמכי OneNote (.ONE) מאפס באמצעות C#. יתר על כן, המאמר סיקר גם כיצד להוסיף דפים, תמונות, טבלאות, תגים והיפר-קישורים למסמכי OneNote באופן תוכנתי. אתה יכול לחקור את התכונות המעניינות האחרות של Aspose.Note עבור .NET באמצעות תיעוד.

מאמרים קשורים

המר וקרא קבצי Microsoft OneNote באמצעות C#

צור מסמך OneNote (.ONE) באמצעות C##

הוסף דפים למסמך OneNote באמצעות C##

הוסף תמונות למסמך OneNote באמצעות C##

הוסף טבלאות למסמך OneNote באמצעות C##

הוסף תגים במסמך OneNote באמצעות C##

הוסף היפר-קישורים במסמך OneNote באמצעות C##

סיכום#

מאמרים קשורים#