Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package Aspose.Words-Cloud

.NET REST API for Cloud Document Processing

Aspose.Words Cloud SDK for .NET enables developers to integrate advanced document processing features into cloud-based applications. With this powerful REST API, users can perform document manipulation, conversion, and editing tasks on Microsoft Word and OpenOffice formats seamlessly. The API provides robust tools for managing structural elements like paragraphs, sections, tables, and headers, as well as security elements like password protection and encryption.

Structural Elements

Paragraphs

Represent individual blocks of text, aiding in organizing content.

Sections

Divide the document into distinct regions with unique formatting.

Tables

Structure data into rows and columns for tabular presentation.

Headers and Footers

Consistent content at the top and bottom of each page like page numbers.

Lists

Enable creation of ordered (numbered) or unordered (bulleted) lists.

Navigation Elements

Headings

Provide a hierarchical structure for easy navigation through sections.

Bookmarks

Mark specific locations for quick navigation within a document.

Hyperlinks

Embed clickable links to external resources or other documents.

Metadata Elements

Document Properties

Capture essential metadata like title, author, and creation date.

Fonts

Define the typeface, size, and style for text content.

Styles

Ensure consistent formatting across document elements.

Comments

Allow users to add feedback or notes to specific document parts.

Track Changes

Track document modifications like insertions or deletions.

Graphical Elements

Pictures and Images

Insert static images or photos into the document.

Shapes

Add customizable shapes like circles or rectangles for diagrams.

Charts

Create dynamic charts to visually represent data.

SmartArt

Predefined diagrams to represent complex concepts visually.

Security Elements

Password Protection

Restrict document access with a password for viewing or editing.

Digital Signatures

Authenticate document integrity using cryptographic signatures.

Document Encryption

Encrypt document content to prevent unauthorized access.

Watermarks

Add semi-transparent text or image overlays, typically for branding.

Special Elements

OfficeMath Objects

Enable the creation and manipulation of mathematical equations.

Supported File Formats

Microsoft Word Formats

Office Open XML Formats

OpenDocument Formats

PDF

Text and Markup Formats

Fixed Page Layout Formats

Image Formats

eBook formats

Quick Start

1. Create a Free Account

• Visit the Aspose Dashboard.
• Sign in using GitHub, Google, or create a new account by providing the necessary details.
• Congratulations! You now have access to Aspose Cloud.

2. View and Update Account Details

• Access your account by clicking the user icon in the upper-right corner of the page.
• Go to Account Settings and update your information if needed, then click Save Changes.

3. Get Your Security Credentials (Client ID & Secret)

• Log in to the Aspose Dashboard and navigate to the Applications tab on the left.
• Scroll down to find the default “First App.” Click on it to view your Client ID and Client Secret for API authentication.
• You’re now ready to authenticate Aspose.Words API calls.

4. Choose and Install SDK

• Aspose provides SDKs for major operating systems and programming languages, available on GitHub with detailed code examples.

• For .NET, execute the following command in Visual Studio’s Package Manager Console:

  Install-Package Aspose.Words-Cloud
  

• To upgrade the SDK, run:

  Update-Package Aspose.Words-Cloud
  

Convert Word Document to PDF

Convert Word documents to PDF effortlessly using Aspose.Words Cloud SDK for .NET.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model.Requests;

string fileName = "document.docx";
string format = "pdf"; // Output format as PDF

WordsApi wordsApi = new WordsApi("MyClientId", "MyClientSecret");

// Convert Word document to PDF
var request = new SaveAsRequest(fileName, new SaveOptionsData { SaveFormat = format });
var result = wordsApi.SaveAs(request);
Console.WriteLine("Document converted to PDF successfully.");

Extract Text from a Word Document

Extract specific text from a Word document using the Aspose.Words Cloud SDK for .NET.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model.Requests;

string fileName = "document.docx";
string rangeStartIdentifier = "0"; // Starting range
string rangeEndIdentifier = "10";  // Ending range

WordsApi wordsApi = new WordsApi("MyClientId", "MyClientSecret");

// Get text from the specified range
var request = new GetRangeTextRequest(fileName, rangeStartIdentifier, rangeEndIdentifier);
var rangeText = wordsApi.GetRangeText(request);
Console.WriteLine("Extracted text: " + rangeText.Text);

Add a Paragraph to a Word Document

Programmatically add a new paragraph to an existing Word document using the Aspose.Words Cloud SDK for .NET.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;

string fileName = "document.docx";
WordsApi wordsApi = new WordsApi("MyClientId", "MyClientSecret");

// Define the paragraph text
ParagraphInsert paragraphInsert = new ParagraphInsert { Text = "This is a new paragraph." };

// Add paragraph to the document
var request = new InsertParagraphRequest(fileName, paragraphInsert, "sections/0");
var result = wordsApi.InsertParagraph(request);
Console.WriteLine("Paragraph added successfully.");