Document

Document()

Erstellt ein leeres Word-Dokument.

public Document()

Bemerkungen

Das Dokumentpapierformat ist standardmäßig Letter. Wenn Sie die Seiteneinrichtung ändern möchten, verwenden Sie PageSetup.

Nach der Erstellung können Sie es verwendenDocumentBuilder um Dokumentinhalte einfach hinzuzufügen.

Beispiele

Zeigt, wie eine Textzeile mithilfe ihrer Schriftarteigenschaft formatiert wird.

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");

Zeigt, wie Dokumente erstellt und geladen werden.

// Es gibt zwei Möglichkeiten, ein Document-Objekt mit Aspose.Words zu erstellen.
// 1 - Erstellen Sie ein leeres Dokument:
Document doc = new Document();

// Neue Dokumentobjekte verfügen standardmäßig über die minimale Menge an Knoten
// erforderlich, um mit dem Hinzufügen von Inhalten wie Text und Formen zu beginnen: ein Abschnitt, ein Hauptteil und ein Absatz.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 – Laden Sie ein Dokument, das im lokalen Dateisystem vorhanden ist:
doc = new Document(MyDir + "Document.docx");

// Geladene Dokumente haben Inhalte, auf die wir zugreifen und die wir bearbeiten können.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Einige Vorgänge, die während des Ladens ausgeführt werden müssen, z. B. die Verwendung eines Kennworts zum Entschlüsseln eines Dokuments,
// kann durch Übergabe eines LoadOptions-Objekts beim Laden des Dokuments erfolgen.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Siehe auch

Document(string)

Öffnet ein vorhandenes Dokument aus einer Datei. Erkennt automatisch das Dateiformat.

public Document(string fileName)
ParameterTypBeschreibung
fileNameStringDateiname des zu öffnenden Dokuments.

Ausnahmen

AusnahmeBedingung
UnsupportedFileFormatExceptionDas Dokumentformat wird nicht erkannt oder nicht unterstützt.
FileCorruptedExceptionDas Dokument scheint beschädigt zu sein und kann nicht geladen werden.
ExceptionEs liegt ein Problem mit dem Dokument vor und es sollte den Aspose.Words-Entwicklern gemeldet werden.
IOExceptionEs liegt eine Ein-/Ausgabeausnahme vor.
IncorrectPasswordExceptionDas Dokument ist verschlüsselt und erfordert zum Öffnen ein Passwort, Sie haben jedoch ein falsches Passwort angegeben.
ArgumentExceptionDer Name der Datei darf nicht null oder eine leere Zeichenfolge sein.

Beispiele

Zeigt, wie man ein Dokument öffnet und in .PDF konvertiert.

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

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

Zeigt, wie man eine PDF-Datei in eine DOCX-Datei konvertiert.

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

builder.Write("Hello world!");

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

// Laden Sie das gerade gespeicherte PDF-Dokument und konvertieren Sie es in .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");

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

Zeigt, wie ein PDF geladen wird.

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

builder.Write("Hello world!");

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

// Nachfolgend finden Sie zwei Möglichkeiten zum Laden von PDF-Dokumenten mit Aspose-Produkten.
// 1 – Als Aspose.Words-Dokument laden:
Aspose.Words.Document asposeWordsDoc = new Aspose.Words.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

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

// 2 – Als Aspose.Pdf-Dokument laden:
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());

Siehe auch

Document(string, LoadOptions)

Öffnet ein vorhandenes Dokument aus einer Datei. Ermöglicht die Angabe zusätzlicher Optionen wie z. B. eines Verschlüsselungskennworts.

public Document(string fileName, LoadOptions loadOptions)
ParameterTypBeschreibung
fileNameStringDateiname des zu öffnenden Dokuments.
loadOptionsLoadOptionsZusätzliche Optionen zum Laden eines Dokuments. Kann seinNull.

Ausnahmen

