Document

Document()

Crée un document Word vierge.

public Document()

Remarques

Un document vierge est récupéré à partir des ressources et, par défaut, le document résultant ressemble davantage à celui créé parWord2007. Ce document vierge contient une table de polices par défaut, des styles par défaut minimaux et des styles latents.

OptimizeFor La méthode peut être utilisée pour optimiser le contenu du document ainsi que le comportement par défaut d’Aspose.Words pour une version particulière de MS Word.

Le format de papier par défaut du document est Lettre. Pour modifier la mise en page, utilisez .PageSetup.

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

Exemples

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

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 un document simple.

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.AppendChild(new Section(doc))
    .AppendChild(new Body(doc))
    .AppendChild(new Paragraph(doc))
    .AppendChild(new Run(doc, "Hello world!"));

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 - Charger 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 que nous pourrons modifier.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Certaines opérations qui doivent se produire pendant le 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

class Document
espace de noms Aspose.Words
Assemblée Aspose.Words

Document(string)

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

public Document(string fileName)

Paramètre	Taper	La description
fileName	String	Nom du fichier du document à ouvrir.

Exceptions

exception	condition
UnsupportedFileFormatException	Le format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedException	Le document semble corrompu et ne peut pas être chargé.
Exception	Il y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOException	Il y a une exception d’entrée/sortie.
IncorrectPasswordException	Le document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentException	Le 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.

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 manières de charger des documents PDF à l'aide des produits Aspose.
// 1 - Charger en tant que document Aspose.Words :
Document asposeWordsDoc = new 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

class Document
espace de noms Aspose.Words
Assemblée Aspose.Words

Document(string, LoadOptions)

Ouvre un document existant à partir d’un fichier. Permet de spécifier des options supplémentaires, comme un mot de passe de chiffrement.

public Document(string fileName, LoadOptions loadOptions)

Paramètre	Taper	La description
fileName	String	Nom du fichier du document à ouvrir.
loadOptions	LoadOptions	Options supplémentaires à utiliser lors du chargement d’un document. Peut être`nul`.

Exceptions

exception	condition
UnsupportedFileFormatException	Le format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedException	Le document semble corrompu et ne peut pas être chargé.
Exception	Il y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOException	Il y a une exception d’entrée/sortie.
IncorrectPasswordException	Le document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentException	Le 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 - Charger le document à partir du système de fichiers local par nom de fichier :
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Charger le document à partir d'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 - Charger 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 que nous pourrons modifier.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Certaines opérations qui doivent se produire pendant le 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

class LoadOptions
class Document
espace de noms Aspose.Words
Assemblée Aspose.Words

Document(Stream)

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

public Document(Stream stream)

Paramètre	Taper	La description
stream	Stream	Flux à partir duquel charger le document.

Exceptions

exception	condition
UnsupportedFileFormatException	Le format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedException	Le document semble corrompu et ne peut pas être chargé.
Exception	Il y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOException	Il y a une exception d’entrée/sortie.
IncorrectPasswordException	Le document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentNullException	Le flux ne peut pas être nul.
NotSupportedException	Le flux ne prend pas en charge la lecture ou la recherche.
ObjectDisposedException	Le flux est un objet disposé.

Remarques

Le document doit être stocké au début du flux. Ce dernier 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éez 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 (WebClient webClient = new WebClient())
{
    byte[] dataBytes = webClient.DownloadData(url);

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

        // À ce stade, nous pouvons lire et modifier le contenu du document, puis l'enregistrer sur 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

class Document
espace de noms Aspose.Words
Assemblée Aspose.Words

Document(Stream, LoadOptions)

Ouvre un document existant depuis un flux. Permet de spécifier des options supplémentaires, comme un mot de passe de chiffrement.

public Document(Stream stream, LoadOptions loadOptions)

Paramètre	Taper	La description
stream	Stream	Le flux à partir duquel charger le document.
loadOptions	LoadOptions	Options supplémentaires à utiliser lors du chargement d’un document. Peut être`nul`.

Exceptions

exception	condition
UnsupportedFileFormatException	Le format du document n’est pas reconnu ou n’est pas pris en charge.
FileCorruptedException	Le document semble corrompu et ne peut pas être chargé.
Exception	Il y a un problème avec le document et il doit être signalé aux développeurs d’Aspose.Words.
IOException	Il y a une exception d’entrée/sortie.
IncorrectPasswordException	Le document est crypté et nécessite un mot de passe pour s’ouvrir, mais vous avez fourni un mot de passe incorrect.
ArgumentNullException	Le flux ne peut pas être nul.
NotSupportedException	Le flux ne prend pas en charge la lecture ou la recherche.
ObjectDisposedException	Le flux est un objet disposé.

Remarques

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

Exemples

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

using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
    // Transmettez l'URI du dossier de base lors de son chargement
    // afin que toutes les images avec des URI relatives 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://produits.aspose.com/words/";

using (WebClient client = new WebClient())
{
    var bytes = client.DownloadData(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);

        // Chargez le document HTML à partir du flux et transmettez l'objet LoadOptions.
        Document doc = new Document(stream, options);

        // À ce stade, nous pouvons lire et modifier le contenu du document, puis l'enregistrer sur 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 - Charger le document à partir du système de fichiers local par nom de fichier :
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Charger le document à partir d'un flux :
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Voir également

class LoadOptions
class Document
espace de noms Aspose.Words
Assemblée Aspose.Words

Document.AttachedTemplate