facades-extract-images-and-text

Imported from aspose-pdf/agentic-net-examples (facades-extract-images-and-text/AGENTS.md). Install upstream with npx skills add aspose-pdf/agentic-net-examples --skill facades-extract-images-and-text. Copyright stays with the author.

AGENTS - facades-extract-images-and-text

Facades extract images and text in PDF using C# / .NET -- 81 verified, compile-tested examples for Aspose.PDF for .NET 26.8.0. Each .cs file is a standalone, build-validated console example, generated and runtime-checked by an AI agent before publishing.

Persona

You are a C# developer specializing in PDF processing using Aspose.PDF for .NET, working within the facades-extract-images-and-text category. This folder contains standalone C# examples for facades-extract-images-and-text operations. See the root agents.md for repository-wide conventions and boundaries.

Scope

• This folder contains examples for facades-extract-images-and-text.
• Files are standalone .cs examples stored directly in this folder.

Required Namespaces

• using Aspose.Pdf.Facades; (80/81 files) ← category-specific
• using Aspose.Pdf; (26/81 files)
• using Aspose.Pdf.Text; (4/81 files)
• using Aspose.Pdf.AI; (1/81 files)
• using Aspose.Pdf.Drawing; (1/81 files)
• using Aspose.Pdf.Multithreading; (1/81 files)
• using System; (81/81 files)
• using System.IO; (81/81 files)
• using System.Text; (23/81 files)
• using System.Drawing.Imaging; (20/81 files)
• using System.Collections.Generic; (18/81 files)
• using System.Threading.Tasks; (7/81 files)
• using System.Drawing; (6/81 files)
• using System.Text.Json; (4/81 files)
• using Azure.Storage.Blobs; (3/81 files)
• using System.IO.Compression; (3/81 files)
• using System.Threading; (3/81 files)
• using NUnit.Framework; (2/81 files)
• using System.Security.Cryptography; (2/81 files)
• using Azure.Storage.Blobs.Models; (1/81 files)
• using Google.Apis.Storage.v1.Data; (1/81 files)
• using Google.Cloud.Storage.V1; (1/81 files)
• using Microsoft.Azure.WebJobs; (1/81 files)
• using Microsoft.Extensions.Logging; (1/81 files)
• using Npgsql; (1/81 files)
• using System.Collections; (1/81 files)
• using System.Diagnostics; (1/81 files)
• using System.Drawing.Drawing2D; (1/81 files)

Common Code Pattern

Most files in this category use PdfExtractor from Aspose.Pdf.Facades:

PdfExtractor tool = new PdfExtractor();
tool.BindPdf("input.pdf");
// ... PdfExtractor operations ...
tool.Save("output.pdf");

Files in this folder

Category Statistics

• Total examples: 81

Category-Specific Tips

Key API Surface

• Aspose.Pdf.Facades.ExtractImageMode
• Aspose.Pdf.Facades.PdfContentEditor
• Aspose.Pdf.Facades.PdfConverter
• Aspose.Pdf.Facades.PdfExtractor
• Aspose.Pdf.Facades.PdfExtractor.BindPdf
• Aspose.Pdf.Facades.PdfExtractor.ExtractText
• Aspose.Pdf.Facades.PdfExtractor.GetNextPageText
• Aspose.Pdf.Facades.PdfExtractor.HasNextPageText
• Aspose.Pdf.Facades.PdfFileEditor
• Aspose.Pdf.Facades.PdfFileEditor.Extract

Rules

• BindPdf({input_pdf}) must be called on a PdfContentEditor instance before any editing methods such as ReplaceText.
• ReplaceText({text_fragment}, {page}, {text_fragment}) replaces all occurrences of the first text fragment on the specified 1‑based page with the second text fragment.
• Save({output_pdf}) persists the edited PDF; it should be invoked after all edit operations are completed.
• Use PdfFileEditor.Extract({input_pdf}, new int[] {{int}, {int}, ...}, {output_pdf}) to create a new PDF containing only the listed pages.
• Page numbers supplied in the int array are 1‑based and must exist in {input_pdf}.

Warnings

• Page numbers are 1‑based; passing 0 will cause an error.
• ReplaceText operates only on the specified page and replaces every matching occurrence on that page.
• The output file will be created or overwritten; ensure the path is correct.
• The example assumes the input PDF exists at the specified location.
• The example does not explicitly dispose the FileStream objects; callers should ensure streams are closed or wrapped in using statements.

General Tips

• See parent AGENTS.md for:
  • Boundaries -- Always / Ask First / Never rules for all examples
  • Common Mistakes -- verified anti-patterns that cause build failures
  • Domain Knowledge -- cross-cutting API-specific gotchas
  • Testing Guide -- build and run verification steps
• Review code examples in this folder for facades-extract-images-and-text patterns

Updated: 2026-08-20 | Run: 20260820_001147_12d7b3