IRONSOFTWAREHOME
MISES À JOUR POUR LES DÉVELOPPEURS

C# Substring (Comment ça fonctionne pour les développeurs)

Jacob Mellor, Directeur technique @ Team Iron
Jacob Mellor
Updated: 23 avril 2026

En C#, la méthode Substring est un outil essentiel pour la manipulation des chaînes de caractères. Cette fonction permet aux développeurs d'extraire une partie d'une chaîne de caractères en fonction d'une position de caractère spécifiée. Ce guide vise à expliquer en détail la méthode publique Substring et la bibliothèque IronPDF, fournissant des exemples détaillés et des explications pour aider les débutants à comprendre pleinement son utilisation et ses capacités.

Comprendre la Méthode Substring

La méthode Substring en C#, un membre de la classe String, permet la manipulation en commençant par le premier caractère en fonction des paramètres spécifiés. Elle est utilisée pour récupérer une partie de la chaîne de caractères en commençant à un index spécifié et, éventuellement, pour une longueur spécifiée. La syntaxe de cette méthode est simple, ce qui facilite son implémentation dans tout scénario de codage nécessitant une manipulation de chaînes de caractères.

Syntaxe et Paramètres

La méthode Substring a deux formes principales :

public string Substring(int startIndex);
public string Substring(int startIndex, int length);
  1. public string Substring(int startIndex) : Cette méthode récupère une sous-chaîne qui commence à partir de l' index de départ et se poursuit jusqu'à la fin de la chaîne.
  2. public string Substring(int startIndex, int length) : Ceci récupère une sous-chaîne commençant à startIndex et de la longueur spécifiée.

Les paramètres impliqués sont :

  • int startIndex : Il s'agit de l'index à partir de zéro auquel commence la sous-chaîne.
  • int longueur : (facultatif) Il s'agit du deuxième paramètre. C'est le nombre de caractères à inclure dans la sous-chaîne retournée.

Comment Fonctionne la Méthode Substring

Le processus de la méthode Substring est simple. Lorsqu'elle est appelée, elle extrait les caractères de la chaîne originale en commençant à l'index donné (startIndex). Si le paramètre length est fourni, la méthode retourne le nombre de caractères spécifié. Sans le paramètre length, elle continue jusqu'à la fin de la chaîne. L'utilisation de Substring en C# garantit que les deux paramètres (startIndex et length) sont traités comme des entiers, assurant la sécurité du type et évitant les erreurs potentielles à l'exécution.

Exemples Détaillés de la Méthode Substring

Pour mieux comprendre comment la méthode Substring est implémentée, considérons plusieurs exemples qui illustrent ses applications pratiques.

Extraction jusqu'à la Fin de la Chaîne

Supposons que vous ayez une chaîne et que vous deviez extraire une sous-chaîne d'un index particulier jusqu'à la fin de la chaîne. Voici comment vous pourriez le faire :

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

Sortie :

world!
Text

Dans cet exemple, la méthode Substring commence à l'index 7, ce qui correspond au 'w' dans "world!", et récupère chaque caractère jusqu'à la fin de la chaîne. Ceci est particulièrement utile lorsque la longueur de la sous-chaîne est dynamique ou non prédéterminée.

Extraction d'une Sous-chaîne avec Longueur Spécifiée

Voyons maintenant un scénario où à la fois l'index de début et la longueur de la sous-chaîne sont spécifiés :

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

Sortie :

world
Text

Ici, la sous-chaîne commence au septième caractère et s'étend sur cinq caractères. Cette méthode est très utile lorsque vous avez besoin d'un contrôle précis sur les limites de la sous-chaîne.

Récupération de Sous-chaînes à partir d'un Tableau de Chaînes de Caractères

Supposons que vous ayez un tableau de chaînes de caractères et que vous souhaitiez extraire des sous-chaînes de chaque chaîne en fonction d'une position de caractère spécifiée et d'une longueur. Vous pouvez utiliser une boucle foreach pour itérer sur le tableau et appliquer la méthode Substring à chaque chaîne.

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

Ce code affichera :

ppl
ana
ran
Text

Gestion des Cas Limites

Il est important de considérer les cas limites pour éviter les erreurs à l'exécution telles que ArgumentOutOfRangeException. Lors de l'utilisation de la méthode Substring, il est essentiel de s'assurer que la position de caractère spécifiée et la longueur sont dans les limites de la chaîne originale. Sinon, cela peut entraîner une exception d'index hors de portée. Vous pouvez vérifier la longueur de la chaîne originale pour éviter de telles exceptions. Voici quelques points clés :

  • Le startIndex doit être dans les limites de la chaîne.
  • La somme de startIndex et length ne doit pas dépasser la longueur de la chaîne originale.
  • Les valeurs négatives pour startIndex ou length ne sont pas autorisées et provoqueront une erreur.

