La biblioteca PDF de C#
using IronPdf;
// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
// Export to a file or Stream
pdf.SaveAs("output.pdf");
// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
Install-Package IronPdf
EnPalabra clave ref en C# es una herramienta esencial que todo principiante debería conocer. Se utiliza para pasar argumentos o args por referencia en lugar de por valor, permitiendo que los cambios realizados en la variable de tipo referencia dentro del método llamado se reflejen fuera de él. En este tutorial, repasaremos los detalles de la palabra clave **ref y exploraremos varios ejemplos de código de consola que ilustran su funcionamiento.
Cuando pasas un parámetro a un método en C#, por defecto, se pasa por valor. Esto significa que se crea una copia del valor del parámetro, y cualquier cambio realizado dentro del método de llamada no afectará a la variable original fuera del método. La palabra clave ref cambia este comportamiento, permitiéndole pasar un parámetro por referencia. Cuando un parámetro se pasa por referencia, cualquier cambio realizado dentro del método afectará directamente a la variable original fuera del método.
ref: Se utiliza para indicar que una variable se pasa por referencia.ref.Empecemos por entender el concepto de cómo se pasan las variables por referencia. Imagina que tienes un método que incrementa un entero como se muestra en el siguiente código:
class Program
{
//method returns incremented value
static void IncrementByOne(int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOne(value);
Console.WriteLine(value); // Output: 5
}
}class Program
{
//method returns incremented value
static void IncrementByOne(int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOne(value);
Console.WriteLine(value); // Output: 5
}
}Friend Class Program
'method returns incremented value
Private Shared Sub IncrementByOne(ByVal num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOne(value)
Console.WriteLine(value) ' Output: 5
End Sub
End ClassEn el código anterior, aunque incrementamos num dentro del método IncrementByOne, el value original permanece sin cambios. Esto se debe a que num es una copia de la variable original, y los cambios realizados en ella no afectan a la original.
Veamos ahora cómo la palabra clave ref puede cambiar este comportamiento. Mediante el uso de ref, puede pasar una variable por referencia al método como se muestra en uno de los ejemplos de código a continuación.
class Program
{
//ref int
static void IncrementByOneRef(ref int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOneRef(ref value);
Console.WriteLine(value); // Output: 6
}
}class Program
{
//ref int
static void IncrementByOneRef(ref int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOneRef(ref value);
Console.WriteLine(value); // Output: 6
}
}Friend Class Program
'ref int
Private Shared Sub IncrementByOneRef(ByRef num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOneRef(value)
Console.WriteLine(value) ' Output: 6
End Sub
End ClassObserve la palabra clave ref tanto en la firma del método como en la llamada. Esto indica a C# que desea pasar la variable value por referencia. Como resultado, los cambios realizados dentro del método IncrementByOneRef se reflejan en la variable original value.
La palabra clave ref es particularmente útil cuando se trabaja con tipos como enteros, dobles y structs. Estos tipos se almacenan directamente en memoria, y pasarlos por referencia puede suponer mejoras de rendimiento y un control más preciso de la manipulación de los datos.
Aunque la palabra clave ref se asocia comúnmente con tipos de valor, también puede utilizarse con variables de tipo referencia. Los tipos de referencia, como las clases y las matrices, almacenan una referencia a los datos reales en memoria en lugar de los datos en sí. Esto significa que está tratando con una estructura similar a un puntero, y pasar por referencia puede dar resultados diferentes, como se muestra en el siguiente ejemplo:
class Person
{
public string Name { get; set; }
}
class Program
{
//method
static void ChangeName(ref Person person)
{
//new object
person = new Person { Name = "Alice" };
}
static void Main()
{
Person person = new Person { Name = "Bob" };
ChangeName(ref person);
Console.WriteLine(person.Name); // Output: Alice
}
}class Person
{
public string Name { get; set; }
}
class Program
{
//method
static void ChangeName(ref Person person)
{
//new object
person = new Person { Name = "Alice" };
}
static void Main()
{
Person person = new Person { Name = "Bob" };
ChangeName(ref person);
Console.WriteLine(person.Name); // Output: Alice
}
}Friend Class Person
Public Property Name() As String
End Class
Friend Class Program
'method
Private Shared Sub ChangeName(ByRef person As Person)
'new object
person = New Person With {.Name = "Alice"}
End Sub
Shared Sub Main()
Dim person As New Person With {.Name = "Bob"}
ChangeName(person)
Console.WriteLine(person.Name) ' Output: Alice
End Sub
End ClassEn este ejemplo, el método ChangeName cambia la referencia de la variable person a un nuevo objeto Person. Como resultado, la variable original persona apunta ahora a un objeto diferente, y su nombre es "Alicia".
Puede tener varios métodos con el mismo nombre pero diferentes parámetros. Esto se denomina sobrecarga de métodos. Cuando se utiliza la palabra clave ref, la sobrecarga de métodos se vuelve más potente.
class Calculator
{
public static void Add(ref int x, int y)
{
x += y;
}
public static void Add(ref double x, double y)
{
x += y;
}
}
class Program
{
static void Main()
{
int intValue = 5;
double doubleValue = 7.5;
//ref parameter
Calculator.Add(ref intValue, 3);
Calculator.Add(ref doubleValue, 2.5);
Console.WriteLine(intValue); // Output: 8
Console.WriteLine(doubleValue); // Output: 10.0
}
}class Calculator
{
public static void Add(ref int x, int y)
{
x += y;
}
public static void Add(ref double x, double y)
{
x += y;
}
}
class Program
{
static void Main()
{
int intValue = 5;
double doubleValue = 7.5;
//ref parameter
Calculator.Add(ref intValue, 3);
Calculator.Add(ref doubleValue, 2.5);
Console.WriteLine(intValue); // Output: 8
Console.WriteLine(doubleValue); // Output: 10.0
}
}Friend Class Calculator
Public Shared Sub Add(ByRef x As Integer, ByVal y As Integer)
x += y
End Sub
Public Shared Sub Add(ByRef x As Double, ByVal y As Double)
x += y
End Sub
End Class
Friend Class Program
Shared Sub Main()
Dim intValue As Integer = 5
Dim doubleValue As Double = 7.5
'ref parameter
Calculator.Add(intValue, 3)
Calculator.Add(doubleValue, 2.5)
Console.WriteLine(intValue) ' Output: 8
Console.WriteLine(doubleValue) ' Output: 10.0
End Sub
End ClassEn el ejemplo anterior, estamos sobrecargando el método Add para que funcione con los tipos int y double. La palabra clave ref permite a los métodos modificar directamente las variables originales.
Otra palabra clave relacionada es out. Es similar a ref pero tiene un propósito ligeramente diferente. Mientras que ref espera que la variable se inicialice antes de pasarla, la palabra clave out se utiliza cuando se desea que un método asigne un valor a un parámetro que no necesariamente tiene un valor inicial:
class Program
{
static void Divide(int dividend, int divisor, out int quotient)
{
quotient = dividend / divisor;
}
static void Main()
{
int result;
Divide(10, 2, out result);
Console.WriteLine(result); // Output: 5
}
}class Program
{
static void Divide(int dividend, int divisor, out int quotient)
{
quotient = dividend / divisor;
}
static void Main()
{
int result;
Divide(10, 2, out result);
Console.WriteLine(result); // Output: 5
}
}Friend Class Program
Private Shared Sub Divide(ByVal dividend As Integer, ByVal divisor As Integer, ByRef quotient As Integer)
quotient = dividend \ divisor
End Sub
Shared Sub Main()
Dim result As Integer = Nothing
Divide(10, 2, result)
Console.WriteLine(result) ' Output: 5
End Sub
End ClassEn este ejemplo, el método Divide calcula el cociente y lo asigna a la variable quotient utilizando la palabra clave out. Cabe destacar que no es necesario inicializar el resultado antes de pasarlo al método.
La palabra clave out es similar a la palabra clave ref pero significativamente diferente. Un parámetro out no necesita un valor inicial, mientras que un parámetro ref debe tener valores iniciales antes de la llamada al método.
Aunque las palabras clave ref y out pueden ser herramientas poderosas, deben utilizarse con criterio. El uso incorrecto de estas palabras clave puede dar lugar a un código confuso y a un comportamiento inesperado. Por ejemplo, no puedes utilizar una variable que no sea ref en un parámetro ref o out sin inicializarla antes, ya que provocaría un error de compilación.
Entender la diferencia entre dos referencias y tipos de valor es crucial cuando se trabaja con la palabra clave ref.
Tipo de valor: La variable contiene directamente los datos, por ejemplo, enteros, flotantes, etc.
El uso de ref con tipos de valor permite que los cambios se reflejen fuera del método, mientras que las variables de tipo referencia se comportan inherentemente de esta manera.
También puede utilizar la palabra clave ref con métodos de extensión. Un ejemplo:
public static class StringExtensions
{
//example
public static void AppendValue(ref this string input, string value)
{
input += value;
}
}public static class StringExtensions
{
//example
public static void AppendValue(ref this string input, string value)
{
input += value;
}
}Public Module StringExtensions
'example
Public Sub AppendValue(ByRef Me input As String, ByVal value As String)
input &= value
End Sub
End ModuleSi olvida incluir la palabra clave ref en la firma del método o en la llamada al método, se producirá un error de compilación.
Async y parámetros de referenciaTen en cuenta que no puedes usar parámetros ref con métodos iteradores o métodos async, ya que estos requieren pasar el parámetro por valor.
Además de comprender conceptos clave como la palabra clave ref en C#, existe un conjunto de potentes herramientas que pueden hacer la vida de un desarrollador mucho más fácil. Iron Suite es una colección de sólidas herramientas y bibliotecas que incluye IronPDF, IronXL, IronOCR e IronBarcode. Exploremos estas herramientas y veamos cómo pueden mejorar tu experiencia de codificación sin ningún argumento.
Más información sobre IronPDF como parte esencial de Iron Suite. Se trata de una biblioteca que permite a los desarrolladores crear, leer y editar archivos PDF en C#. Si desea convertir HTML a PDF, IronPDF tiene las herramientas que necesita. Echa un vistazo a latutorial sobre la conversión de HTML a PDF para obtener más información sobre esta función.
Trabajar con archivos Excel en C# puede ser un reto, peroCaracterísticas de IronXL simplificar esta tarea. Permite leer, escribir, editar y manipular archivos de Excel sin necesidad de tener Excel instalado. Desde la importación de datos hasta la creación de nuevas hojas de cálculo, IronXL permite manejar Excel en C#.
Reconocimiento óptico de caracteres(OCR) puede ser compleja, perodescubra IronOCR para agilizar el proceso. Esta biblioteca permite leer texto de imágenes y convertirlo en texto legible por máquina. Tanto si necesita extraer texto de un documento escaneado como reconocer caracteres de una imagen, IronOCR tiene la funcionalidad para ayudarle.
Los códigos de barras son de uso común en diversas industrias, y manejarlos en sus aplicaciones es ahora más accesible con el programaBiblioteca IronBarcode. Esta biblioteca le permite crear, leer y trabajar con códigos de barras en C#. IronBarcode admite una amplia gama de formatos QR y de códigos de barras.
Te preguntarás qué relación tienen estas herramientas con la palabra clave ref de la que hemos hablado. Cuando trabaje en proyectos complejos que impliquen PDF, Excel, OCR o códigos de barras, el uso eficaz de la palabra clave ref y otros principios de C# serán cruciales para gestionar su código de forma eficiente.
Por ejemplo, cuando se manipulan grandes archivos de Excel con IronXL, pasar objetos por referencia usando la palabra clave ref puede hacer su código más eficiente y mantenible. Del mismo modo, trabajar con documentos PDF utilizando IronPDF podría implicar métodos en los que la palabra clave ref puede desempeñar un papel.
La comprensión de las características básicas del lenguaje, como la palabra clave ref, y el acceso a herramientas como Iron Suite le proporcionan una potente combinación para crear aplicaciones eficaces, robustas y versátiles. Iron Suite está diseñado para funcionar a la perfección con sus conocimientos de C# y, juntos, pueden ayudarle a crear soluciones más profesionales y sofisticadas.
El lenguaje C#, con funciones como la palabra clave ref, ofrece potentes posibilidades a los desarrolladores. En combinación con Iron Suite, que incluye IronPDF, IronXL, IronOCR e IronBarcode, las posibilidades se amplían aún más.
Cada producto de la Iron Suite ofreceprueba gratuita de Iron Suiteque le permite explorar y utilizar las amplias funcionalidades sin ninguna inversión inmediata. Si decide adquirir una licencia completa, los precios comienzan a partir de $749 para componentes individuales.
Si considera que toda la Iron Suite se ajusta a sus necesidades, le espera una excelente oferta. Puede adquirir el paquete completo por el precio de sólo dos componentes individuales.
Install-Package IronPdf
¿Quieres desplegar IronPDF en un proyecto vivo GRATIS?
Tu clave de prueba debería estar en el correo electrónico.
El formulario de prueba se presentó
con éxito.
Si no es así, póngase en contacto con
support@ironsoftware.com
Empezar GRATIS
No se necesita tarjeta de crédito
Pruebe en producción sin marcas de agua.
Funciona donde lo necesites.
Consigue 30 días de producto totalmente funcional.
Póngalo en marcha en cuestión de minutos.
Acceso completo a nuestro equipo de asistencia técnica durante la prueba del producto
No se necesita tarjeta de crédito ni crear una cuenta
Tu clave de prueba debería estar en el correo electrónico.
Si no es así, póngase en contacto con
support@ironsoftware.com
Empezar GRATIS
No se necesita tarjeta de crédito
Pruebe en producción sin marcas de agua.
Funciona donde lo necesites.
Consigue 30 días de producto totalmente funcional.
Póngalo en marcha en cuestión de minutos.
Acceso completo a nuestro equipo de asistencia técnica durante la prueba del producto
Licencias de 9. ¿Tiene alguna pregunta? Póngase en contacto.
9 productos API .NET para sus documentos de oficina
