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());
Смотрите также
- class Document
- пространство имен Aspose.Words
- сборка Aspose.Words
Document(string)
Открывает существующий документ из файла. Автоматически определяет формат файла.
public Document(string fileName)
Параметр | Тип | Описание |
---|---|---|
fileName | String | Имя файла документа, который необходимо открыть. |
Исключения
исключение | условие |
---|---|
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());
Смотрите также
- class Document
- пространство имен Aspose.Words
- сборка Aspose.Words
Document(string, LoadOptions)
Открывает существующий документ из файла. Позволяет указать дополнительные параметры, такие как пароль шифрования.
public Document(string fileName, LoadOptions loadOptions)
Параметр | Тип | Описание |
---|---|---|
fileName | String | Имя файла документа, который необходимо открыть. |
loadOptions | LoadOptions | Дополнительные параметры для использования при загрузке документа. Может бытьнулевой . |
Исключения
исключение | условие |
---|---|
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());
Смотрите также
- class LoadOptions
- class Document
- пространство имен Aspose.Words
- сборка Aspose.Words
Document(Stream)
Открывает существующий документ из потока. Автоматически определяет формат файла.
public Document(Stream stream)
Параметр | Тип | Описание |
---|---|---|
stream | Stream | Поток, откуда загрузить документ. |
Исключения
исключение | условие |
---|---|
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");
}
}
Смотрите также
- class Document
- пространство имен Aspose.Words
- сборка Aspose.Words
Document(Stream, LoadOptions)
Открывает существующий документ из потока. Позволяет указать дополнительные параметры, такие как пароль шифрования.
public Document(Stream stream, LoadOptions loadOptions)
Параметр | Тип | Описание |
---|---|---|
stream | Stream | Поток, из которого загрузить документ. |
loadOptions | LoadOptions | Дополнительные параметры для использования при загрузке документа. Может бытьнулевой . |
Исключения
исключение | условие |
---|---|
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);
}
Смотрите также
- class LoadOptions
- class Document
- пространство имен Aspose.Words
- сборка Aspose.Words