"How do I programmatically accept or reject changes after a comparison?"

"Use `result.Changes.AcceptAll()`, `RejectAll()`, or iterate each `ChangeInfo` and call `Accept()` / `Reject()` as needed, then save the document with `result.Save(outputPath)`."

"Can I extract metadata such as author, creation date, or custom properties from documents?"

"Yes—`DocumentInfo` provides access to standard and custom metadata for both source and target files, allowing you to log or display this information."

"Is it possible to compare image files (e.g., PNG, JPEG) directly in .NET?"

"Absolutely. The `CompareImages` API highlights pixel‑level differences and returns a similarity percentage you can use in automated tests."

"How can I compare entire folders to find added, removed, or modified files?"

"Invoke `Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder)`; the method returns a collection of `FolderComparisonResult` objects that indicate the status of each file pair."

"What should I do if I need to compare password‑protected documents?"

"Supply the password via `LoadOptions.Password` when loading each document; the engine decrypts the files internally before performing the diff."

comparar documentos .net – Tutorial completo de GroupDocs.Comparison para desarrolladores .NET

Si necesitas compare documents .net programáticamente, has llegado a la guía correcta.
Detectar manualmente las diferencias entre dos versiones de un contrato, una hoja de cálculo o una presentación puede consumir horas y aún pasar por alto cambios sutiles. Con GroupDocs.Comparison para .NET puedes automatizar esta tarea, generar informes visuales de diferencias y incluso aceptar o rechazar cambios sin abrir los archivos tú mismo. Este tutorial te guía paso a paso—desde la instalación del paquete NuGet hasta el manejo de comparaciones de carpetas a gran escala—para que puedas integrar una comparación de documentos confiable en cualquier solución .NET.

Respuestas rápidas

¿Cuál es el propósito principal de GroupDocs.Comparison? Para comparar documentos programáticamente, detectar cambios y generar resultados de diferencias visuales o basados en datos.
¿Puedo aceptar o rechazar cambios automáticamente? Sí—usa la API accept/reject para aplicar control granular.
¿La biblioteca soporta comparación de imágenes en .NET? Absolutamente; puedes comparar capturas de pantalla, renders de UI y cualquier imagen raster.
¿Es posible la comparación de carpetas? Sí—compara carpetas completas para detectar archivos añadidos, eliminados o modificados.
¿Qué necesito antes de comenzar? Un entorno de desarrollo .NET, el paquete NuGet y una licencia válida de GroupDocs.Comparison (prueba disponible).

Qué es compare documents .net?

compare documents .net es el proceso de identificar programáticamente diferencias entre dos o más versiones de documentos usando una biblioteca .NET. GroupDocs.Comparison implementa esto cargando los archivos de origen y destino, aplicando opciones de comparación configurables y devolviendo un ComparisonResult que contiene tanto resaltados visuales como una lista estructurada de cambios. ComparisonResult representa el resultado de una comparación, conteniendo los cambios detectados y los datos visuales de diff.

Por qué elegir GroupDocs.Comparison para .NET?

GroupDocs.Comparison soporta más de 50 formatos, procesa PDFs grandes en segundos e incluye funciones de nivel empresarial como manejo de contraseñas, preservación de metadatos y gestión de cambios granulares, eliminando la necesidad de múltiples bibliotecas especializadas y reduciendo el esfuerzo de desarrollo.

Requisitos previos

Visual Studio 2022 o posterior (o cualquier IDE compatible con .NET).
Runtime .NET 6+ (la biblioteca también soporta .NET Core 3.1 y .NET Framework 4.8).
Paquete NuGet GroupDocs.Comparison (última versión estable).
Una clave de licencia válida (puedes comenzar con una prueba de 30 días).

¿Cómo comparar dos documentos .net?

Para comparar dos documentos .net, instancia la clase Comparer, llama a Compare(sourcePath, targetPath, outputPath) y especifica cualquier ComparisonOptions que necesites. El método crea un archivo de diff que resalta inserciones, eliminaciones y cambios de formato, al mismo tiempo que expone una colección Changes para inspección programática. El objeto Comparer es el motor central que impulsa el proceso de comparación.

Guía paso a paso

Crear una instancia de Comparer – este es el objeto central que impulsa el motor de comparación.
Cargar origen y destino – puedes pasar rutas de archivo, streams o matrices de bytes; se recomiendan streams para archivos mayores de 10 MB.
Configurar opciones – ignorar mayúsculas/minúsculas, establecer una contraseña o ajustar la sensibilidad mediante ComparisonOptions.
Ejecutar la comparación – llama a Compare y proporciona una ubicación de salida para el diff visual.
Procesar resultados – lee la colección Changes para aceptar, rechazar o registrar cada modificación.

¿Qué formatos puedo comparar con GroupDocs.Comparison?

GroupDocs.Comparison soporta más de 50 formatos de entrada y salida, incluyendo DOCX, PDF, XLSX, PPTX, PNG, JPEG, BMP y TIFF. También puede manejar archivos protegidos con contraseña y archivos almacenados en almacenamiento en la nube (a través de APIs de stream). Esta amplitud elimina la necesidad de múltiples bibliotecas al construir una canalización universal de procesamiento de documentos.

