Document

Document()

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

public Document()

Примечания

Из ресурсов извлекается пустой документ, и по умолчанию результирующий документ выглядит больше как созданныйWord2007. Этот пустой документ содержит таблицу шрифтов по умолчанию, минимальные стили по умолчанию и скрытые стили.

OptimizeFor Метод можно использовать для оптимизации содержимого документа, а также поведения Aspose.Words по умолчанию для конкретной версии MS Word.

Размер бумаги документа по умолчанию 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 doc = new Document();

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

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

// Существует два способа создания объекта 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-файл.

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:
Document asposeWordsDoc = new 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 (WebClient webClient = new WebClient())
{
    byte[] dataBytes = webClient.DownloadData(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://products.aspose.com/words/";

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

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