Document

Document()

Crea un documento Word vuoto.

public Document()

Osservazioni

Per impostazione predefinita, il formato carta del documento è Lettera. Se vuoi cambiare l’impostazione della pagina, usa PageSetup.

Dopo la creazione, puoi utilizzareDocumentBuilder per aggiungere facilmente il contenuto del documento.

Esempi

Mostra come formattare una sequenza di testo utilizzando la relativa proprietà 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");

Mostra come creare e caricare documenti.

// Esistono due modi per creare un oggetto Document utilizzando Aspose.Words.
// 1 - Crea un documento vuoto:
Document doc = new Document();

// Gli oggetti New Document per impostazione predefinita vengono forniti con il set minimo di nodi
// richiesto per iniziare ad aggiungere contenuto come testo e forme: una sezione, un corpo e un paragrafo.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Carica un documento che esiste nel file system locale:
doc = new Document(MyDir + "Document.docx");

// I documenti caricati avranno contenuti a cui possiamo accedere e modificare.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Alcune operazioni che devono essere eseguite durante il caricamento, come l'utilizzo di una password per decrittografare un documento,
// può essere fatto passando un oggetto LoadOptions durante il caricamento del documento.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Guarda anche

class Document
spazio dei nomi Aspose.Words
assemblea Aspose.Words

Document(string)

Apre un documento esistente da un file. Rileva automaticamente il formato del file.

public Document(string fileName)

Parametro	Tipo	Descrizione
fileName	String	Nome del file del documento da aprire.

Eccezioni

eccezione	condizione
UnsupportedFileFormatException	Il formato del documento non è riconosciuto o non è supportato.
FileCorruptedException	Il documento sembra essere danneggiato e non può essere caricato.
Exception	C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
IOException	Esiste un’eccezione di input/output.
IncorrectPasswordException	Il documento è crittografato e richiede una password per essere aperto, ma hai fornito una password errata.
ArgumentException	Il nome del file non può essere una stringa nulla o vuota.

Esempi

Mostra come aprire un documento e convertirlo in .PDF.

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

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

Mostra come convertire un PDF in un .docx.

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

builder.Write("Hello world!");

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

// Carica il documento PDF che abbiamo appena salvato e convertilo in .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");

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

Mostra come caricare 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");

// Di seguito sono riportati due modi per caricare documenti PDF utilizzando i prodotti Aspose.
// 1 - Carica come documento Aspose.Words:
Aspose.Words.Document asposeWordsDoc = new Aspose.Words.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

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

// 2 - Carica come documento 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());

Guarda anche

class Document
spazio dei nomi Aspose.Words
assemblea Aspose.Words

Document(string, LoadOptions)

Apre un documento esistente da un file. Consente di specificare opzioni aggiuntive come una password di crittografia.

public Document(string fileName, LoadOptions loadOptions)

Parametro	Tipo	Descrizione
fileName	String	Nome del file del documento da aprire.
loadOptions	LoadOptions	Opzioni aggiuntive da utilizzare durante il caricamento di un documento. Può essere`nullo`.

Eccezioni

eccezione	condizione
UnsupportedFileFormatException	Il formato del documento non è riconosciuto o non è supportato.
FileCorruptedException	Il documento sembra essere danneggiato e non può essere caricato.
Exception	C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
IOException	Esiste un’eccezione di input/output.
IncorrectPasswordException	Il documento è crittografato e richiede una password per essere aperto, ma hai fornito una password errata.
ArgumentException	Il nome del file non può essere una stringa nulla o vuota.

Esempi

Mostra come caricare un documento Microsoft Word crittografato.

Document doc;

// Aspose.Words lancia un'eccezione se proviamo ad aprire un documento crittografato senza la sua password.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Quando si carica un documento di questo tipo, la password viene passata al costruttore del documento utilizzando un oggetto LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Esistono due modi per caricare un documento crittografato con un oggetto LoadOptions.
// 1 - Carica il documento dal file system locale in base al nome file:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Carica il documento da uno stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Mostra come creare e caricare documenti.

// Esistono due modi per creare un oggetto Document utilizzando Aspose.Words.
// 1 - Crea un documento vuoto:
Document doc = new Document();

// Gli oggetti New Document per impostazione predefinita vengono forniti con il set minimo di nodi
// richiesto per iniziare ad aggiungere contenuto come testo e forme: una sezione, un corpo e un paragrafo.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Carica un documento che esiste nel file system locale:
doc = new Document(MyDir + "Document.docx");

// I documenti caricati avranno contenuti a cui possiamo accedere e modificare.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Alcune operazioni che devono essere eseguite durante il caricamento, come l'utilizzo di una password per decrittografare un documento,
// può essere fatto passando un oggetto LoadOptions durante il caricamento del documento.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Guarda anche

