Métodos de string em C# (Como funciona para desenvolvedores)

Principais características

• Conversão de HTML para PDF: Converta facilmente conteúdo HTML em PDFs totalmente formatados.
• Extração de texto: Extraia e manipule texto de PDFs existentes.
• Edição de PDF: Adicione texto, imagens e anotações a PDFs ou atualize o conteúdo existente.
• Assinaturas digitais: Adicione assinaturas digitais seguras a PDFs.
• Conformidade com PDF/A: Garanta que seus PDFs atendam aos rigorosos padrões de arquivamento .
• Suporte multiplataforma: Funciona com .NET Framework, .NET Core e .NET 5/6 em Windows, Linux e macOS.

O IronPDF oferece um conjunto abrangente de ferramentas para lidar com todas as suas necessidades em PDF com facilidade e eficiência. Comece a explorar hoje mesmo os seus poderosos recursos com um teste gratuito e veja como o IronPDF pode otimizar seus fluxos de trabalho com PDFs!

Concatenação

A concatenação é uma das operações mais simples ao trabalhar com strings. Em C#, existem várias maneiras de unir duas ou mais strings, sendo os métodos mais comuns o operador + e String.Concat() .

string text1 = "Hello";
string text2 = "World";
string result = text1 + " " + text2;  // Output: "Hello World"

string text1 = "Hello";
string text2 = "World";
string result = text1 + " " + text2;  // Output: "Hello World"

Dim text1 As String = "Hello"
Dim text2 As String = "World"
Dim result As String = text1 & " " & text2 ' Output: "Hello World"

Ao trabalhar com o IronPDF, você pode precisar concatenar strings para criar um documento completo ou manipular o texto no conteúdo extraído. Por exemplo, você pode mesclar o cabeçalho e o corpo de um documento PDF como strings antes de aplicar a formatação:

var pdfText = "Header: " + extractedHeader + "\n" + "Body: " + extractedBody;

var pdfText = "Header: " + extractedHeader + "\n" + "Body: " + extractedBody;

Imports Microsoft.VisualBasic

Dim pdfText = "Header: " & extractedHeader & vbLf & "Body: " & extractedBody

Isso demonstra como a simples concatenação de strings pode mesclar substrings específicas em um bloco coeso. Como veremos mais adiante, essas sequências concatenadas podem ser usadas para criar conteúdo dinâmico para PDFs.

Saída em PDF:

String de saída do PDF

Ao criar um novo documento usando o IronPDF, a posição do índice especificada para as sequências de texto será crucial para determinar onde elementos como o cabeçalho ou o corpo do texto aparecerão na página. Dessa forma, o objeto de string atual pode influenciar diretamente as decisões de layout.

Formatação de texto em PDFs

Depois de extrair e manipular o texto, talvez seja necessário formatá-lo antes de adicioná-lo a um novo PDF. O IronPDF permite definir estilos de fonte, tamanhos e até mesmo o posicionamento usando o recurso de conversão RenderHtmlAsPdf , onde os métodos de string C# podem ajudar a gerar conteúdo formatado dinamicamente.

Por exemplo, você pode criar cabeçalhos e conteúdo de corpo dinâmicos concatenando strings com tags HTML:

string htmlContent = "<h1>" + headerText + "</h1>" + "<p>" + bodyText + "</p>";

string htmlContent = "<h1>" + headerText + "</h1>" + "<p>" + bodyText + "</p>";

Dim htmlContent As String = "<h1>" & headerText & "</h1>" & "<p>" & bodyText & "</p>"

Esse conteúdo HTML pode então ser convertido em um PDF bem formatado usando o IronPDF:

PdfDocument pdf = HtmlToPdf.ConvertHtmlString(htmlContent);
pdf.SaveAs("formattedDocument.pdf");

PdfDocument pdf = HtmlToPdf.ConvertHtmlString(htmlContent);
pdf.SaveAs("formattedDocument.pdf");

Dim pdf As PdfDocument = HtmlToPdf.ConvertHtmlString(htmlContent)
pdf.SaveAs("formattedDocument.pdf")

Saída em PDF:

