How to find the Capacity of a StringBuilder in C#

Last Updated : 26 Sep, 2021

StringBuilder.Capacity Property is used to get or set the maximum number of characters that can be contained in the memory allocated by the current instance.

Syntax: public int Capacity { get; set; }
Return Value: This property will return the maximum number of characters that can be contained in the memory allocated by the current instance. Its value can range from Length to MaxCapacity.
Exception: This property will give ArgumentOutOfRangeException if the value specified for a set operation is less than the current length of this instance or the value specified for a set operation is greater than the maximum capacity.

Below programs will illustrate the use of the above-discussed property:
Example 1:

csharp

   // C# program to demonstrate
// the Capacity() Property
using System;
using System.Text;
 
class GFG {
 
    // Main Method
    public static void Main(String[] args)
    {
 
        // create a StringBuilder object,
        // default capacity will be 16
        StringBuilder str = new StringBuilder();
 
        // get default capacity
        int cap = str.Capacity;
 
        Console.WriteLine("Default Capacity of StringBuilder = "
                                                         + cap);
 
        // add the String to StringBuilder Object
        str.Append("Geek");
 
        // get capacity
        cap = str.Capacity;
 
        // print the result
        Console.WriteLine("StringBuilder = " + str);
        Console.WriteLine("Current Capacity of StringBuilder = "
                                                         + cap);
    }
}
 
  

Output:

 Capacity of StringBuilder = 16 StringBuilder = Geek Current Capacity of StringBuilder = 16

Example 2:

csharp

   // C# program to demonstrate
// the Capacity() Property
using System;
using System.Text;
 
class GFG {
    public static void Main(String[] args)
    {
 
        // create a StringBuilder object
        // with a String passed as parameter
        StringBuilder str = 
           new StringBuilder("WelcomeGeeks");
 
        // get capacity
        int capacity = str.Capacity;
 
        // print the result
        Console.WriteLine("StringBuilder = " + str);
        Console.WriteLine("Capacity of StringBuilder = "
                                            + capacity);
    }
}
 
  

Output:

StringBuilder = WelcomeGeeks Capacity of StringBuilder = 16

Reference:

https://docs.microsoft.com/en-us/dotnet/api/system.text.stringbuilder.capacity?view=netframework-4.7.2

StringBuilder.EnsureCapacity() Method in C#

Kirti_Mangal

Improve

Article Tags :

StringBuilder.MaxCapacity Property is used to get the maximum capacity of this instance. Syntax: public int MaxCapacity { get; } Property Value: It returns the maximum number of characters of type System.Int32 this instance can hold. Note: The maximum capacity for this implementation is Int32.MaxVal

1 min read

How to create the StringBuilder in C#

StringBuilder() constructor is used to initialize a new instance of the StringBuilder class which will be empty and will have the default initial capacity. StringBuilder is used to represent a mutable string of characters. Mutable means the string which can be changed. So String objects are immutabl

2 min read

How to find the length of the StringBuilder in C#

StringBuilder.Length Property is used to get or set the length of the current StringBuilder object. Syntax: public int Length { get; set; } It returns the length of the current instance. Exception: This property will give ArgumentOutOfRangeException if the value specified for a set operation is less

2 min read

How to remove all characters from StringBuilder in C#

StringBuilder.Clear Method is used to remove all the characters from the current StringBuilder instance. Syntax: public System.Text.StringBuilder Clear (); It returns an StringBuilder object whose length will be zero. Note: Clear is a convenience method that is equivalent to setting the Length prope

1 min read

StringBuilder.EnsureCapacity() Method in C#

The EnsureCapacity(Int32) method of StringBuilder class helps us to ensures the capacity is at least equal to the specified value that is passed as the parameter to the method. If the current capacity is less than the capacity parameter, memory for this instance is reallocated to hold at least capac

2 min read

C# | Creating StringBuilder having specified capacity

StringBuilder(Int32) constructor is used to initialize a new instance of the StringBuilder class which will be empty and will have the specified initial capacity. StringBuilder is used to represent a mutable string of characters. Mutable means the string which can be changed. So String objects are i

2 min read

How to create a StringCollection in C#

StringCollection() constructor is used to initializing a new instance of the StringCollection class. StringCollection class is a new addition to the .NET Framework class library that represents a collection of strings. StringCollection class is defined in the System.Collections.Specialized namespace

2 min read

StringBuilder.CopyTo Method in C#

This method is used to copy the characters from a specified segment of this instance to a specified segment of a destination Char array. Syntax: public void CopyTo (int sourceIndex, char[] destination, int destinationIndex, int count); Parameters: sourceIndex: It is the starting position in this ins

2 min read

How to find the length of an Array in C#

Array.Length Property is used to get the total number of elements in all the dimensions of the Array. Basically, the length of an array is the total number of the elements which is contained by all the dimensions of that array. Syntax: public int Length { get; } Property Value: This property returns

3 min read

How to create a StringDictionary in C#

StringDictionary() constructor is used to initialize a new instance of the StringDictionary class which will be empty and will have the default initial capacity. StringDictionary is a specialized collection. This class comes under the System.Collections.Specialized namespace. It only allows string k

2 min read

How to find the Capacity of a StringBuilder in C#

csharp

csharp

Similar Reads