Encoding.Equals(Object) Método

  • Referência

Definição

Namespace:
System.Text
Assembly:
System.Text.Encoding.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Determina se o Object especificado é igual à instância atual.

public:
 override bool Equals(System::Object ^ value);
public override bool Equals (object value);
public override bool Equals (object? value);
override this.Equals : obj -> bool
Public Overrides Function Equals (value As Object) As Boolean

Parâmetros

value
Object

O Object de comparação com a instância atual.

Retornos

Boolean

true se value for uma instância de Encoding e for igual à instância atual; caso contrário, false.

Exemplos

O exemplo a seguir obtém duas instâncias da mesma codificação (uma por página de código e outra por nome) e verifica sua igualdade.

using namespace System;
using namespace System::Text;
int main()
{
   
   // Get a UTF-32 encoding by codepage.
   Encoding^ e1 = Encoding::GetEncoding( 12000 );
   
   // Get a UTF-32 encoding by name.
   Encoding^ e2 = Encoding::GetEncoding( "utf-32" );
   
   // Check their equality.
   Console::WriteLine( "e1 equals e2? {0}", e1->Equals( e2 ) );
}

/* 
This code produces the following output.

e1 equals e2? True

*/

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // Get a UTF-32 encoding by codepage.
      Encoding e1 = Encoding.GetEncoding( 12000 );

      // Get a UTF-32 encoding by name.
      Encoding e2 = Encoding.GetEncoding( "utf-32" );

      // Check their equality.
      Console.WriteLine( "e1 equals e2? {0}", e1.Equals( e2 ) );
   }
}


/* 
This code produces the following output.

e1 equals e2? True

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' Get a UTF-32 encoding by codepage.
      Dim e1 As Encoding = Encoding.GetEncoding(12000)

      ' Get a UTF-32 encoding by name.
      Dim e2 As Encoding = Encoding.GetEncoding("utf-32")

      ' Check their equality.
      Console.WriteLine("e1 equals e2? {0}", e1.Equals(e2))

   End Sub

End Class


'This code produces the following output.
'
'e1 equals e2? True

Comentários

Duas instâncias do Encoding são consideradas iguais se corresponderem à mesma página de código e EncoderFallback seus DecoderFallback objetos e forem iguais. Em particular, todas as páginas de código derivadas têm uma página de código 0 e seus fallbacks normalmente null ( Nothing em Visual Basic .net). Portanto, eles são todos considerados iguais. Uma consequência é que, quando Equals é usado para popular uma tabela de hash, todas as codificações derivadas comparam igual e se encaixam no mesmo slot de tabela de hash.

Aplica-se a

Confira também