Editor

Editor class

Classe principale, qui encapsule les méthodes de conversion. La classe Editor fournit des méthodes pour charger, modifier et enregistrer des documents de tous les formats pris en charge. Il est jetable, utilisez donc une directive ‘using’ ou supprimez ses ressources manuellement via l’appel de méthode ‘Dispose()’. Le chargement des documents est effectué via des constructeurs. Modification du document - via la méthode “Modifier” et enregistrement dans le document résultant après modification - via la méthode “Enregistrer”.

public sealed class Editor : IAuxDisposable

Constructeurs

Nom La description
Editor(Func<Stream>) Initialise la nouvelle instance de l’éditeur avec le document d’entrée spécifié (sous forme de flux)
Editor(string) Initialise la nouvelle instance de l’éditeur avec le document d’entrée spécifié (en tant que chemin de fichier complet)
Editor(Func<Stream>, Func<ILoadOptions>) Initialise la nouvelle instance de l’éditeur avec le document d’entrée spécifié (sous forme de flux) avec ses options de chargement
Editor(string, Func<ILoadOptions>) Initialise la nouvelle instance de l’éditeur avec le document d’entrée spécifié (en tant que chemin de fichier complet) avec ses options de chargement

Propriétés

Nom La description
IsDisposed { get; } Indique si cette instance de l’éditeur a déjà été supprimée et ne peut plus être utilisée (true) ou si elle n’a pas encore été supprimée et est donc active (false)

Méthodes

Nom La description
Dispose() Supprime cette instance d’Editor, afin qu’elle libère toutes les ressources internes et devienne indisponible pour une utilisation ultérieure
Edit() Ouvre un document précédemment chargé pour le modifier à l’aide des options par défaut en générant et renvoyant une instance de ‘EditableDocument classe, qui, à son tour, contient des méthodes pour produire le balisage HTML et les ressources associées.
Edit(IEditOptions) Ouvre un document précédemment chargé pour modification à l’aide d’options spécifiques au format spécifiées en générant et renvoyant une instance de ‘EditableDocument classe, qui, à son tour, contient des méthodes pour produire le balisage HTML et les ressources associées.
GetDocumentInfo(string) Renvoie les métadonnées sur le document, qui a été chargée dans cette instance ‘Editor’
Save(EditableDocument, Stream, ISaveOptions) Convertit le document modifié spécifié, représenté comme une instance de ‘EditableDocument , au document résultant du format spécifié et enregistre son contenu dans le stream spécifié
Save(EditableDocument, string, ISaveOptions) Convertit le document modifié spécifié, représenté comme une instance de ‘EditableDocument , au document résultant du format spécifié et enregistre son contenu dans le fichier par chemin de fichier spécifié

Événements

Nom La description
event Disposed Événement, qui se produit lorsque cette instance de l’éditeur est supprimée avec toutes ses ressources internes

Remarques

La classe Editor doit être considérée comme un point d’entrée et l’objet racine de GroupDocs.Editor. Toutes les opérations sont effectuées à l’aide de cette classe. L’utilisation typique de la classe Editor pour effectuer un pipeline d’édition de document complet est la suivante :

  1. Chargez un document dans l’instance de l’éditeur via son constructeur.
  2. En option, détectez un type de document à l’aide d’unGetDocumentInfo méthode.
  3. Ouvrez un document pour le modifier en appelant unEditméthode et obtenir une instance deEditableDocument classe de celui-ci.
  4. Modification du contenu d’un document côté client à l’aide de n’importe quel éditeur HTML WYSIWYG.
  5. Création d’une nouvelle instance deEditableDocument à partir du contenu du document modifié.
  6. Enregistrer un document édité dans un format de sortie en appelant unSave méthode.
  7. Disposer d’une instance de la classe Editor via l’opérateur ‘using’ ou manuellement.

Voir également

EditableDocument EncryptedException