Aspose.Note for .NET ist eine funktionsreiche API zur Bearbeitung von OneNote Dokumenten, mit der Sie OneNote Dokumente programmgesteuert mit C# oder VB.NET erstellen, lesen und konvertieren können. In einem vorherigen Artikel haben wir die Verwendung von Aspose.Note for .NET zum Konvertieren, Lesen und Analysieren von OneNote Dokumenten behandelt. Heute sehen wir uns an, wie Sie OneNote Dokumente mit C# von Grund auf neu erstellen.
MS OneNote bietet Ihnen eine Möglichkeit, die Informationen in Form von digitalen Notizen (.ONE) zu organisieren und zu verwalten. Die Seiten in den OneNote Dokumenten werden verwendet, um den benutzerdefinierten Inhalt zu enthalten, der aus Text, Tabellen, Bildern, Listen usw. bestehen kann. In diesem Artikel behandeln wir alle grundlegenden Aspekte der Erstellung von Seiten und deren Inhalt in OneNote Dokumenten .
- Erstellen Sie ein leeres OneNote Dokument
- Seiten zum OneNote Dokument hinzufügen
- Einfügen von Bildern in OneNote Dokumente
- Tabelle in OneNote Dokumenten hinzufügen
- Fügen Sie Tags in OneNote Dokumenten hinzu
- Hyperlinks in OneNote Dokumente einfügen
OneNote Dokument (.ONE) mit C# erstellen
Beginnen wir damit, ein leeres OneNote Dokument nur mit einem Seitentitel zu erstellen. Im Folgenden sind die Schritte zum Erstellen des OneNote Dokuments mit einer leeren Seite und zum Speichern als .one Datei beschrieben.
- Erstellen Sie eine Instanz der Document Klasse.
- Erstellen Sie eine neue Seite, indem Sie das Page objekt mit dem Objekt der Document Klasse initialisieren.
- Legen Sie den Seitentitel mit der Page.Title-Eigenschaft fest.
- Rufen Sie die Document.AppendChild() methode auf und übergeben Sie das Page objekt.
- Speichern Sie schließlich das OneNote Dokument mit der methode Document.Save().
Das folgende Codebeispiel zeigt, wie Sie mit C# ein leeres OneNote Dokument erstellen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Aspose.Note.Document();
// Objekt der Page Klasse initialisieren
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Standardstil für den gesamten Text im Dokument.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// Seitentiteleigenschaften festlegen
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 }
};
// Seitenknoten im Dokument anhängen
doc.AppendChildLast(page);
dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// OneNote Dokument speichern
doc.Save(dataDir);
Hinzufügen von Seiten zu OneNote Dokumenten mit C#
In diesem Abschnitt gehen wir einen Schritt weiter und fügen der Seite im OneNote Dokument Text hinzu. Eine Seite im OneNote Dokument kann entweder die Hauptseite oder eine Unterseite sein. Sie erstellen beispielsweise einen Jahresbericht, der zusätzlich die Unterkapitel für die Monatsberichte enthält. In einem solchen Fall können Sie die Beschreibung des Berichts auf der Hauptseite und die Monatsberichte auf den Unterseiten platzieren. Im OneNote Dokument kann dies über die Seitenebenen gehandhabt werden.
Im Folgenden sind die Schritte zum Erstellen von Seiten in einem OneNote Dokument aufgeführt.
- Erstellen Sie ein neues OneNote Dokument mit der Document Klasse.
- Erstellen Sie neue Seiten für das Dokument und legen Sie deren Ebene mithilfe der Page Klasse fest.
- Verwenden Sie die Klassen Outline und OutlineElement, um Notizen zu erstellen.
- Fügen Sie den Seiten mit der methode Page.AppendChildLast() Notizen hinzu.
- Fügen Sie mithilfe der Methode Document.AppendChildLast() Seiten zu einem OneNote Dokument hinzu.
- Speichern Sie das Dokument mit der methode Document.Save().
Das folgende Codebeispiel zeigt, wie Sie mit C# Seiten zu OneNote Dokumenten erstellen und hinzufügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_Pages();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Document();
// Initialisieren Sie das Page Klassenobjekt und legen Sie seine Ebene fest
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// Initialisieren Sie das Page Klassenobjekt und legen Sie seine Ebene fest
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// Initialisieren Sie das Page Klassenobjekt und legen Sie seine Ebene fest
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 Dokument speichern
doc.Save(dataDir);
Einfügen von Bildern in OneNote Dokumente mit C#
Sie können auch Bilder in die OneNote-Seiten einfügen. Im Folgenden sind die Schritte zum Erstellen eines OneNote Dokuments mit Bildern aufgeführt.
- Erstellen Sie eine Instanz der Document Klasse für ein neues OneNote Dokument.
- Verwenden Sie die Page Klasse, um eine neue Seite für das Dokument zu erstellen.
- Erstellen Sie eine neue Instanz der Image Klasse und initialisieren Sie sie mit dem Pfad des Bilds.
- Fügen Sie der Seite mithilfe der Methode OutlineElement.AppendChildLast() ein Bild hinzu.
- Fügen Sie dem Dokument mithilfe der Methode Document.AppendChildLast() eine Seite hinzu.
- Speichern Sie das OneNote Dokument.
Das folgende Codebeispiel zeigt, wie Sie Bilder mit C# in das OneNote Dokument einfügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_Images();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Document();
// Objekt der Page Klasse initialisieren
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Initialisieren Sie das Outline Klassenobjekt und legen Sie die Offset eigenschaften fest
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// Initialisiert das OutlineElement Klassenobjekt
OutlineElement outlineElem = new OutlineElement(doc);
// Laden Sie ein Bild über den Dateipfad.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// Bildausrichtung festlegen
image.Alignment = HorizontalAlignment.Right;
// Bild hinzufügen
outlineElem.AppendChildLast(image);
// Gliederungselemente hinzufügen
outline.AppendChildLast(outlineElem);
// Gliederungsknoten hinzufügen
page.AppendChildLast(outline);
// Seitenknoten hinzufügen
doc.AppendChildLast(page);
dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// OneNote Dokument speichern
doc.Save(dataDir);
Hinzufügen von Tabellen zu OneNote Dokumenten mit C#
Tabellen sind eine gute Möglichkeit, die Daten in Form von Zeilen und Spalten zu organisieren und zusammenzufassen. Neben einer effizienten Organisation ermöglichen Tabellen das schnelle Auffinden der gewünschten Daten. OneNote Dokumente unterstützen auch Tabellen. Im Folgenden sind die Schritte zum Hinzufügen von Tabellen in OneNote Dokumenten aufgeführt.
- Erstellen Sie ein neues OneNote Dokument mit der Document Klasse.
- Erstellen Sie eine neue Seite mit der Page Klasse.
- Fügen Sie eine neue Tabellenzeile und Tabellenzellen mit den Klassen TableRow bzw. TableCell hinzu.
- Fügen Sie mithilfe der TableCell.AppendChildLast methode Elemente in die Tabellenzellen ein.
- Fügen Sie der Tabellenzeile mit der methode TableRow.AppendChildLast() Zellen hinzu.
- Erstellen Sie eine Instanz der Table Klasse und fügen Sie ihr eine Tabellenzeile hinzu.
- Fügen Sie die Tabelle mithilfe der Klassen OutlineElement und Outline zur Seite hinzu.
- Fügen Sie dem Dokument eine Seite hinzu und speichern Sie das Dokument mit der methode Document.Save().
Das folgende Codebeispiel zeigt, wie Sie dem OneNote Dokument mithilfe von C# eine Tabelle hinzufügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_Tables();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Document();
// Objekt der Page Klasse initialisieren
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Initialisiert das TableRow Klassenobjekt
TableRow row1 = new TableRow(doc);
// Objekte der TableCell Klasse initialisieren
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);
// Gliederungselemente in der Tabellenzelle anhängen
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// Tabellenzellen zu Zeilen
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);
// Initialisiert das TableRow Klassenobjekt
TableRow row2 = new TableRow(doc);
// Objekte der TableCell Klasse initialisieren
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);
// Gliederungselemente in der Tabellenzelle anhängen
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));
// Tabellenzellen an Zeilen anhängen
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);
// Tabellenklassenobjekt initialisieren und Spaltenbreiten festlegen
Table table = new Table(doc)
{
IsBordersVisible = true,
Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// Tabellenzeilen an Tabelle anhängen
table.AppendChildLast(row1);
table.AppendChildLast(row2);
// Outline objekt initialisieren
Outline outline = new Outline(doc);
// OutlineElement objekt initialisieren
OutlineElement outlineElem = new OutlineElement(doc);
// Tabelle zum Gliederungselementknoten hinzufügen
outlineElem.AppendChildLast(table);
// Gliederungselement zur Gliederung hinzufügen
outline.AppendChildLast(outlineElem);
// Gliederung zum Seitenknoten hinzufügen
page.AppendChildLast(outline);
// Seite zum Dokumentknoten hinzufügen
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);
Tags in OneNote Dokument mit C# einfügen
Tags werden verwendet, um die Notizen in OneNote Dokumenten zu kategorisieren oder zu priorisieren. Sie können Tags auf Text oder Absatz anwenden, um die zugehörigen Notizen schnell zu finden oder zu filtern. Im Folgenden finden Sie die Schritte zum Erstellen und Hinzufügen von Tags in OneNote Dokumenten.
- Erstellen Sie eine Instanz der Document Klasse.
- Erstellen Sie eine neue Seite mit der Page Klasse.
- Initialisiert Outline und OutlineElement objekte.
- Erstellen Sie ein neues RichText objekt und legen Sie seinen Text und andere Eigenschaften fest.
- Fügen Sie dem Text mit der methode RichText.Tags.Add() ein Tag hinzu.
- Fügen Sie der Seite Text hinzu.
- Seite zum OneNote Dokument hinzufügen und speichern.
Das folgende Codebeispiel zeigt, wie Tags zu Text in OneNote Dokumenten mit C# hinzugefügt werden.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_Tags();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Document();
// Objekt der Page Klasse initialisieren
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Objekt der Outline Klasse initialisieren
Outline outline = new Outline(doc);
// Initialisiert das OutlineElement Klassenobjekt
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,
});
// Textknoten hinzufügen
outlineElem.AppendChildLast(text);
// Gliederungselementknoten hinzufügen
outline.AppendChildLast(outlineElem);
// Gliederungsknoten hinzufügen
page.AppendChildLast(outline);
// Seitenknoten hinzufügen
doc.AppendChildLast(page);
dataDir = dataDir + "AddTextNodeWithTag_out.one";
// OneNote Dokument speichern
doc.Save(dataDir);
Hyperlinks in OneNote Dokument mit C# einfügen
Lassen Sie uns zu guter Letzt sehen, wie Sie mit den folgenden Schritten Hyperlinks zu den OneNote Dokumenten einfügen.
- Erstellen Sie eine Instanz der Document Klasse.
- Erstellen Sie mithilfe der Page Klasse eine neue Seite für das Dokument.
- Legen Sie den Textstil des Hyperlinks und seiner URL mithilfe der TextStyle Klasse fest.
- Erstellen Sie eine Instanz der RichText Klasse, fügen Sie ihren Text hinzu und initialisieren Sie sie mit dem zuvor erstellten Textstil für den Hyperlink.
- Fügen Sie der Seite des OneNote Dokuments Text hinzu.
- Speichern Sie das Dokument als .one Datei.
Das folgende Codebeispiel zeigt, wie Sie mit C# einen Hyperlink zum OneNote Dokument einfügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = RunExamples.GetDataDir_Tasks();
// Erstellen Sie ein Objekt der Document Klasse
Document doc = new Document();
// Objekt der Page Klasse initialisieren
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Titelklassenobjekt initialisieren
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);
// Gliederungselemente hinzufügen
outline.AppendChildLast(outlineElem);
// Gliederungsknoten hinzufügen
page.AppendChildLast(outline);
// Seitenknoten hinzufügen
doc.AppendChildLast(page);
dataDir = dataDir + "AddHyperlink_out.one";
// OneNote Dokument speichern
doc.Save(dataDir);
Fazit
In diesem Artikel haben Sie gelernt, wie Sie OneNote Dokumente (.ONE) mit C# von Grund auf neu erstellen. Darüber hinaus behandelte der Artikel auch das programmgesteuerte Einfügen von Seiten, Bildern, Tabellen, Tags und Hyperlinks in die OneNote Dokumente. Sie können die anderen interessanten Funktionen von Aspose.Note for .NET mithilfe der Dokumentation erkunden.