Document

Document()

Crée un document Word vierge.

public Document()

Remarques

Le format de papier du document est Lettre par défaut. Si vous souhaitez modifier la mise en page, use PageSetup.

Après la création, vous pouvez utiliserDocumentBuilder pour ajouter facilement du contenu à un document.

Exemples

Montre comment formater une séquence de texte à l’aide de sa propriété font.

Document doc = new Document();
Run run = new Run(doc, "Hello world!");

Aspose.Words.Font font = run.Font;
font.Name = "Courier New";
font.Size = 36;
font.HighlightColor = Color.Yellow;

doc.FirstSection.Body.FirstParagraph.AppendChild(run);
doc.Save(ArtifactsDir + "Font.CreateFormattedRun.docx");

Montre comment créer et charger des documents.

// Il existe deux manières de créer un objet Document à l'aide d'Aspose.Words.
// 1 - Créer un document vierge :
Document doc = new Document();

// Les nouveaux objets Document sont livrés par défaut avec l'ensemble minimal de nœuds
// requis pour commencer à ajouter du contenu tel que du texte et des formes : une section, un corps et un paragraphe.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Charge un document qui existe dans le système de fichiers local :
doc = new Document(MyDir + "Document.docx");

// Les documents chargés auront un contenu auquel nous pourrons accéder et modifier.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Certaines opérations qui doivent avoir lieu lors du chargement, comme l'utilisation d'un mot de passe pour décrypter un document,
// peut être effectué en passant un objet LoadOptions lors du chargement du document.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

