StringBuilder.Equals Método

Definición

Espacio de nombres:

System.Text

Ensamblados:

netstandard.dll, System.Runtime.dll

Sobrecargas

Equals(ReadOnlySpan<Char>)	Devuelve un valor que indica si los caracteres de esta instancia son iguales a los caracteres de un intervalo de caracteres especificado de solo lectura.
Equals(StringBuilder)	Devuelve un valor que indica si esta instancia equivale a un objeto especificado.

Equals(ReadOnlySpan<Char>)

Source:

StringBuilder.cs

Devuelve un valor que indica si los caracteres de esta instancia son iguales a los caracteres de un intervalo de caracteres especificado de solo lectura.

C#

public bool Equals(ReadOnlySpan<char> span);

Parámetros

span

ReadOnlySpan<Char>

El intervalo de caracteres que se va a comparar con la instancia actual.

Devoluciones

Boolean

true si los caracteres de esta instancia y span son iguales; en caso contrario, false.

Comentarios

El Equals método realiza una comparación ordinal para determinar si los caracteres de la instancia actual y span son iguales.

Equals(StringBuilder)

Source:

StringBuilder.cs

Devuelve un valor que indica si esta instancia equivale a un objeto especificado.

C#

public bool Equals(System.Text.StringBuilder? sb);

Parámetros

sb

StringBuilder

Objeto que se va a comparar con esta instancia o null.

Devoluciones

Boolean

true si esta instancia y sb tienen los mismos valores de cadena, Capacity y MaxCapacity; en caso contrario, false.

Ejemplos

El código siguiente usa el Equals método para comprobar si dos StringBuilder objetos son iguales. Se llama al método repetidamente después de realizar pequeños cambios en cada objeto y los resultados se muestran en la consola.

C#

using System;
using System.Text;

class Sample
{
    public static void Main()
    {
    StringBuilder sb1 = new StringBuilder("abc");
    StringBuilder sb2 = new StringBuilder("abc", 16);

    Console.WriteLine();
    Console.WriteLine("a1) sb1.Length = {0}, sb1.Capacity = {1}", sb1.Length, sb1.Capacity);
    Console.WriteLine("a2) sb2.Length = {0}, sb2.Capacity = {1}", sb2.Length, sb2.Capacity);
    Console.WriteLine("a3) sb1.ToString() = \"{0}\", sb2.ToString() = \"{1}\"",
                           sb1.ToString(),       sb2.ToString());
    Console.WriteLine("a4) sb1 equals sb2: {0}", sb1.Equals(sb2));

    Console.WriteLine();
    Console.WriteLine("Ensure sb1 has a capacity of at least 50 characters.");
    sb1.EnsureCapacity(50);

    Console.WriteLine();
    Console.WriteLine("b1) sb1.Length = {0}, sb1.Capacity = {1}", sb1.Length, sb1.Capacity);
    Console.WriteLine("b2) sb2.Length = {0}, sb2.Capacity = {1}", sb2.Length, sb2.Capacity);
    Console.WriteLine("b3) sb1.ToString() = \"{0}\", sb2.ToString() = \"{1}\"",
                           sb1.ToString(),       sb2.ToString());
    Console.WriteLine("b4) sb1 equals sb2: {0}", sb1.Equals(sb2));

    Console.WriteLine();
    Console.WriteLine("Set the length of sb1 to zero.");
    Console.WriteLine("Set the capacity of sb2 to 51 characters.");
    sb1.Length = 0;
    sb2.Capacity = 51;

    Console.WriteLine();
    Console.WriteLine("c1) sb1.Length = {0}, sb1.Capacity = {1}", sb1.Length, sb1.Capacity);
    Console.WriteLine("c2) sb2.Length = {0}, sb2.Capacity = {1}", sb2.Length, sb2.Capacity);
    Console.WriteLine("c3) sb1.ToString() = \"{0}\", sb2.ToString() = \"{1}\"",
                           sb1.ToString(),       sb2.ToString());
    Console.WriteLine("c4) sb1 equals sb2: {0}", sb1.Equals(sb2));
    }
}
/*
The example displays the following output:

a1) sb1.Length = 3, sb1.Capacity = 16
a2) sb2.Length = 3, sb2.Capacity = 16
a3) sb1.ToString() = "abc", sb2.ToString() = "abc"
a4) sb1 equals sb2: True

Ensure sb1 has a capacity of at least 50 characters.

b1) sb1.Length = 3, sb1.Capacity = 50
b2) sb2.Length = 3, sb2.Capacity = 16
b3) sb1.ToString() = "abc", sb2.ToString() = "abc"
b4) sb1 equals sb2: False

Set the length of sb1 to zero.
Set the capacity of sb2 to 51 characters.

c1) sb1.Length = 0, sb1.Capacity = 50
c2) sb2.Length = 3, sb2.Capacity = 51
c3) sb1.ToString() = "", sb2.ToString() = "abc"
c4) sb1 equals sb2: False
*/

Comentarios

.NET Framework y .NET Core 2.2 y versiones anteriores: La instancia actual y sb son iguales si tienen valores iguales de cadena, Capacityy MaxCapacity . El Equals método usa la comparación ordinal para determinar si las cadenas son iguales.

.NET Core 3.0 y versiones posteriores: La instancia actual y sb son iguales si las cadenas asignadas a ambos StringBuilder objetos son iguales. Para determinar la igualdad, el Equals método usa la comparación ordinal. Los Capacity valores de propiedad y MaxCapacity no se usan en la comparación.