{"id":2249,"date":"2024-10-17T13:10:48","date_gmt":"2024-10-17T13:10:48","guid":{"rendered":"http:\/\/localhost:10003\/?p=2249"},"modified":"2025-08-04T13:55:31","modified_gmt":"2025-08-04T13:55:31","slug":"uso-de-plantillas-sustitucion-de-texto-y-conversion-a-pdf","status":"publish","type":"post","link":"https:\/\/xceed.com\/es\/blog\/tutorials\/using-templates-replacing-text-and-converting-to-pdf\/","title":{"rendered":"Uso de plantillas, sustituci\u00f3n de texto y conversi\u00f3n a PDF"},"content":{"rendered":"

M\u00e1s informaci\u00f3n Xceed Words para .NET<\/a><\/p>\n\n\n\n

Ahora que hemos cubierto la mayor parte de lo que se puede a\u00f1adir a un documento, veamos c\u00f3mo utilizar plantillas y sustituir texto autom\u00e1ticamente, as\u00ed como c\u00f3mo convertir un documento a PDF.<\/p>\n\n\n\n

Plantillas<\/h2>\n\n\n\n

La aplicaci\u00f3n de una plantilla a un documento se realiza llamando a la funci\u00f3n AplicarPlantilla<\/em> en el documento.<\/p>\n\n\n\n

En AplicarPlantilla<\/em> admite 4 sobrecargas, dependiendo de si se pasa una ruta de archivo o un flujo, y de si se incluye el par\u00e1metro opcional para indicar si el contenido del texto de la plantilla de documento debe copiarse en el documento (verdadero por defecto).<\/p>\n\n\n\n

Ejemplo de utilizaci\u00f3n de una ruta de archivo:<\/p>\n\n\n\n

\/\/ Get the path to a template document\nvar templatePath = MyResourcesDirectory + @\"Template.docx\";\n\n\/\/ Apply the template to a document\ndocument1.ApplyTemplate( templatePath );\n\n\/\/ Apply the template to a document, but do not copy the content of the template to the document\ndocument2.ApplyTemplate( templatePath, false );\n<\/code><\/pre>\n\n\n\n
Sustituci\u00f3n de texto<\/h2>\n\n\n\n
En SustituirTexto<\/em> est\u00e1 disponible tanto en el documento como en el p\u00e1rrafo, lo que permite la flexibilidad de sustituir el texto s\u00f3lo en un p\u00e1rrafo espec\u00edfico o en todo el documento.<\/p>\n\n\n\n
En SustituirTexto<\/em> admite 2 sobrecargas, una para proporcionar un nuevo valor de cadena y otra para proporcionar una funci\u00f3n que se utilizar\u00e1 como controlador de coincidencias regex.<\/p>\n\n\n\n
En ambas sobrecargas, debe proporcionarse un valor de b\u00fasqueda (cadena), as\u00ed como el nuevo valor correspondiente en funci\u00f3n de la sobrecarga utilizada. Tambi\u00e9n hay varios par\u00e1metros opcionales disponibles, incluyendo la capacidad de rastrear los cambios o no, las RegexOptions, el nuevo Formato, el Formato de coincidencia, las MatchFormattingOptions y si los p\u00e1rrafos vac\u00edos deben ser eliminados o no.<\/p>\n\n\n\n
\/\/ Simple text replacement in a paragraph\np.ReplaceText(\"<FIRST_NAME>\", \"John\");\np.ReplaceText(\"<LAST_NAME>\", \"Doe\");\n\n\/\/ Simple text replacement in a document\ndocument.ReplaceText(\"<CODE>\", \"A3124x\");\n<\/code><\/pre>\n\n\n\n
Un ejemplo m\u00e1s complejo tambi\u00e9n est\u00e1 disponible en la documentaci\u00f3n aqu\u00ed<\/a>.<\/p>\n\n\n\n
Sustituci\u00f3n de texto por objetos<\/h2>\n\n\n\n
Tambi\u00e9n es posible sustituir texto por objetos utilizando la funci\u00f3n ReemplazarTextoConObjeto<\/em> tambi\u00e9n disponible tanto en documento como en p\u00e1rrafo.<\/p>\n\n\n\n
En ReemplazarTextoConObjeto<\/em> espera el valor de b\u00fasqueda y el objeto a a\u00f1adir como par\u00e1metros obligatorios y tiene varios par\u00e1metros opcionales de forma similar al m\u00e9todo SustituirTexto<\/em> m\u00e9todo.<\/p>\n\n\n\n
\/\/ Replace text with an Image\ndocument.ReplaceTextWithObject( \"<YEAR_IMAGE>\", picture, false, RegexOptions.IgnoreCase );\n\n\/\/ Replace text with a Hyperlink\ndocument.ReplaceTextWithObject( \"<YEAR_LINK>\", hyperlink );\n\n\/\/ Replace text with a Table\ndocument.ReplaceTextWithObject( \"<YEAR_TABLE>\", table );\n<\/code><\/pre>\n\n\n\n
Convertir a PDF<\/h2>\n\n\n\n
Para convertir un documento a PDF, el bot\u00f3n ConvertToPdf<\/em> se llama al m\u00e9todo.<\/p>\n\n\n\n
En ConvertToPdf<\/em> tiene 2 sobrecargas para soportar dos posibles salidas, una para un nombre de archivo, la otra para un flujo. En ambos casos, sin embargo, espera el documento a convertir como primer par\u00e1metro.<\/p>\n\n\n\n
Ejemplo cuando se utiliza un nombre de archivo como salida:<\/p>\n\n\n\n
using( var document = DocX.Load( \"DocumentToConvert.docx\" ) )\n{\n\t\/\/ Convert the Document to PDF and output to a pdf file\n\tDocX.ConvertToPdf( document, \"ConvertedDocument.pdf\" );\n}\n<\/code><\/pre>\n\n\n\n
Notas:<\/p>\n\n\n\n