Assert.AreEqual("Test encrypted document.", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

Voir également


Document(string)

Ouvre un document existant à partir d’un fichier. Détecte automatiquement le format de fichier.

public Document(string fileName)
ParamètreTaperLa description
fileNameStringNom de fichier du document à ouvrir.

Exceptions

exceptioncondition
UnsupportedFileFormatExceptionLe format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedExceptionLe document semble corrompu et ne peut pas être chargé.
ExceptionIl y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOExceptionIl existe une exception d’entrée/sortie.
IncorrectPasswordExceptionLe document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentExceptionLe nom du fichier ne peut pas être nul ou une chaîne vide.

Exemples

Montre comment ouvrir un document et le convertir en .PDF.

Document doc = new Document(MyDir + "Document.docx");

doc.Save(ArtifactsDir + "Document.ConvertToPdf.pdf");

Montre comment convertir un PDF en .docx.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Hello world!");

doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");

// Chargez le document PDF que nous venons d'enregistrer et convertissez-le en .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");

pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.docx");

Montre comment charger un PDF.

Aspose.Words.Document doc = new Aspose.Words.Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Hello world!");

doc.Save(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

// Vous trouverez ci-dessous deux façons de charger des documents PDF à l'aide des produits Aspose.
// 1 - Charger en tant que document Aspose.Words :
Aspose.Words.Document asposeWordsDoc = new Aspose.Words.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

Assert.AreEqual("Hello world!", asposeWordsDoc.GetText().Trim());

// 2 - Charger en tant que document Aspose.Pdf :
Aspose.Pdf.Document asposePdfDoc = new Aspose.Pdf.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber();
asposePdfDoc.Pages.Accept(textFragmentAbsorber);

Assert.AreEqual("Hello world!", textFragmentAbsorber.Text.Trim());

Voir également


Document(string, LoadOptions)

Ouvre un document existant à partir d’un fichier. Permet de spécifier des options supplémentaires telles qu’un mot de passe de cryptage.

public Document(string fileName, LoadOptions loadOptions)
ParamètreTaperLa description
fileNameStringNom de fichier du document à ouvrir.
loadOptionsLoadOptionsOptions supplémentaires à utiliser lors du chargement d’un document. Peut êtrenul.

Exceptions

exceptioncondition
UnsupportedFileFormatExceptionLe format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedExceptionLe document semble corrompu et ne peut pas être chargé.
ExceptionIl y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOExceptionIl existe une exception d’entrée/sortie.
IncorrectPasswordExceptionLe document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentExceptionLe nom du fichier ne peut pas être nul ou une chaîne vide.

Exemples

Montre comment charger un document Microsoft Word chiffré.

Document doc;

// Aspose.Words lève une exception si nous essayons d'ouvrir un document crypté sans son mot de passe.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Lors du chargement d'un tel document, le mot de passe est transmis au constructeur du document à l'aide d'un objet LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Il existe deux manières de charger un document chiffré avec un objet LoadOptions.
// 1 - Chargez le document depuis le système de fichiers local par nom de fichier :
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Charge le document depuis un flux :
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Montre comment créer et charger des documents.

// Il existe deux manières de créer un objet Document à l'aide d'Aspose.Words.
// 1 - Créer un document vierge :
Document doc = new Document();

// Les nouveaux objets Document sont livrés par défaut avec l'ensemble minimal de nœuds
// requis pour commencer à ajouter du contenu tel que du texte et des formes : une section, un corps et un paragraphe.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Charge un document qui existe dans le système de fichiers local :
doc = new Document(MyDir + "Document.docx");

// Les documents chargés auront un contenu auquel nous pourrons accéder et modifier.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Certaines opérations qui doivent avoir lieu lors du chargement, comme l'utilisation d'un mot de passe pour décrypter un document,
// peut être effectué en passant un objet LoadOptions lors du chargement du document.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

Assert.AreEqual("Test encrypted document.", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

Voir également


Document(Stream)

Ouvre un document existant à partir d’un flux. Détecte automatiquement le format de fichier.

public Document(Stream stream)
ParamètreTaperLa description
streamStreamDiffusez à partir duquel charger le document.

Exceptions

exceptioncondition
UnsupportedFileFormatExceptionLe format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedExceptionLe document semble corrompu et ne peut pas être chargé.
ExceptionIl y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOExceptionIl existe une exception d’entrée/sortie.
IncorrectPasswordExceptionLe document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentNullExceptionLe flux ne peut pas être nul.
NotSupportedExceptionLe flux ne prend pas en charge la lecture ou la recherche.
ObjectDisposedExceptionLe flux est un objet supprimé.

Remarques

Le document doit être stocké au début du flux. Le flux doit prendre en charge le positionnement aléatoire.

Exemples

Montre comment charger un document à l’aide d’un flux.

using (Stream stream = File.OpenRead(MyDir + "Document.docx"))
{
    Document doc = new Document(stream);

    Assert.AreEqual("Hello World!\r\rHello Word!\r\r\rHello World!", doc.GetText().Trim());
}

Montre comment charger un document à partir d’une URL.

// Crée une URL qui pointe vers un document Microsoft Word.
const string url = "https://filesamples.com/samples/document/docx/sample3.docx" ;

// Téléchargez le document dans un tableau d'octets, puis chargez ce tableau dans un document à l'aide d'un flux mémoire.
using (HttpClient webClient = new HttpClient())
{
    byte[] dataBytes = await webClient.GetByteArrayAsync(url);

    using (MemoryStream byteStream = new MemoryStream(dataBytes))
    {
        Document doc = new Document(byteStream);

        // A ce stade, nous pouvons lire et modifier le contenu du document, puis l'enregistrer dans le système de fichiers local.
        Assert.AreEqual("There are eight section headings in this document. At the beginning, \"Sample Document\" is a level 1 heading. " +
            "The main section headings, such as \"Headings\" and \"Lists\" are level 2 headings. " +
            "The Tables section contains two sub-headings, \"Simple Table\" and \"Complex Table,\" which are both level 3 headings.",                         
            doc.FirstSection.Body.Paragraphs[3].GetText().Trim());

        doc.Save(ArtifactsDir + "Document.LoadFromWeb.docx");
    }
}

Voir également


Document(Stream, LoadOptions)

Ouvre un document existant à partir d’un flux. Permet de spécifier des options supplémentaires telles qu’un mot de passe de cryptage.

public Document(Stream stream, LoadOptions loadOptions)
ParamètreTaperLa description
streamStreamLe flux à partir duquel charger le document.
loadOptionsLoadOptionsOptions supplémentaires à utiliser lors du chargement d’un document. Peut êtrenul.

Exceptions

exceptioncondition
UnsupportedFileFormatExceptionLe format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedExceptionLe document semble corrompu et ne peut pas être chargé.
ExceptionIl y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOExceptionIl existe une exception d’entrée/sortie.
IncorrectPasswordExceptionLe document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentNullExceptionLe flux ne peut pas être nul.
NotSupportedExceptionLe flux ne prend pas en charge la lecture ou la recherche.
ObjectDisposedExceptionLe flux est un objet supprimé.

Remarques

Le document doit être stocké au début du flux. Le flux doit prendre en charge le positionnement aléatoire.

Exemples

Montre comment ouvrir un document HTML avec des images provenant d’un flux à l’aide d’un URI de base.

using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
    // Passe l'URI du dossier de base lors de son chargement
    // afin que toutes les images avec des URI relatifs dans le document HTML puissent être trouvées.
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.BaseUri = ImageDir;

    Document doc = new Document(stream, loadOptions);

    // Vérifiez que la première forme du document contient une image valide.
    Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

    Assert.IsTrue(shape.IsImage);
    Assert.IsNotNull(shape.ImageData.ImageBytes);
    Assert.AreEqual(32.0, ConvertUtil.PointToPixel(shape.Width), 0.01);
    Assert.AreEqual(32.0, ConvertUtil.PointToPixel(shape.Height), 0.01);
}

Montre comment enregistrer une page Web sous forme de fichier .docx.

const string url = "https://www.aspose.com/";

using (HttpClient client = new HttpClient()) 
{
    var bytes = await client.GetByteArrayAsync(url);
    using (MemoryStream stream = new MemoryStream(bytes))
    {
        // L'URL est à nouveau utilisée comme baseUri pour garantir que tous les chemins d'image relatifs sont récupérés correctement.
        LoadOptions options = new LoadOptions(LoadFormat.Html, "", url);

        // Charge le document HTML depuis le flux et passe l'objet LoadOptions.
        Document doc = new Document(stream, options);

        // A ce stade, nous pouvons lire et modifier le contenu du document, puis l'enregistrer dans le système de fichiers local.
        doc.Save(ArtifactsDir + "Document.InsertHtmlFromWebPage.docx");
    }
}

Montre comment charger un document Microsoft Word chiffré.

Document doc;

// Aspose.Words lève une exception si nous essayons d'ouvrir un document crypté sans son mot de passe.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Lors du chargement d'un tel document, le mot de passe est transmis au constructeur du document à l'aide d'un objet LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Il existe deux manières de charger un document chiffré avec un objet LoadOptions.
// 1 - Chargez le document depuis le système de fichiers local par nom de fichier :
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Charge le document depuis un flux :
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Voir également