¿Cómo aceptar o rechazar cambios programáticamente?

El objeto ComparisonResult expone una colección Changes. Cada elemento ChangeInfo describe un cambio detectado y proporciona los métodos Accept() y Reject(). Llama a result.Changes.AcceptAll() para aplicar todos los cambios detectados al documento de destino, o itera result.Changes e invoca Accept() o Reject() en objetos ChangeInfo individuales para un control granular. Después de aplicar las acciones deseadas, guarda el documento actualizado con result.Save(outputPath).

¿Cómo comparar carpetas completas .net?

La comparación de carpetas implica iterar sobre pares de archivos coincidentes y ejecutar la misma lógica Compare para cada par. GroupDocs.Comparison también ofrece un método auxiliar CompareFolders(sourceFolder, targetFolder, outputFolder) que compara todos los archivos coincidentes en dos directorios, detecta archivos añadidos o eliminados y genera resultados de diff. CompareFolders devuelve una colección de objetos FolderComparisonResult, cada uno indicando el estado de un par de archivos y un enlace a su documento de diff.

¿Cómo funciona la comparación de imágenes en .NET?

El módulo de imágenes trata cada píxel como un punto de datos, generando una imagen de diff que resalta las regiones modificadas en rojo y devolviendo una puntuación de similitud (0‑100 %). Llama a Comparer.CompareImages(imagePath1, imagePath2, outputPath); el motor alinea las imágenes, calcula diferencias píxel a píxel, escribe una imagen de diff donde los píxeles alterados se colorean y proporciona un valor Similarity que puedes usar para activar alertas o omitir procesamiento adicional si el cambio está por debajo de un umbral.

Casos de uso comunes

Control de versiones para activos no‑código – mantener un registro de auditoría claro de revisiones de contratos.
Verificaciones de cumplimiento automatizadas – marcar ediciones no autorizadas en documentos de políticas.
Pipelines CI/CD para pruebas de UI – comparar capturas de pantalla de páginas web entre compilaciones.
Proyectos de migración por lotes – verificar que los archivos convertidos conservan el contenido original.

Consejos de rendimiento para documentos grandes

Transmitir archivos en lugar de cargarlos completamente en memoria; esto reduce el uso máximo de RAM hasta en un 80 %.
Reutilizar una única instancia de Comparer para múltiples comparaciones y aprovechar el caché interno.
Ajustar ComparisonOptions.MemoryLimit al trabajar con documentos mayores de 500 MB para evitar excepciones por falta de memoria.

Preguntas frecuentes

P: ¿Cómo aceptar o rechazar cambios programáticamente después de una comparación?
Respuesta: Utiliza result.Changes.AcceptAll(), RejectAll(), o itera cada ChangeInfo y llama a Accept() / Reject() según sea necesario, luego guarda el documento con result.Save(outputPath).

P: ¿Puedo extraer metadatos como autor, fecha de creación o propiedades personalizadas de los documentos?
Respuesta: Sí—DocumentInfo proporciona acceso a metadatos estándar y personalizados tanto para los archivos de origen como de destino, permitiéndote registrar o mostrar esta información.

P: ¿Es posible comparar archivos de imagen (p.ej., PNG, JPEG) directamente en .NET?
Respuesta: Absolutamente. La API CompareImages resalta diferencias a nivel de píxel y devuelve un porcentaje de similitud que puedes usar en pruebas automatizadas.

P: ¿Cómo puedo comparar carpetas completas para encontrar archivos añadidos, eliminados o modificados?
Respuesta: Invoca Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder); el método devuelve una colección de objetos FolderComparisonResult que indican el estado de cada par de archivos.

P: ¿Qué debo hacer si necesito comparar documentos protegidos con contraseña?
Respuesta: Proporciona la contraseña mediante LoadOptions.Password al cargar cada documento; el motor descifra los archivos internamente antes de realizar el diff.

P: ¿GroupDocs.Comparison soporta .NET Core y .NET 5/6?
Respuesta: Sí—la biblioteca es compatible con .NET Core 3.1, .NET 5, .NET 6 y versiones posteriores, ofreciendo el mismo conjunto de funciones en todos los entornos.

Señales de confianza

Última actualización: 2026-05-26
Probado con: GroupDocs.Comparison 23.12 for .NET
Autor: GroupDocs

Enlaces adicionales al tutorial (sin cambios)

Comenzando

Carga de documentos

Comparación básica

Comparación avanzada

Gestión de cambios

Información del documento

Generación de vistas previas

Gestión de metadatos

Seguridad y protección

Licenciamiento y configuración

Opciones de comparación

Leer más Leer más Leer más Leer más Leer más Leer más Comenzando Carga de documentos Comparación básica Comparación avanzada Gestión de cambios Información del documento Generación de vistas previas Gestión de metadatos Seguridad y protección Licenciamiento y configuración Opciones de comparación Inicio rápido Comenzando Comparación de documentos y carpetas Comparación de documentos Carga y guardado de documentos Comparación de imágenes Uso básico Inicio rápido Comenzando Carga de documentos Comparación básica Comparación avanzada Gestión de cambios Información del documento Generación de vistas previas Gestión de metadatos Seguridad y protección Licenciamiento y configuración Opciones de comparación