IRONSOFTWAREHOME
AKTUALNOŚCI DLA PROGRAMISTÓW

C# Substring (jak to działa dla programistów)

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Jacob Mellor
Updated: 23 kwietnia 2026

W języku C# metoda Substring jest niezbędnym narzędziem do manipulowania ciągami znaków. Ta funkcja pozwala programistom wyodrębnić fragment ciągu znaków na podstawie określonej pozycji znaku. Niniejszy przewodnik ma na celu dokładne wyjaśnienie metody Substring oraz biblioteki IronPDF, dostarczając szczegółowe przykłady i objaśnienia, które pomogą początkującym w pełni zrozumieć jej zastosowanie i możliwości.

Zrozumienie metody Substring

Metoda Substring w języku C#, należąca do klasy String, umożliwia manipulowanie ciągiem znaków, zaczynając od pierwszego znaku, w oparciu o określone parametry. Służy do pobierania fragmentu ciągu znaków, zaczynającego się od określonego indeksu i, opcjonalnie, o określonej długości. Składnia tej metody jest prosta, co ułatwia jej wdrożenie w każdym scenariuszu programowania, w którym konieczna jest manipulacja ciągami znaków.

Składnia i parametry

Metoda Substring ma dwie podstawowe formy:

public string Substring(int startIndex);
public string Substring(int startIndex, int length);
  1. public string Substring(int startIndex): Pobiera podciąg, który zaczyna się od startIndex i trwa do końca ciągu.
  2. public string Substring(int startIndex, int length): Pobiera podciąg zaczynający się od startIndex i o określonej długości.

Istotne parametry to:

  • int startIndex: Jest to indeks zaczynający się od zera, od którego zaczyna się podciąg.
  • int length: (opcjonalnie) Jest to drugi parametr. Jest to liczba znaków, które należy uwzględnić w zwracanym podciągu.

Jak działa metoda Substring

Działanie metody Substring jest proste. Po wywołaniu funkcja wyodrębnia znaki z oryginalnego ciągu znaków, zaczynając od podanego indeksu (startIndex). Jeśli podano parametr długości, metoda zwraca określoną liczbę znaków. Bez parametru długości tłumaczenie będzie kontynuowane do końca ciągu znaków. Użycie funkcji Substring w języku C# gwarantuje, że oba parametry (startIndex i length) są traktowane jako liczby całkowite, co zapewnia bezpieczeństwo typów i zapobiega potencjalnym błędom w czasie wykonywania.

Szczegółowe przykłady metody Substring

Aby lepiej zrozumieć, w jaki sposób zaimplementowano metodę Substring, rozważmy kilka przykładów ilustrujących jej praktyczne zastosowania.

Wyodrębnianie do końca ciągu znaków

Załóżmy, że masz ciąg znaków i chcesz wyodrębnić podciąg od określonego indeksu do końca ciągu. Oto jak można to zrobić:

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

Wynik:

świat!
Text

W tym przykładzie metoda Substring rozpoczyna się od indeksu 7, który odpowiada literze "w" w słowie "świat!", i pobiera wszystkie znaki aż do końca ciągu. Jest to szczególnie przydatne, gdy długość podciągu jest dynamiczna lub nie jest z góry określona.

Wyodrębnianie podciągu o określonej długości

Przyjrzyjmy się teraz scenariuszowi, w którym określono zarówno indeks początkowy, jak i długość podciągu:

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

Wynik:

world
Text

W tym przypadku podciąg zaczyna się od siódmego znaku i ma długość pięciu znaków. Ta metoda jest bardzo przydatna, gdy potrzebna jest precyzyjna kontrola nad granicami podciągu.

Pobieranie podciągów z tablicy ciągów znaków

Załóżmy, że masz tablicę ciągów znaków i chcesz wyodrębnić podciągi z każdego ciągu na podstawie określonej pozycji znaku i długości. Można użyć pętli foreach do iteracji nad tablicą i zastosować metodę Substring do każdego ciągu znaków.

// 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);
}

Ten kod wyświetli:

ppl
ana
ran
Text

Postępowanie w przypadkach skrajnych

