C# Substring (Funktionsweise für Entwickler)

Syntax und Parameter

Die Substring-Methode hat zwei Hauptformen:

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

1. public string Substring(int startIndex): Diese Methode gibt eine Teilzeichenkette zurück, die bei startIndex beginnt und bis zum Ende der Zeichenkette reicht.
2. public string Substring(int startIndex, int length): Diese Methode gibt eine Teilzeichenkette zurück, die bei startIndex beginnt und die angegebene Länge hat.

Die beteiligten Parameter sind:

• int startIndex: Dies ist der nullbasierte Index, an dem die Teilzeichenkette beginnt.
• int length: (optional) Es handelt sich um den zweiten Parameter. Dies ist die Anzahl der Zeichen, die in die zurückgegebene Teilzeichenfolge aufgenommen werden.

Wie die Substring-Methode funktioniert

Der Prozess der Substring-Methode ist unkompliziert. Wenn aufgerufen, extrahiert sie Zeichen aus der ursprünglichen Zeichenfolge, beginnend bei dem angegebenen Index (startIndex). Wenn der length-Parameter angegeben wird, gibt die Methode die angegebene Anzahl von Zeichen zurück. Ohne den length-Parameter wird die Methode bis zum Ende der Zeichenfolge fortgeführt. Das Verwenden von Substring in C# stellt sicher, dass beide Parameter (startIndex und length) als Ganzzahlen behandelt werden, was Typensicherheit erzwingt und potenzielle Laufzeitfehler verhindert.

Extrahieren bis zum Ende des Strings

Angenommen, Sie haben eine Zeichenfolge und müssen eine Teilzeichenfolge von einem bestimmten Index bis zum Ende der Zeichenfolge extrahieren. So könnten Sie es tun:

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

Ausgabe:

world!

In diesem Beispiel beginnt die Substring-Methode bei Index 7, was dem 'w' in "world!" entspricht, und ruft jedes Zeichen bis zum Ende der Zeichenfolge ab. Dies ist besonders nützlich, wenn die Länge der Teilzeichenfolge dynamisch ist oder nicht vorherbestimmt ist.

Extrahieren einer Teilzeichenkette mit festgelegter Länge

Nun, schauen wir uns ein Szenario an, in dem sowohl der Startindex als auch die Länge der Teilzeichenfolge angegeben sind:

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

Ausgabe:

world

Hier beginnt die Teilzeichenfolge beim siebten Zeichen und erstreckt sich über fünf Zeichen. Diese Methode ist sehr nützlich, wenn Sie die Kontrolle über die Grenzen der Teilzeichenfolge benötigen.

Teilstrings aus einem Array von Zeichenketten abrufen

Angenommen, Sie haben ein Array von Strings und möchten Teilzeichenfolgen aus jedem String basierend auf einer angegebenen Zeichenposition und Länge extrahieren. Sie können eine foreach-Schleife verwenden, um über das Array zu iterieren und die Substring-Methode auf jeden String anzuwenden.

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

Dieser Code gibt aus:

ppl
ana
ran

Überprüfung der Gültigkeit von Indizes

Um sicherzustellen, dass Ihre Teilzeichenfolge-Extraktion keinen Fehler verursacht, können Sie Überprüfungen hinzufügen:

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, world!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, world!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

Dieser Codeblock stellt sicher, dass die Teilzeichenfolgenparameter gültig sind, bevor versucht wird, die Teilzeichenfolge zu extrahieren, und so potenzielle Laufzeitfehler vermieden werden.

Codebeispiel: Erzeugen einer PDF-Datei aus einer extrahierten Zeichenfolge

Betrachten wir ein Szenario, in dem Sie einen großen Text mit wichtigen Informationen an bestimmten Indizes haben und diese Informationen extrahieren und ein PDF-Dokument damit erstellen müssen. Im Folgenden finden Sie ein schrittweises Beispiel dafür, wie dies unter Verwendung von sowohl IronPDF als auch der C# Substring-Methode erreicht werden kann.

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

Dieser Prozess zeigt einen einfachen Weg, Textmanipulation und PDF-Erstellung zu integrieren, was besonders nützlich sein kann für das Erstellen von Berichten oder Dokumentationen, die spezifische Informationen aus größeren Texten extrahieren und präsentieren müssen.