class LoadOptions
class Document
spazio dei nomi Aspose.Words
assemblea Aspose.Words

Document(Stream)

Apre un documento esistente da uno stream. Rileva automaticamente il formato del file.

public Document(Stream stream)

Parametro	Tipo	Descrizione
stream	Stream	Stream da dove caricare il documento.

Eccezioni

eccezione	condizione
UnsupportedFileFormatException	Il formato del documento non è riconosciuto o non è supportato.
FileCorruptedException	Il documento sembra essere danneggiato e non può essere caricato.
Exception	C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
IOException	Esiste un’eccezione di input/output.
IncorrectPasswordException	Il documento è crittografato e richiede una password per essere aperto, ma hai fornito una password errata.
ArgumentNullException	Il flusso non può essere nullo.
NotSupportedException	Lo stream non supporta la lettura o la ricerca.
ObjectDisposedException	Il flusso è un oggetto eliminato.

Osservazioni

Il documento deve essere archiviato all’inizio dello stream. Il flusso deve supportare il posizionamento casuale.

Esempi

Mostra come caricare un documento utilizzando un flusso.

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());
}

Mostra come caricare un documento da un URL.

// Crea un URL che punti a un documento Microsoft Word.
const string url = "https://filesamples.com/samples/document/docx/sample3.docx";

// Scarica il documento in un array di byte, quindi carica l'array in un documento utilizzando un flusso di memoria.
using (HttpClient webClient = new HttpClient())
{
    byte[] dataBytes = await webClient.GetByteArrayAsync(url);

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

        // A questo punto possiamo leggere e modificare il contenuto del documento e quindi salvarlo nel file system locale.
        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");
    }
}

Guarda anche

class Document
spazio dei nomi Aspose.Words
assemblea Aspose.Words

Document(Stream, LoadOptions)

Apre un documento esistente da uno stream. Consente di specificare opzioni aggiuntive come una password di crittografia.

public Document(Stream stream, LoadOptions loadOptions)

Parametro	Tipo	Descrizione
stream	Stream	Il flusso da cui caricare il documento.
loadOptions	LoadOptions	Opzioni aggiuntive da utilizzare durante il caricamento di un documento. Può essere`nullo`.

Eccezioni

eccezione	condizione
UnsupportedFileFormatException	Il formato del documento non è riconosciuto o non è supportato.
FileCorruptedException	Il documento sembra essere danneggiato e non può essere caricato.
Exception	C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
IOException	Esiste un’eccezione di input/output.
IncorrectPasswordException	Il documento è crittografato e richiede una password per essere aperto, ma hai fornito una password errata.
ArgumentNullException	Il flusso non può essere nullo.
NotSupportedException	Lo stream non supporta la lettura o la ricerca.
ObjectDisposedException	Il flusso è un oggetto eliminato.

Osservazioni

Il documento deve essere archiviato all’inizio dello stream. Il flusso deve supportare il posizionamento casuale.

Esempi

Mostra come aprire un documento HTML con immagini da un flusso utilizzando un URI di base.

using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
    // Passa l'URI della cartella base durante il caricamento
    // in modo che sia possibile trovare eventuali immagini con relativi URI nel documento HTML.
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.BaseUri = ImageDir;

    Document doc = new Document(stream, loadOptions);

    // Verifica che la prima forma del documento contenga un'immagine valida.
    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);
}

Mostra come salvare una pagina Web come file .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 viene utilizzato nuovamente come baseUri per garantire che tutti i percorsi relativi alle immagini vengano recuperati correttamente.
        LoadOptions options = new LoadOptions(LoadFormat.Html, "", url);

        // Carica il documento HTML dallo stream e passa l'oggetto LoadOptions.
        Document doc = new Document(stream, options);

        // A questo punto possiamo leggere e modificare il contenuto del documento e quindi salvarlo nel file system locale.
        doc.Save(ArtifactsDir + "Document.InsertHtmlFromWebPage.docx");
    }
}

Mostra come caricare un documento Microsoft Word crittografato.

Document doc;

// Aspose.Words lancia un'eccezione se proviamo ad aprire un documento crittografato senza la sua password.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Quando si carica un documento di questo tipo, la password viene passata al costruttore del documento utilizzando un oggetto LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Esistono due modi per caricare un documento crittografato con un oggetto LoadOptions.
// 1 - Carica il documento dal file system locale in base al nome file:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Carica il documento da uno stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Guarda anche

class LoadOptions
class Document
spazio dei nomi Aspose.Words
assemblea Aspose.Words

Document.AttachedTemplate