AusnahmeBedingung
UnsupportedFileFormatExceptionDas Dokumentformat wird nicht erkannt oder nicht unterstützt.
FileCorruptedExceptionDas Dokument scheint beschädigt zu sein und kann nicht geladen werden.
ExceptionEs liegt ein Problem mit dem Dokument vor und es sollte den Aspose.Words-Entwicklern gemeldet werden.
IOExceptionEs liegt eine Ein-/Ausgabeausnahme vor.
IncorrectPasswordExceptionDas Dokument ist verschlüsselt und erfordert zum Öffnen ein Passwort, Sie haben jedoch ein falsches Passwort angegeben.
ArgumentExceptionDer Name der Datei darf nicht null oder eine leere Zeichenfolge sein.

Beispiele

Zeigt, wie ein verschlüsseltes Microsoft Word-Dokument geladen wird.

Document doc;

// Aspose.Words löst eine Ausnahme aus, wenn wir versuchen, ein verschlüsseltes Dokument ohne sein Passwort zu öffnen.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Beim Laden eines solchen Dokuments wird das Passwort mithilfe eines LoadOptions-Objekts an den Konstruktor des Dokuments übergeben.
LoadOptions options = new LoadOptions("docPassword");

// Es gibt zwei Möglichkeiten, ein verschlüsseltes Dokument mit einem LoadOptions-Objekt zu laden.
// 1 – Laden Sie das Dokument anhand des Dateinamens aus dem lokalen Dateisystem:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 – Laden Sie das Dokument aus einem Stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Zeigt, wie Dokumente erstellt und geladen werden.

// Es gibt zwei Möglichkeiten, ein Document-Objekt mit Aspose.Words zu erstellen.
// 1 - Erstellen Sie ein leeres Dokument:
Document doc = new Document();

// Neue Dokumentobjekte verfügen standardmäßig über die minimale Menge an Knoten
// erforderlich, um mit dem Hinzufügen von Inhalten wie Text und Formen zu beginnen: ein Abschnitt, ein Hauptteil und ein Absatz.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 – Laden Sie ein Dokument, das im lokalen Dateisystem vorhanden ist:
doc = new Document(MyDir + "Document.docx");

// Geladene Dokumente haben Inhalte, auf die wir zugreifen und die wir bearbeiten können.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Einige Vorgänge, die während des Ladens ausgeführt werden müssen, z. B. die Verwendung eines Kennworts zum Entschlüsseln eines Dokuments,
// kann durch Übergabe eines LoadOptions-Objekts beim Laden des Dokuments erfolgen.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Siehe auch

Document(Stream)

Öffnet ein vorhandenes Dokument aus einem Stream. Erkennt automatisch das Dateiformat.

public Document(Stream stream)
ParameterTypBeschreibung
streamStreamStreamen Sie, woher das Dokument geladen werden soll.

Ausnahmen

AusnahmeBedingung
UnsupportedFileFormatExceptionDas Dokumentformat wird nicht erkannt oder nicht unterstützt.
FileCorruptedExceptionDas Dokument scheint beschädigt zu sein und kann nicht geladen werden.
ExceptionEs liegt ein Problem mit dem Dokument vor und es sollte den Aspose.Words-Entwicklern gemeldet werden.
IOExceptionEs liegt eine Ein-/Ausgabeausnahme vor.
IncorrectPasswordExceptionDas Dokument ist verschlüsselt und erfordert zum Öffnen ein Passwort, Sie haben jedoch ein falsches Passwort angegeben.
ArgumentNullExceptionDer Stream darf nicht null sein.
NotSupportedExceptionDer Stream unterstützt weder Lesen noch Suchen.
ObjectDisposedExceptionDer Stream ist ein entsorgtes Objekt.

Bemerkungen

Das Dokument muss am Anfang des Streams gespeichert werden. Der Stream muss eine zufällige Positionierung unterstützen.

Beispiele

Zeigt, wie ein Dokument mithilfe eines Streams geladen wird.

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

Zeigt, wie ein Dokument von einer URL geladen wird.

// Erstellen Sie eine URL, die auf ein Microsoft Word-Dokument verweist.
const string url = "https://filesamples.com/samples/document/docx/sample3.docx";

// Laden Sie das Dokument in ein Byte-Array herunter und laden Sie dieses Array dann mithilfe eines Speicherstreams in ein Dokument.
using (HttpClient webClient = new HttpClient())
{
    byte[] dataBytes = await webClient.GetByteArrayAsync(url);

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

        // In dieser Phase können wir den Inhalt des Dokuments lesen und bearbeiten und es dann im lokalen Dateisystem speichern.
        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");
    }
}

Siehe auch

Document(Stream, LoadOptions)

Öffnet ein vorhandenes Dokument aus einem Stream. Ermöglicht die Angabe zusätzlicher Optionen wie z. B. eines Verschlüsselungskennworts.

public Document(Stream stream, LoadOptions loadOptions)
ParameterTypBeschreibung
streamStreamDer Stream, aus dem das Dokument geladen werden soll.
loadOptionsLoadOptionsZusätzliche Optionen zum Laden eines Dokuments. Kann seinNull.

Ausnahmen

AusnahmeBedingung
UnsupportedFileFormatExceptionDas Dokumentformat wird nicht erkannt oder nicht unterstützt.
FileCorruptedExceptionDas Dokument scheint beschädigt zu sein und kann nicht geladen werden.
ExceptionEs liegt ein Problem mit dem Dokument vor und es sollte den Aspose.Words-Entwicklern gemeldet werden.
IOExceptionEs liegt eine Ein-/Ausgabeausnahme vor.
IncorrectPasswordExceptionDas Dokument ist verschlüsselt und erfordert zum Öffnen ein Passwort, Sie haben jedoch ein falsches Passwort angegeben.
ArgumentNullExceptionDer Stream darf nicht null sein.
NotSupportedExceptionDer Stream unterstützt weder Lesen noch Suchen.
ObjectDisposedExceptionDer Stream ist ein entsorgtes Objekt.

Bemerkungen

Das Dokument muss am Anfang des Streams gespeichert werden. Der Stream muss eine zufällige Positionierung unterstützen.

Beispiele

Zeigt, wie man mithilfe eines Basis-URI ein HTML-Dokument mit Bildern aus einem Stream öffnet.

using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
    // Beim Laden den URI des Basisordners übergeben
    // damit alle Bilder mit relativen URIs im HTML-Dokument gefunden werden können.
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.BaseUri = ImageDir;

    Document doc = new Document(stream, loadOptions);

    // Überprüfen Sie, ob die erste Form des Dokuments ein gültiges Bild enthält.
    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);
}

Zeigt, wie eine Webseite als .docx-Datei gespeichert wird.

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

using (HttpClient client = new HttpClient()) 
{
    var bytes = await client.GetByteArrayAsync(url);
    using (MemoryStream stream = new MemoryStream(bytes))
    {
        // Die URL wird erneut als BaseUri verwendet, um sicherzustellen, dass alle relativen Bildpfade korrekt abgerufen werden.
        LoadOptions options = new LoadOptions(LoadFormat.Html, "", url);

        // Laden Sie das HTML-Dokument aus dem Stream und übergeben Sie das LoadOptions-Objekt.
        Document doc = new Document(stream, options);

        // In dieser Phase können wir den Inhalt des Dokuments lesen und bearbeiten und es dann im lokalen Dateisystem speichern.
        doc.Save(ArtifactsDir + "Document.InsertHtmlFromWebPage.docx");
    }
}

Zeigt, wie ein verschlüsseltes Microsoft Word-Dokument geladen wird.

Document doc;

// Aspose.Words löst eine Ausnahme aus, wenn wir versuchen, ein verschlüsseltes Dokument ohne sein Passwort zu öffnen.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Beim Laden eines solchen Dokuments wird das Passwort mithilfe eines LoadOptions-Objekts an den Konstruktor des Dokuments übergeben.
LoadOptions options = new LoadOptions("docPassword");

// Es gibt zwei Möglichkeiten, ein verschlüsseltes Dokument mit einem LoadOptions-Objekt zu laden.
// 1 – Laden Sie das Dokument anhand des Dateinamens aus dem lokalen Dateisystem:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 – Laden Sie das Dokument aus einem Stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Siehe auch

Document.AttachedTemplate