فایل OneNote را در سی شارپ ۲ ایجاد کنید

Aspose.Note for .NET یک API دستکاری اسناد OneNote غنی از ویژگی است که به شما امکان می دهد اسناد OneNote را به صورت برنامه نویسی با استفاده از C# یا VB.NET ایجاد کنید، بخوانید و تبدیل کنید. در یک مقاله قبلی، نحوه استفاده از Aspose.Note برای دات نت برای تبدیل، خواندن و تجزیه اسناد OneNote را توضیح دادیم. امروز، نحوه ایجاد اسناد OneNote را از ابتدا با استفاده از C# بررسی خواهیم کرد.

MS OneNote راهی برای سازماندهی و مدیریت اطلاعات در قالب یادداشت های دیجیتالی (.ONE) در اختیار شما قرار می دهد. صفحات موجود در اسناد 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();
// شیء کلاس Page را مقدار دهی اولیه کنید
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 آمده است.

  • با استفاده از کلاس Document یک سند OneNote جدید ایجاد کنید.
  • صفحات جدیدی برای سند ایجاد کنید و سطح آنها را با استفاده از Page class تنظیم کنید.
  • از کلاس های Outline و OutlineElement برای ایجاد یادداشت استفاده کنید.
  • با استفاده از روش Page.AppendChildLast () یادداشت ها را به صفحات اضافه کنید.
  • با استفاده از روش ()Document.AppendChildLast صفحاتی را به سند OneNote اضافه کنید.
  • سند را با استفاده از متد ()Document.Save ذخیره کنید.

نمونه کد زیر نحوه ایجاد و افزودن صفحات به اسناد OneNote با استفاده از C# را نشان می دهد.

// مسیر دایرکتوری اسناد
string dataDir = RunExamples.GetDataDir_Pages();

// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقداردهی اولیه کرده و سطح آن را تنظیم کنید
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// شیء کلاس Page را مقداردهی اولیه کرده و سطح آن را تنظیم کنید
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// شیء کلاس Page را مقداردهی اولیه کرده و سطح آن را تنظیم کنید
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 جدید ایجاد کنید.
  • از Page class برای ایجاد یک صفحه جدید برای سند استفاده کنید.
  • یک نمونه جدید از کلاس Image ایجاد کنید و آن را با مسیر تصویر مقداردهی اولیه کنید.
  • با استفاده از روش OutlineElement.AppendChildLast () تصویر را به صفحه اضافه کنید.
  • با استفاده از متد ()Document.AppendChildLast صفحه را به سند اضافه کنید.
  • سند OneNote را ذخیره کنید.

نمونه کد زیر نحوه درج تصاویر را با استفاده از C# به سند OneNote نشان می دهد.

// مسیر دایرکتوری اسناد
string dataDir = RunExamples.GetDataDir_Images();

// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقدار دهی اولیه کنید
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 آمده است.

  • با استفاده از کلاس Document یک سند OneNote جدید ایجاد کنید.
  • با استفاده از Page class یک صفحه جدید ایجاد کنید.
  • به ترتیب با استفاده از کلاس های TableRow و TableCell یک ردیف جدول و سلول های جدول جدید اضافه کنید.
  • با استفاده از روش TableCell.AppendChildLast عناصر را به سلول های جدول وارد کنید.
  • سلول ها را با استفاده از متد ()TableRow.AppendChildLast به ردیف جدول اضافه کنید.
  • یک نمونه از کلاس Table ایجاد کنید و ردیف جدول را به آن اضافه کنید.
  • جدول را با استفاده از کلاس های OutlineElement و Outline به صفحه اضافه کنید.
  • صفحه را به سند اضافه کنید و سند را با استفاده از متد ()Document.Save ذخیره کنید.

نمونه کد زیر نحوه افزودن جدول به سند OneNote را با استفاده از C# نشان می دهد.

// مسیر دایرکتوری اسناد
string dataDir = RunExamples.GetDataDir_Tables();

// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقدار دهی اولیه کنید
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 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 ایجاد کنید.
  • با استفاده از Page class یک صفحه جدید ایجاد کنید.
  • اشیاء Outline و OutlineElement را راه اندازی کنید.
  • یک شیء RichText جدید ایجاد کنید و متن و سایر خصوصیات آن را تنظیم کنید.
  • با استفاده از متد ()RichText.Tags.Add یک تگ به متن اضافه کنید.
  • متن را به صفحه اضافه کنید.
  • صفحه را به سند OneNote اضافه کنید و آن را ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن برچسب به متن در اسناد OneNote با استفاده از C# را نشان می دهد.

// مسیر دایرکتوری اسناد
string dataDir = RunExamples.GetDataDir_Tags();

// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقدار دهی اولیه کنید
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 وارد کنیم.

  • یک نمونه از کلاس Document ایجاد کنید.
  • با استفاده از Page class صفحه جدیدی برای سند ایجاد کنید.
  • با استفاده از کلاس TextStyle، سبک متن هایپرلینک و URL آن را تنظیم کنید.
  • یک نمونه از کلاس RichText ایجاد کنید، متن آن را اضافه کنید و آن را با سبک متنی که قبلا برای لینک ایجاد کرده اید مقداردهی اولیه کنید.
  • متن را به صفحه سند OneNote اضافه کنید.
  • سند را به صورت فایل .one ذخیره کنید.

نمونه کد زیر نحوه قرار دادن هایپرلینک به سند OneNote را با استفاده از C# نشان می دهد.

// مسیر دایرکتوری اسناد
string dataDir = RunExamples.GetDataDir_Tasks();

// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقدار دهی اولیه کنید
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) را از ابتدا با استفاده از سی شارپ یاد گرفتید. علاوه بر این، این مقاله همچنین نحوه درج صفحات، تصاویر، جداول، برچسب‌ها و پیوندها را به اسناد OneNote به صورت برنامه‌ریزی کرد. شما می توانید سایر ویژگی های جالب Aspose.Note را برای دات نت با استفاده از مستندات کاوش کنید.

مقالات مرتبط