How to: Modificar Conteúdo de seqüência (guia de programação de C#)

Como seqüências de caracteres são imutáveis, não é possível (sem usar código não seguro) para modificar o valor de um objeto string após ele ter sido criado. No entanto, existem muitas maneiras de modificar o valor de uma seqüência e armazenar o resultado em um novo objeto de seqüência de caracteres. O System.String classe fornece métodos que operam em uma seqüência de caracteres de entrada e retornam um novo objeto de seqüência de caracteres. Em muitos casos, você pode atribuir o novo objeto à variável que mantinha uma seqüência de caracteres original. O System.Text.RegularExpressions.Regex classe fornece métodos adicionais que funcionam em uma maneira semelhante. O System.Text.StringBuilder classe fornece um buffer de caractere que você pode modificar "no-local." Você chamar o StringBuilder.ToString método para criar um novo objeto de seqüência de caracteres que contém o conteúdo atual do buffer.

Exemplo

O exemplo a seguir mostra várias formas de substituir ou remover substrings em uma seqüência de caracteres especificada.

class ReplaceSubstrings
{
    string searchFor;
    string replaceWith;

    static void Main(string[] args)
    {

        ReplaceSubstrings app = new ReplaceSubstrings();
        string s = "The mountains are behind the clouds today.";

        // Replace one substring with another with String.Replace.
        // Only exact matches are supported.
        s = s.Replace("mountains", "peaks");
        Console.WriteLine(s);
        // Output: The peaks are behind the clouds today.

        // Use Regex.Replace for more flexibility. 
        // Replace "the" or "The" with "many" or "Many".
        // using System.Text.RegularExpressions
        app.searchFor = "the"; // A very simple regular expression.
        app.replaceWith = "many";
        s = Regex.Replace(s, app.searchFor, app.ReplaceMatchCase, RegexOptions.IgnoreCase);
        Console.WriteLine(s);
        // Output: Many peaks are behind many clouds today.

        // Replace all occurrences of one char with another.
        s = s.Replace(' ', '_');
        Console.WriteLine(s);
        // Output: Many_peaks_are_behind_many_clouds_today.

        // Remove a substring from the middle of the string.
        string temp = "many_";
        int i = s.IndexOf(temp);
        if (i >= 0)
        {
            s = s.Remove(i, temp.Length);
        }
        Console.WriteLine(s);
        // Output: Many_peaks_are_behind_clouds_today.

        // Remove trailing and leading whitespace.
        // See also the TrimStart and TrimEnd methods.
        string s2 = "    I'm wider than I need to be.      ";
        // Store the results in a new string variable.
        temp = s2.Trim();
        Console.WriteLine(temp);
        // Output: I'm wider than I need to be.

        // Keep the console window open in debug mode.
        Console.WriteLine("Press any key to exit");
        Console.ReadKey();
    }

    // Custom match method called by Regex.Replace
    // using System.Text.RegularExpressions
    string ReplaceMatchCase(Match m)
    {
        // Test whether the match is capitalized
        if (Char.IsUpper(m.Value[0]) == true)
        {
            // Capitalize the replacement string
            // using System.Text;
            StringBuilder sb = new StringBuilder(replaceWith);
            sb[0] = (Char.ToUpper(sb[0]));
            return sb.ToString();
        }
        else
        {
            return replaceWith;
        }
    }
}

Para acessar os caracteres individuais em uma seqüência de caracteres usando a notação de matriz, você pode usar o StringBuilder objeto, o que sobrecarrega o [] o operador para fornecer acesso a seu buffer de caractere interno. Você também pode converter a seqüência de caracteres para uma matriz de caracteres usando o ToCharArray método. O exemplo a seguir usa ToCharArray para criar a matriz. Alguns elementos dessa matriz, em seguida, são modificados. Um construtor de seqüência de caracteres que leva uma matriz de char como um parâmetro de entrada, em seguida, é chamada para criar uma nova seqüência.

class ModifyStrings
{
    static void Main()
    {
        string str = "The quick brown fox jumped over the fence";
        System.Console.WriteLine(str);

        char[] chars = str.ToCharArray();
        int animalIndex = str.IndexOf("fox");
        if (animalIndex != -1)
        {
            chars[animalIndex++] = 'c';
            chars[animalIndex++] = 'a';
            chars[animalIndex] = 't';
        }

        string str2 = new string(chars);
        System.Console.WriteLine(str2);

        // Keep the console window open in debug mode
        System.Console.WriteLine("Press any key to exit.");
        System.Console.ReadKey();
    }
}
/* Output:
  The quick brown fox jumped over the fence
  The quick brown cat jumped over the fence 
*/

O exemplo a seguir é fornecido para essas situações raras em que você deseja modificar um string in loco usando código não seguro, de maneira semelhante para matrizes de caracteres de estilo C. O exemplo mostra como acessar os caracteres individuais "in-loco" usando a palavra-chave fixed. Ele também demonstra um possível efeito colateral operações não seguras em seqüências de caracteres que resulta da maneira como o compilador C# armazena cadeias de caracteres (estagiários) internamente. Em geral, você não deve usar essa técnica, a menos que seja absolutamente necessário.

class UnsafeString
{
    unsafe static void Main(string[] args)
    {
        // Compiler will store (intern) 
        // these strings in same location.
        string s1 = "Hello";
        string s2 = "Hello";

        // Change one string using unsafe code.
        fixed (char* p = s1)
        {
            p[0] = 'C';
        }

        //  Both strings have changed.
        Console.WriteLine(s1);
        Console.WriteLine(s2);

        // Keep console window open in debug mode.
        Console.WriteLine("Press any key to exit.");
        Console.ReadKey();
    }

}

Consulte também

Conceitos

C# Programming Guide

Strings (C# Programming Guide)