Vérification de la Validité des Indices

Pour s'assurer que votre extraction de sous-chaîne ne cause pas d'erreur, vous pouvez ajouter des vérifications :

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

Ce bloc de code assure que les paramètres de la sous-chaîne sont valides avant de tenter d'extraire la sous-chaîne, évitant ainsi les erreurs potentielles à l'exécution.

Intégration de IronPDF avec Substring en C# pour la création dynamique de PDF

IronPDF est une bibliothèque PDF puissante qui permet aux développeurs de créer, manipuler et rendre des documents PDF directement dans leurs applications .NET. Elle permet la conversion de HTML en PDF ce qui aide à créer des documents PDF personnalisés et beaux. IronPDF supporte une gamme d'opérations PDF incluant la génération de PDF à partir de HTML, l'exportation de PDF, la modification de PDF existants, et bien plus, fournissant une boîte à outils complète pour le traitement des fichiers PDF dans un environnement .NET.

IronPDF rend la conversion de HTML en PDF facile, tout en gardant les mises en page et les styles intacts. C'est un excellent outil pour créer des PDF à partir de contenu web, tel que des rapports, des factures, et de la documentation. Les fichiers HTML, URL, et chaînes HTML peuvent être convertis en fichiers PDF de manière transparente.

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

Combiner IronPDF avec la méthode C# Substring peut être incroyablement utile pour générer des documents PDF qui nécessitent la manipulation et l'extraction de texte avant la conversion en PDF. Par exemple, si vous avez besoin d'extraire des informations spécifiques d'un long bloc de texte et les présenter dans un format PDF, vous pouvez utiliser la méthode Substring pour isoler le texte désiré et IronPDF pour convertir ce texte en document PDF.

Exemple de Code : Générer un PDF à partir d'une Chaîne Extraite

Considérons un scénario où vous avez un grand texte contenant des informations importantes à des indices spécifiés et que vous devez extraire ces informations et générer un fichier PDF avec. Voici un exemple étape par étape de la façon dont cela peut être réalisé en utilisant à la fois IronPDF et la méthode C# Substring.

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

Sous-chaîne C# (Comment cela fonctionne pour les développeurs) : Figure 1

Ce processus démontre une manière simple d'intégrer la manipulation de texte et la création de PDF, ce qui peut être particulièrement utile pour générer des rapports ou de la documentation nécessitant l'extraction et la présentation d'informations spécifiques à partir de textes plus longs.

Conclusion

Sous-chaîne C# (Comment cela fonctionne pour les développeurs) : Figure 2

La méthode Substring en C# est un outil puissant pour la manipulation de chaîne de caractères, permettant aux développeurs d'extraire facilement des portions de texte basées sur des positions de caractères spécifiées. En comprenant et en utilisant cette méthode, vous pouvez gérer efficacement une large gamme de tâches de traitement de texte. N'oubliez pas de prendre en compte les cas limites et de valider les indices pour maintenir la robustesse de vos applications. IronPDF propose une version d'essai gratuite pour les développeurs afin d'explorer ses fonctionnalités, et la licence pour le produit commence à $999.

Jacob Mellor, Directeur technique @ Team Iron
Directeur technique

Jacob Mellor est directeur de la technologie chez Iron Software et un ingénieur visionnaire pionnier de la technologie C# PDF. En tant que développeur à l'origine de la base de code centrale d'Iron Software, il a façonné l'architecture des produits de l'entreprise depuis sa création, la transformant aux côtés du PDG Cameron Rimington en une entreprise de plus de 50 personnes au service de la NASA, de Tesla et d'agences gouvernementales mondiales.

...
Lire la suite

Articles connexes

Key in blue circle

Obtenez votre clé d'essai de 30 jours instantanément.

Aucune restriction. 100 % débloqué. Pas de carte bancaire.

bullet_checkedAucune carte de crédit ou création de compte requiseAucune restriction. 100 % débloqué. Pas de carte bancaire.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Réservez votre Démonstration en direct gratuite
Booking Badge

De confiance par des millions d'ingénieurs dans le monde entier

Logos des clients d'Iron Software
Obtenez Votre Consultation sans Engagement
Remplissez le formulaire ci-dessous ou envoyez un email à sales@ironsoftware.com
Vos informations seront toujours gardées confidentielles.
De confiance par des millions d'ingénieurs dans le monde entier
Logos des clients d'Iron Software
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise