Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

ExpandoObject — um objeto com um conjunto de membros variável

ExpandoObject, de System.Dynamic, permite adicionar e remover membros durante a execução. Suporta acesso através de dynamic e da interface de dicionário IDictionary<string, object?>.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

dynamic item = new ExpandoObject();
item.Name = "Ada";
var members = (IDictionary<string, object?>)item;
members.Remove("Name");

ExpandoObject, de System.Dynamic, armazena membros adicionados durante a execução. A atribuição item.Name = "Ada" através de dynamic adiciona uma entrada com nome; uma atribuição posterior atualiza o respetivo valor.

dynamic adia a verificação das operações até à execução. Em contrapartida, var item = new ExpandoObject() dá à variável o tipo estático ExpandoObject, pelo que não permite usar diretamente item.Name. Um erro de escrita numa leitura dinâmica, ou a leitura de um membro removido, causa um erro durante a execução e não um erro de compilação.

A conversão para IDictionary<string, object?> expõe os mesmos dados através de chaves de texto. ContainsKey e TryGetValue permitem verificar se uma entrada existe; Remove elimina-a. Atribuir null não remove a chave.

O exemplo atualiza Score através do dicionário, lê o resultado através de dynamic e, em seguida, remove Name. Para um esquema fixo, prefira uma classe ou um record: assim, o compilador pode verificar os nomes e os tipos dos membros.

Exemplos

using System;
using System.Collections.Generic;
using System.Dynamic;

dynamic item = new ExpandoObject();
item.Name = "Ada";
item.Score = 7;

var members = (IDictionary<string, object?>)item;
members["Score"] = 8;
Console.WriteLine($"{item.Name}: {item.Score}");

members.Remove("Name");
Console.WriteLine(members.ContainsKey("Name") ? "present" : "missing");

Resultado

Ada: 8
missing

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