CKTIS / C#
object — o tipo base comum
A palavra-chave object é um alias de System.Object. Pode conter referências a objetos de tipos diferentes e valores boxed. Saiba em que diferem a igualdade, a identidade das referências e os códigos hash, e como recuperar em segurança um tipo mais específico.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
object value = 42;
object instance = new object();
object? optional = null;object é um alias de System.Object, o tipo base raiz do sistema de tipos C#. É, por si só, um tipo de referência. Uma variável object pode referenciar objetos de tipos diferentes, mas não pode aceitar valores ref struct nem ponteiros. Com as anotações nullable ativadas, object? indica que null é permitido; não cria um tipo de execução diferente.
Converter um valor como int em object provoca boxing: é criado um objeto que contém uma cópia do valor. Copiar uma referência object existente não cria outra caixa. O unboxing exige um tipo de valor compatível: para um int boxed, a conversão (int)value funciona, mas (long)value gera uma InvalidCastException. O padrão value is int number verifica o tipo em segurança e disponibiliza o valor. Ao contrário de dynamic, object mantém a verificação em tempo de compilação da disponibilidade dos membros.
Object.Equals(a, b) trata null e compara objetos utilizando o método virtual Equals do tipo. A implementação de instância predefinida de Object.Equals verifica a identidade das referências, mas os tipos podem substituí-la para comparar valores. Object.ReferenceEquals(a, b) verifica apenas se as referências apontam para a mesma instância; devolve true para duas referências null. O operador ==, para operandos cujo tipo estático é object, compara referências, não o conteúdo dos valores boxed.
Object.GetHashCode devolve um código hash utilizado por coleções baseadas em hash. Os objetos iguais segundo Equals têm de ter o mesmo código; códigos iguais não provam igualdade. Ao substituir Equals, substitua também GetHashCode de acordo com esta regra. Um código hash não é um identificador persistente e não deve ser guardado para comparações posteriores entre execuções. Estes mecanismos não requerem funcionalidades preview num projeto .NET 10.
Exemplos
using System;
object first = 42;
object second = 42;
object alias = first;
Console.WriteLine(Object.Equals(first, second));
Console.WriteLine(Object.ReferenceEquals(first, second));
Console.WriteLine(Object.ReferenceEquals(first, alias));
Console.WriteLine(first.GetHashCode() == second.GetHashCode());
if (first is int number)
{
Console.WriteLine(number + 1);
}Resultado
True False True True 43
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- C# language reference
- C# Keywords and contextual keywords - C# reference
- Built-in reference types (C# reference)
- Object.Equals Method
- Object.GetHashCode Method
- Object.ReferenceEquals(Object, Object) Method
- Boxing and Unboxing (C# Programming Guide)
- Official reference — learn.microsoft.com: api / system.object