Editor
Editor class
Classe principale, che incapsula i metodi di conversione. La classe Editor fornisce metodi per caricare, modificare e salvare documenti di tutti i formati supportati. È usa e getta, quindi usa una direttiva ‘using’ o elimina le sue risorse manualmente tramite la chiamata al metodo ‘Dispose ()’. Il caricamento del documento viene eseguito tramite i costruttori. Modifica del documento - tramite il metodo “Modifica” e salvataggio nel documento risultante dopo la modifica - tramite il metodo “Salva”.
public sealed class Editor : IAuxDisposable
Costruttori
Nome |
Descrizione |
Editor(Func<Stream>) |
Inizializza la nuova istanza dell’Editor con il documento di input specificato (come flusso) |
Editor(string) |
Inizializza la nuova istanza dell’Editor con il documento di input specificato (come percorso file completo) |
Editor(Func<Stream>, Func<ILoadOptions>) |
Inizializza la nuova istanza dell’Editor con il documento di input specificato (come flusso) con le relative opzioni di caricamento |
Editor(string, Func<ILoadOptions>) |
Inizializza la nuova istanza dell’Editor con il documento di input specificato (come percorso file completo) con le relative opzioni di caricamento |
Proprietà
Nome |
Descrizione |
IsDisposed { get; } |
Indica se questa istanza dell’Editor è già stata eliminata e non può più essere utilizzata (true) oppure non è stata ancora eliminata ed è quindi attiva (false) |
Metodi
Nome |
Descrizione |
Dispose() |
Elimina questa istanza di Editor, in modo che rilasci tutte le risorse interne e diventi non disponibile per un ulteriore utilizzo |
Edit() |
Apre un documento caricato in precedenza per la modifica utilizzando le opzioni predefinite generando e restituendo un’istanza di ‘EditableDocument class, che, a sua volta, contiene metodi per produrre markup HTML e risorse associate. |
Edit(IEditOptions) |
Apre un documento caricato in precedenza per la modifica utilizzando le opzioni specifiche del formato specificate generando e restituendo un’istanza di ‘EditableDocument class, che, a sua volta, contiene metodi per produrre markup HTML e risorse associate. |
GetDocumentInfo(string) |
Restituisce i metadati relativi al documento, che è stato caricato in questa istanza “Editor” |
Save(EditableDocument, Stream, ISaveOptions) |
Converte il documento modificato specificato, rappresentato come istanza di ‘EditableDocument , nel documento risultante del formato specificato e ne salva il contenuto nello stream specificato |
Save(EditableDocument, string, ISaveOptions) |
Converte il documento modificato specificato, rappresentato come istanza di ‘EditableDocument , nel documento risultante del formato specificato e ne salva il contenuto nel file specificato percorso |
Eventi
Nome |
Descrizione |
event Disposed |
Evento, che si verifica quando questa istanza dell’Editor viene eliminata con tutte le sue risorse interne |
Osservazioni
La classe Editor deve essere considerata un punto di ingresso e l’oggetto radice di GroupDocs.Editor. Tutte le operazioni vengono eseguite utilizzando questa classe. L’utilizzo tipico della classe Editor per l’esecuzione di una pipeline completa di modifica dei documenti è il successivo:
- Carica un documento nell’istanza Editor tramite il suo costruttore.
- Facoltativamente, rilevare un tipo di documento utilizzando a
GetDocumentInfo
metodo.
- Apri un documento per la modifica chiamando an
Edit
metodo e ottenere un’istanza diEditableDocument
classe da esso.
- Modifica del contenuto di un documento sul lato client utilizzando qualsiasi editor HTML WYSIWYG.
- Creazione di una nuova istanza di
EditableDocument
dal contenuto del documento modificato.
- Salvataggio di un documento modificato in un formato di output chiamando a
Save
metodo.
- Smaltimento di un’istanza della classe Editor tramite l’operatore “using” o manualmente.
Guarda anche