Document

Document()

Создает пустой документ Word.

public Document()

Примечания

По умолчанию формат бумаги документа — Letter. Если вы хотите изменить настройку страницы, используйте PageSetup.

После создания вы можете использоватьDocumentBuilder чтобы легко добавлять содержимое документа.

Примеры

Показывает, как форматировать фрагмент текста, используя его свойство шрифта.

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

Показывает, как создавать и загружать документы.

// Существует два способа создания объекта Document с использованием Aspose.Words.
// 1 - Создать пустой документ:
Document doc = new Document();

// Новые объекты документа по умолчанию имеют минимальный набор узлов
// требуется, чтобы начать добавлять контент, такой как текст и фигуры: раздел, тело и абзац.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Загрузить документ, существующий в локальной файловой системе:
doc = new Document(MyDir + "Document.docx");

// Загруженные документы будут иметь содержимое, к которому мы сможем получить доступ и редактировать.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Некоторые операции, которые необходимо выполнить во время загрузки, например, использование пароля для расшифровки документа,
// это можно сделать, передав объект LoadOptions при загрузке документа.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Смотрите также


Document(string)

Открывает существующий документ из файла. Автоматически определяет формат файла.

public Document(string fileName)
ПараметрТипОписание
fileNameStringИмя файла документа, который нужно открыть.

Исключения

исключениеусловие
UnsupportedFileFormatExceptionФормат документа не распознается или не поддерживается.
FileCorruptedExceptionДокумент поврежден и не может быть загружен.
ExceptionС документом возникла проблема, о которой следует сообщить разработчикам Aspose.Words.
IOExceptionСуществует исключение ввода/вывода.
IncorrectPasswordExceptionДокумент зашифрован, и для его открытия требуется пароль, но вы указали неправильный пароль.
ArgumentExceptionИмя файла не может быть нулевым или пустой строкой.

Примеры

Показывает, как открыть документ и преобразовать его в .PDF.

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

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

Показывает, как преобразовать PDF в .docx.

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

builder.Write("Hello world!");

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

// Загрузите PDF-документ, который мы только что сохранили, и преобразуйте его в .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");

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

Показывает, как загрузить PDF-файл.

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

builder.Write("Hello world!");

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

// Ниже приведены два способа загрузки PDF-документов с помощью продуктов Aspose.
// 1 - Загрузить как документ Aspose.Words:
Aspose.Words.Document asposeWordsDoc = new Aspose.Words.Document(ArtifactsDir + "PDF2Word.LoadPdf.pdf");

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

// 2 - Загрузить как документ 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());

Смотрите также


Document(string, LoadOptions)

Открывает существующий документ из файла. Позволяет указать дополнительные параметры, такие как пароль шифрования.

public Document(string fileName, LoadOptions loadOptions)
ПараметрТипОписание
fileNameStringИмя файла документа, который нужно открыть.
loadOptionsLoadOptionsДополнительные параметры, которые можно использовать при загрузке документа. Возможнонулевой.

Исключения

исключениеусловие
UnsupportedFileFormatExceptionФормат документа не распознается или не поддерживается.
FileCorruptedExceptionДокумент поврежден и не может быть загружен.
ExceptionС документом возникла проблема, о которой следует сообщить разработчикам Aspose.Words.
IOExceptionСуществует исключение ввода/вывода.
IncorrectPasswordExceptionДокумент зашифрован, и для его открытия требуется пароль, но вы указали неправильный пароль.
ArgumentExceptionИмя файла не может быть нулевым или пустой строкой.

Примеры

Показывает, как загрузить зашифрованный документ Microsoft Word.

Document doc;

// Aspose.Words выдает исключение, если мы пытаемся открыть зашифрованный документ без пароля.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// При загрузке такого документа пароль передается конструктору документа с помощью объекта LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Существует два способа загрузки зашифрованного документа с помощью объекта LoadOptions.
// 1 - Загрузить документ из локальной файловой системы по имени файла:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Загрузить документ из потока:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Показывает, как создавать и загружать документы.

// Существует два способа создания объекта Document с использованием Aspose.Words.
// 1 - Создать пустой документ:
Document doc = new Document();

// Новые объекты документа по умолчанию имеют минимальный набор узлов
// требуется, чтобы начать добавлять контент, такой как текст и фигуры: раздел, тело и абзац.
doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

// 2 - Загрузить документ, существующий в локальной файловой системе:
doc = new Document(MyDir + "Document.docx");

// Загруженные документы будут иметь содержимое, к которому мы сможем получить доступ и редактировать.
Assert.AreEqual("Hello World!", doc.FirstSection.Body.FirstParagraph.GetText().Trim());