Essa abordagem permite gerar PDFs com conteúdo gerado dinamicamente de forma fácil, garantindo ao mesmo tempo a formatação correta do texto. Ao gerar uma nova string a partir de conteúdo dinâmico, você pode passar arrays de strings formatadas de conteúdo HTML para o IronPDF, garantindo que a saída em PDF corresponda aos seus requisitos.

Pesquisa por uma substring específica

Em muitos casos, você precisará verificar se uma string contém uma substring específica. O método Contains() é útil para isso, pois retorna true ou false dependendo se a string especificada existe dentro da string de destino.

string documentText = "Invoice Number: 12345";
bool containsInvoiceNumber = documentText.Contains("Invoice Number");

string documentText = "Invoice Number: 12345";
bool containsInvoiceNumber = documentText.Contains("Invoice Number");

Dim documentText As String = "Invoice Number: 12345"
Dim containsInvoiceNumber As Boolean = documentText.Contains("Invoice Number")

Encontrar a posição específica de um personagem

Para encontrar um caractere específico dentro de uma string, o método IndexOf() é particularmente útil. Retorna a posição especificada onde o caractere ou substring aparece pela primeira vez na string.

string str = "Invoice Number: 12345";
int position = str.IndexOf('5'); // Returns the position of the first '5'

string str = "Invoice Number: 12345";
int position = str.IndexOf('5'); // Returns the position of the first '5'

Dim str As String = "Invoice Number: 12345"
Dim position As Integer = str.IndexOf("5"c) ' Returns the position of the first '5'

Isso pode ser útil ao extrair dados dinâmicos, como números ou datas, de um texto em um PDF usando o IronPDF.

Expressões regulares

Para extração de texto mais complexa, as expressões regulares (Regex) oferecem uma ferramenta poderosa para reconhecimento de padrões. Com expressões regulares (Regex), você pode extrair dados estruturados, como datas, números de faturas ou até mesmo endereços de e-mail, de textos não estruturados em um PDF.

using System.Text.RegularExpressions;

string text = "Date: 02/11/2025";
Match match = Regex.Match(text, @"\d{2}/\d{2}/\d{4}");
if (match.Success)
{
    string date = match.Value;  // Output: "02/11/2025"
}

using System.Text.RegularExpressions;

string text = "Date: 02/11/2025";
Match match = Regex.Match(text, @"\d{2}/\d{2}/\d{4}");
if (match.Success)
{
    string date = match.Value;  // Output: "02/11/2025"
}

Imports System.Text.RegularExpressions

Private text As String = "Date: 02/11/2025"
Private match As Match = Regex.Match(text, "\d{2}/\d{2}/\d{4}")
If match.Success Then
	Dim [date] As String = match.Value ' Output: "02/11/2025"
End If

Expressões regulares podem ser particularmente úteis para documentos com conteúdo variável ou formatos específicos que você precisa capturar. Utilizar o IronPDF para extrair texto bruto, combinado com expressões regulares, ajuda a automatizar tarefas como processamento de formulários, validação de dados e geração de relatórios.

Construtor de strings para textos grandes

Ao trabalhar com grandes blocos de texto, como várias páginas de conteúdo ou relatórios baseados em dados, é mais eficiente usar um StringBuilder em vez da concatenação de strings comum. O StringBuilder é otimizado para cenários em que você precisa adicionar ou modificar grandes quantidades de texto sem criar várias instâncias de string intermediárias.

StringBuilder sb = new StringBuilder();
sb.AppendLine("Header: " + headerText);
sb.AppendLine("Content: " + bodyText);
string finalText = sb.ToString();

StringBuilder sb = new StringBuilder();
sb.AppendLine("Header: " + headerText);
sb.AppendLine("Content: " + bodyText);
string finalText = sb.ToString();

Dim sb As New StringBuilder()
sb.AppendLine("Header: " & headerText)
sb.AppendLine("Content: " & bodyText)
Dim finalText As String = sb.ToString()

O IronPDF consegue lidar com documentos PDF grandes, e a integração do StringBuilder no seu fluxo de trabalho garante um melhor desempenho ao gerar ou manipular textos extensos em PDFs.

Verificar se uma instância de string corresponde a um padrão

O método Equals() verifica se duas instâncias de string correspondem, ou seja, se elas têm o mesmo valor. Isso é particularmente útil para validação ou comparação de conteúdo em PDF.

string str1 = "Invoice";
string str2 = "Invoice";
bool isMatch = str1.Equals(str2); // Returns true as both have the same value

string str1 = "Invoice";
string str2 = "Invoice";
bool isMatch = str1.Equals(str2); // Returns true as both have the same value

Dim str1 As String = "Invoice"
Dim str2 As String = "Invoice"
Dim isMatch As Boolean = str1.Equals(str2) ' Returns true as both have the same value

No IronPDF, isso poderia ser aplicado ao comparar o texto extraído para garantir que ele corresponda a um formato ou valor desejado.

Manipulação de caracteres Unicode

Ao trabalhar com texto em PDFs, pode ser necessário manipular ou verificar a presença de caracteres Unicode específicos. O método IndexOf() também pode ser usado para encontrar a posição de um caractere Unicode específico dentro de uma string.

string unicodeStr = "Hello * World";
int unicodePosition = unicodeStr.IndexOf('*'); // Finds the position of the unicode character

string unicodeStr = "Hello * World";
int unicodePosition = unicodeStr.IndexOf('*'); // Finds the position of the unicode character

Dim unicodeStr As String = "Hello * World"
Dim unicodePosition As Integer = unicodeStr.IndexOf("*"c) ' Finds the position of the unicode character

Saída em PDF

Além disso, converter strings em uma matriz de caracteres Unicode pode ser útil ao trabalhar com texto em diferentes idiomas ou símbolos:

char[] unicodeArray = "Hello * World".ToCharArray();

char[] unicodeArray = "Hello * World".ToCharArray();

Dim unicodeArray() As Char = "Hello * World".ToCharArray()

Isso permite uma manipulação mais precisa dos caracteres, especialmente ao lidar com PDFs em vários idiomas ou formatos.

Extração e manipulação de substrings

Outra funcionalidade poderosa ao trabalhar com strings é a capacidade de extrair uma substring específica. O método Substring() permite selecionar partes de uma string a partir de uma posição de índice especificada. Isso é essencial para extrair dados relevantes do conteúdo de PDFs.

string sentence = "Total: $45.00";
string totalAmount = sentence.Substring(7); // Extracts "$45.00"

string sentence = "Total: $45.00";
string totalAmount = sentence.Substring(7); // Extracts "$45.00"

Dim sentence As String = "Total: $45.00"
Dim totalAmount As String = sentence.Substring(7) ' Extracts "$45.00"

Essa técnica é útil ao processar faturas ou qualquer tipo de texto estruturado em um PDF.

Exemplo: Criando uma fatura personalizada em PDF

Imagine que precisamos gerar uma fatura em PDF dinamicamente, extraindo informações como o nome do cliente, endereço e itens comprados. Usaremos diversos métodos de string para formatar e manipular os dados antes de gerar o PDF final.

using IronPdf;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        // Sample customer data
        string customerName = "John Doe";
        string customerAddress = "123 Main Street, Springfield, IL 62701";
        string[] purchasedItems = { "Item 1 - $10.00", "Item 2 - $20.00", "Item 3 - $30.00" };

        // Start building the HTML content for the invoice
        StringBuilder invoiceContent = new StringBuilder();

        // Adding the header
        invoiceContent.AppendLine("<h1>Invoice</h1>");
        invoiceContent.AppendLine("<h2>Customer Details</h2>");
        invoiceContent.AppendLine("<p><strong>Name:</strong> " + customerName + "</p>");
        invoiceContent.AppendLine("<p><strong>Address:</strong> " + customerAddress + "</p>");

        // Adding the list of purchased items
        invoiceContent.AppendLine("<h3>Items Purchased</h3>");
        invoiceContent.AppendLine("<ul>");
        foreach (var item in purchasedItems)
        {
            invoiceContent.AppendLine("<li>" + item + "</li>");
        }
        invoiceContent.AppendLine("</ul>");

        // Calculate total cost (basic manipulation with string methods)
        double totalCost = 0;
        foreach (var item in purchasedItems)
        {
            string priceString = item.Substring(item.LastIndexOf('$') + 1);
            double price = Convert.ToDouble(priceString);
            totalCost += price;
        }

        // Adding total cost
        invoiceContent.AppendLine("<p><strong>Total Cost:</strong> $" + totalCost.ToString("F2") + "</p>");

        // Convert the HTML to PDF using IronPDF
        var pdf = HtmlToPdf.ConvertHtmlString(invoiceContent.ToString());

        // Save the generated PDF
        pdf.SaveAs("Invoice_Johndoe.pdf");
        Console.WriteLine("Invoice PDF generated successfully.");
    }
}

using IronPdf;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        // Sample customer data
        string customerName = "John Doe";
        string customerAddress = "123 Main Street, Springfield, IL 62701";
        string[] purchasedItems = { "Item 1 - $10.00", "Item 2 - $20.00", "Item 3 - $30.00" };

        // Start building the HTML content for the invoice
        StringBuilder invoiceContent = new StringBuilder();

        // Adding the header
        invoiceContent.AppendLine("<h1>Invoice</h1>");
        invoiceContent.AppendLine("<h2>Customer Details</h2>");
        invoiceContent.AppendLine("<p><strong>Name:</strong> " + customerName + "</p>");
        invoiceContent.AppendLine("<p><strong>Address:</strong> " + customerAddress + "</p>");

        // Adding the list of purchased items
        invoiceContent.AppendLine("<h3>Items Purchased</h3>");
        invoiceContent.AppendLine("<ul>");
        foreach (var item in purchasedItems)
        {
            invoiceContent.AppendLine("<li>" + item + "</li>");
        }
        invoiceContent.AppendLine("</ul>");

        // Calculate total cost (basic manipulation with string methods)
        double totalCost = 0;
        foreach (var item in purchasedItems)
        {
            string priceString = item.Substring(item.LastIndexOf('$') + 1);
            double price = Convert.ToDouble(priceString);
            totalCost += price;
        }

        // Adding total cost
        invoiceContent.AppendLine("<p><strong>Total Cost:</strong> $" + totalCost.ToString("F2") + "</p>");

        // Convert the HTML to PDF using IronPDF
        var pdf = HtmlToPdf.ConvertHtmlString(invoiceContent.ToString());

        // Save the generated PDF
        pdf.SaveAs("Invoice_Johndoe.pdf");
        Console.WriteLine("Invoice PDF generated successfully.");
    }
}

Imports IronPdf
Imports System
Imports System.Text

Friend Class Program
	Shared Sub Main()
		' Sample customer data
		Dim customerName As String = "John Doe"
		Dim customerAddress As String = "123 Main Street, Springfield, IL 62701"
		Dim purchasedItems() As String = { "Item 1 - $10.00", "Item 2 - $20.00", "Item 3 - $30.00" }

		' Start building the HTML content for the invoice
		Dim invoiceContent As New StringBuilder()

		' Adding the header
		invoiceContent.AppendLine("<h1>Invoice</h1>")
		invoiceContent.AppendLine("<h2>Customer Details</h2>")
		invoiceContent.AppendLine("<p><strong>Name:</strong> " & customerName & "</p>")
		invoiceContent.AppendLine("<p><strong>Address:</strong> " & customerAddress & "</p>")

		' Adding the list of purchased items
		invoiceContent.AppendLine("<h3>Items Purchased</h3>")
		invoiceContent.AppendLine("<ul>")
		For Each item In purchasedItems
			invoiceContent.AppendLine("<li>" & item & "</li>")
		Next item
		invoiceContent.AppendLine("</ul>")

		' Calculate total cost (basic manipulation with string methods)
		Dim totalCost As Double = 0
		For Each item In purchasedItems
			Dim priceString As String = item.Substring(item.LastIndexOf("$"c) + 1)
			Dim price As Double = Convert.ToDouble(priceString)
			totalCost += price
		Next item

		' Adding total cost
		invoiceContent.AppendLine("<p><strong>Total Cost:</strong> $" & totalCost.ToString("F2") & "</p>")

		' Convert the HTML to PDF using IronPDF
		Dim pdf = HtmlToPdf.ConvertHtmlString(invoiceContent.ToString())

		' Save the generated PDF
		pdf.SaveAs("Invoice_Johndoe.pdf")
		Console.WriteLine("Invoice PDF generated successfully.")
	End Sub
End Class

Explicação