Name
Contenuti
[
Nascondere
]Bookmark.Name property
Ottiene o imposta il nome del segnalibro.
public string Name { get; set; }
Osservazioni
Tieni presente che se modifichi il nome di un segnalibro con un nome già esistente nel documento, non verrà restituito alcun errore e solo il primo segnalibro verrà memorizzato quando salvi il documento.
Esempi
Mostra come inserire un segnalibro.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Un segnalibro valido ha un nome, un nodo BookmarkStart e un nodo BookmarkEnd.
// Eventuali spazi bianchi nei nomi dei segnalibri verranno convertiti in caratteri di sottolineatura se apriamo il documento salvato con Microsoft Word.
// Se evidenziamo il nome del segnalibro in Microsoft Word tramite Inserisci -> Collegamenti -> Aggiungi ai segnalibri e premi "Vai a",
// il cursore passerà al testo racchiuso tra i nodi BookmarkStart e BookmarkEnd.
builder.StartBookmark("My Bookmark");
builder.Write("Contents of MyBookmark.");
builder.EndBookmark("My Bookmark");
// I segnalibri vengono archiviati in questa raccolta.
Assert.AreEqual("My Bookmark", doc.Range.Bookmarks[0].Name);
doc.Save(ArtifactsDir + "Bookmarks.Insert.docx");
Mostra come aggiungere segnalibri e aggiornarne i contenuti.
public void CreateUpdateAndPrintBookmarks()
{
// Crea un documento con tre segnalibri, quindi utilizza un'implementazione personalizzata del visitatore del documento per stamparne il contenuto.
Document doc = CreateDocumentWithBookmarks(3);
BookmarkCollection bookmarks = doc.Range.Bookmarks;
PrintAllBookmarkInfo(bookmarks);
// È possibile accedere ai segnalibri nella raccolta di segnalibri tramite indice o nome e i relativi nomi possono essere aggiornati.
bookmarks[0].Name = $"{bookmarks[0].Name}_NewName";
bookmarks["MyBookmark_2"].Text = $"Updated text contents of {bookmarks[1].Name}";
// Stampa di nuovo tutti i segnalibri per vedere i valori aggiornati.
PrintAllBookmarkInfo(bookmarks);
}
/// <summary>
/// Crea un documento con un determinato numero di segnalibri.
/// </summary>
private static Document CreateDocumentWithBookmarks(int numberOfBookmarks)
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
for (int i = 1; i <= numberOfBookmarks; i++)
{
string bookmarkName = "MyBookmark_" + i;
builder.Write("Text before bookmark.");
builder.StartBookmark(bookmarkName);
builder.Write($"Text inside {bookmarkName}.");
builder.EndBookmark(bookmarkName);
builder.Writeln("Text after bookmark.");
}
return doc;
}
/// <summary>
/// Utilizza un iteratore e un visitatore per stampare le informazioni di ogni segnalibro nella raccolta.
/// </summary>
private static void PrintAllBookmarkInfo(BookmarkCollection bookmarks)
{
BookmarkInfoPrinter bookmarkVisitor = new BookmarkInfoPrinter();
// Fa in modo che ogni segnalibro nella raccolta accetti un visitatore che ne stamperà il contenuto.
using (IEnumerator<Bookmark> enumerator = bookmarks.GetEnumerator())
{
while (enumerator.MoveNext())
{
Bookmark currentBookmark = enumerator.Current;
if (currentBookmark != null)
{
currentBookmark.BookmarkStart.Accept(bookmarkVisitor);
currentBookmark.BookmarkEnd.Accept(bookmarkVisitor);
Console.WriteLine(currentBookmark.BookmarkStart.GetText());
}
}
}
}
/// <summary>
/// Stampa sulla console il contenuto di ogni segnalibro visitato.
/// </summary>
public class BookmarkInfoPrinter : DocumentVisitor
{
public override VisitorAction VisitBookmarkStart(BookmarkStart bookmarkStart)
{
Console.WriteLine($"BookmarkStart name: \"{bookmarkStart.Name}\", Contents: \"{bookmarkStart.Bookmark.Text}\"");
return VisitorAction.Continue;
}
public override VisitorAction VisitBookmarkEnd(BookmarkEnd bookmarkEnd)
{
Console.WriteLine($"BookmarkEnd name: \"{bookmarkEnd.Name}\"");
return VisitorAction.Continue;
}
}
Guarda anche
- class Bookmark
- spazio dei nomi Aspose.Words
- assemblea Aspose.Words