Ważne jest, aby uwzględnić skrajne przypadki, aby uniknąć błędów wykonania, takich jak ArgumentOutOfRangeException. Podczas korzystania z metody Substring należy upewnić się, że określona pozycja znaku i długość mieszczą się w granicach oryginalnego ciągu znaków. W przeciwnym razie może to spowodować wyjątek indeksu poza zakresem. Możesz sprawdzić długość oryginalnego ciągu znaków, aby uniknąć takich wyjątków. Oto kilka kluczowych punktów:

  • Wartość startIndex musi mieścić się w granicach ciągu znaków.
  • Suma startIndex i length nie może przekraczać długości oryginalnego ciągu znaków.
  • Ujemne wartości dla startIndex lub length są niedozwolone i spowodują błąd.

Sprawdzanie poprawności indeksów

Aby upewnić się, że wyodrębnianie podciągów nie powoduje błędu, można dodać sprawdzanie:

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, świat!";
    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.");
    }
}

Ten blok kodu sprawdza poprawność parametrów podciągu przed próbą jego wyodrębnienia, co pozwala uniknąć potencjalnych błędów wykonania.

Integracja IronPDF z Substring w C# do dynamicznego tworzenia PDF

IronPDF to potężna biblioteka PDF, która pozwala programistom tworzyć, modyfikować i renderować dokumenty PDF bezpośrednio w ich aplikacjach .NET. Umożliwia konwersję HTML do PDF, co pomaga tworzyć spersonalizowane i estetyczne dokumenty PDF. IronPDF obsługuje szeroki zakres operacji związanych z plikami PDF, w tym generowanie plików PDF z HTML, eksportowanie plików PDF, edycję istniejących plików PDF i wiele więcej, zapewniając kompleksowy zestaw narzędzi do obsługi plików PDF w środowisku .NET.

IronPDF ułatwia konwersję HTML do PDF, zachowując układ i style. To świetne narzędzie do tworzenia plików PDF z treści internetowych, takich jak raporty, faktury i dokumentacja. Pliki HTML, adresy URL i ciągi znaków HTML można płynnie konwertować na pliki PDF.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");
        
        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");
        
        // 3. Convert URL to PDF
        var url = "https://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Połączenie IronPDF z metodą Substring w języku C# może być niezwykle przydatne do generowania dokumentów PDF, które wymagają manipulacji tekstem i jego wyodrębniania przed konwersją do formatu PDF. Na przykład, jeśli chcesz wyodrębnić konkretne informacje z dużego bloku tekstu i przedstawić je w formacie PDF, możesz użyć metody Substring do wyodrębnienia żądanego tekstu oraz IronPDF do konwersji tego tekstu na dokument PDF.

Przykład kodu: Generowanie pliku PDF na podstawie wyodrębnionego ciągu znaków

Rozważmy scenariusz, w którym masz duży tekst zawierający ważne informacje w określonych miejscach i musisz wyodrębnić te informacje oraz wygenerować z nich plik PDF. Poniżej znajduje się przykład krok po kroku, jak można to osiągnąć przy użyciu zarówno IronPDF, jak i metody Substring w języku C#.

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.");
    }
}

C# Substring (Jak to działa dla deweloperów): Rysunek 1

Proces ten pokazuje prosty sposób na połączenie edycji tekstu z tworzeniem plików PDF, co może być szczególnie przydatne przy generowaniu raportów lub dokumentacji wymagających wyodrębnienia i przedstawienia konkretnych informacji z większych tekstów.

Wnioski

C# Substring (Jak to działa dla deweloperów): Rysunek 2

Metoda Substring w języku C# jest potężnym narzędziem do manipulacji ciągami znaków, umożliwiającym programistom łatwe wyodrębnianie fragmentów tekstu na podstawie określonych pozycji znaków. Dzięki zrozumieniu i wykorzystaniu tej metody można skutecznie wykonywać szeroki zakres zadań związanych z przetwarzaniem tekstu. Pamiętaj, aby uwzględnić skrajne przypadki i zweryfikować indeksy, aby zachować niezawodność aplikacji. IronPDF oferuje bezpłatną wersję próbną dla deweloperów do eksploracji jego funkcjonalności, a licencjonowanie produktu zaczyna się od $999.

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Dyrektor ds. technologii

Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.

...
Czytaj więcej

Powiązane artykuły

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta