Каждый экземпляр строки класса StringBuilder имеет буфер, в котором хранится строка. Объем буфера - его емкость - может меняться в процессе работы со строкой. Объекты класса имеют две характеристики емкости - текущую и максимальную. В процессе работы текущая емкость изменяется, естественно, в пределах максимальной емкости, которая реально достаточно высока. Если размер строки увеличивается, то соответственно автоматически растет и текущая емкость. Если же размер строки уменьшается, то емкость буфера остается на том же уровне. По этой причине иногда разумно уменьшать емкость. Следует помнить, что попытка уменьшить емкость до величины, меньшей длины строки, приведет к ошибке.
У класса StringBuilder имеется 2 свойства и один метод, позволяющие анализировать и управлять емкостными свойствами буфера. Напомню, что этими характеристиками можно управлять также еще на этапе создания объекта, - для этого имеется соответствующий конструктор. Рассмотрим свойства и метод класса, связанные с емкостью буфера:
свойство Capacity - возвращает или устанавливает текущую емкость буфера;
свойство MaxCapacity - возвращает максимальную емкость буфера. Результат один и тот же для всех экземпляров класса;
метод int EnsureCapacity(int capacity) - позволяет убедиться, что емкость буфера не меньше емкости, заданной параметром capacity; если текущая емкость меньше, то она увеличивается до значения capacity, иначе не изменяется. Максимум текущей емкости и capacity возвращается в качестве результата работы метода.
Приведу код, в котором проводятся различные эксперименты с емкостью буфера:
/// <summary> /// Анализ емкости буфера /// </summary> public void TestCapacity() { string txt = "А это пшеница, которая в темном чулане хранится," + " в доме, который построил Джек!"; string str = "А роза упала на лапу Азора"; StringBuilder strbuild = new StringBuilder(100, 1000); StringBuilder txtbuild = new StringBuilder(txt); strbuild.Append(str); //Емкость буфера Console.WriteLine("strbuild: емкость буфера = {0}, " + "максимальная емкость = {1}", strbuild.Capacity, strbuild.MaxCapacity); Console.WriteLine("txtbuild: емкость буфера = {0}, " + "максимальная емкость = {1}", txtbuild.Capacity, txtbuild.MaxCapacity); //Изменение емкости //Ошибка периода выполнения! //попытка установить емкость меньше длины строки //txtbuild.Capacity = 75; int sure = txtbuild.EnsureCapacity(75); Console.WriteLine("sure= {0}", sure); // увеличим строку за пределы буфера // емкость автоматически увеличится! txtbuild.Append(txtbuild.ToString()); Console.WriteLine("txtbuild: емкость буфера = {0}", txtbuild.Capacity); }
В этом фрагменте кода анализируются и изменяются емкостные свойства буфера двух объектов. Демонстрируется, как меняется емкость при работе с объектами. Результаты работы этого фрагмента кода показаны на рис. 7.7.