// Некоторые операции, которые необходимо выполнить во время загрузки, например, использование пароля для расшифровки документа,
// это можно сделать, передав объект LoadOptions при загрузке документа.
doc = new Document(MyDir + "Encrypted.docx", new LoadOptions("docPassword"));

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

Смотрите также


Document(Stream)

Открывает существующий документ из потока. Автоматически определяет формат файла.

public Document(Stream stream)
ПараметрТипОписание
streamStreamПоток, откуда загрузить документ.

Исключения

исключениеусловие
UnsupportedFileFormatExceptionФормат документа не распознается или не поддерживается.
FileCorruptedExceptionДокумент поврежден и не может быть загружен.
ExceptionС документом возникла проблема, о которой следует сообщить разработчикам Aspose.Words.
IOExceptionСуществует исключение ввода/вывода.
IncorrectPasswordExceptionДокумент зашифрован, и для его открытия требуется пароль, но вы указали неправильный пароль.
ArgumentNullExceptionПоток не может быть нулевым.
NotSupportedExceptionПоток не поддерживает чтение или поиск.
ObjectDisposedExceptionПоток — это удаленный объект.

Примечания

Документ должен храниться в начале потока. Поток должен поддерживать случайное позиционирование.

Примеры

Показывает, как загрузить документ с помощью потока.

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

Показывает, как загрузить документ по URL-адресу.

// Создайте URL-адрес, указывающий на документ Microsoft Word.
const string url = "https://filesamples.com/samples/document/docx/sample3.docx";

// Загрузите документ в массив байтов, затем загрузите этот массив в документ, используя поток памяти.
using (HttpClient webClient = new HttpClient())
{
    byte[] dataBytes = await webClient.GetByteArrayAsync(url);

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

        // На этом этапе мы можем прочитать и отредактировать содержимое документа, а затем сохранить его в локальной файловой системе.
        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");
    }
}

Смотрите также


Document(Stream, LoadOptions)

Открывает существующий документ из потока. Позволяет указать дополнительные параметры, такие как пароль шифрования.

public Document(Stream stream, LoadOptions loadOptions)
ПараметрТипОписание
streamStreamПоток, из которого загрузить документ.
loadOptionsLoadOptionsДополнительные параметры, которые можно использовать при загрузке документа. Возможнонулевой.

Исключения

исключениеусловие
UnsupportedFileFormatExceptionФормат документа не распознается или не поддерживается.
FileCorruptedExceptionДокумент поврежден и не может быть загружен.
ExceptionС документом возникла проблема, о которой следует сообщить разработчикам Aspose.Words.
IOExceptionСуществует исключение ввода/вывода.
IncorrectPasswordExceptionДокумент зашифрован, и для его открытия требуется пароль, но вы указали неправильный пароль.
ArgumentNullExceptionПоток не может быть нулевым.
NotSupportedExceptionПоток не поддерживает чтение или поиск.
ObjectDisposedExceptionПоток — это удаленный объект.

Примечания

Документ должен храниться в начале потока. Поток должен поддерживать случайное позиционирование.

Примеры

Показывает, как открыть документ HTML с изображениями из потока, используя базовый URI.

using (Stream stream = File.OpenRead(MyDir + "Document.html"))
{
    // Передаем URI базовой папки при ее загрузке
    // чтобы можно было найти любые изображения с относительными URI в документе HTML.
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.BaseUri = ImageDir;

    Document doc = new Document(stream, loadOptions);

    // Убедитесь, что первая фигура документа содержит допустимое изображение.
    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);
}

Показывает, как сохранить веб-страницу в виде файла .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))
    {
        // URL-адрес снова используется в качестве baseUri, чтобы гарантировать правильность получения любых относительных путей к изображениям.
        LoadOptions options = new LoadOptions(LoadFormat.Html, "", url);

        // Загружаем HTML-документ из потока и передаем объект LoadOptions.
        Document doc = new Document(stream, options);

        // На этом этапе мы можем прочитать и отредактировать содержимое документа, а затем сохранить его в локальной файловой системе.
        doc.Save(ArtifactsDir + "Document.InsertHtmlFromWebPage.docx");
    }
}

Показывает, как загрузить зашифрованный документ Microsoft Word.

Document doc;

// Aspose.Words выдает исключение, если мы пытаемся открыть зашифрованный документ без пароля.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// При загрузке такого документа пароль передается конструктору документа с помощью объекта LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Существует два способа загрузки зашифрованного документа с помощью объекта LoadOptions.
// 1 - Загрузить документ из локальной файловой системы по имени файла:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Загрузить документ из потока:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Смотрите также