Struct Realm.Dynamic

Uma classe que expõe a API dinâmica para uma Instância de Realm.

Membros herdados

ValueType.ToString()

namespace: Realms

Conjunto: Realm.exe

Sintaxe

[Preserve(AllMembers = true)]
public readonly struct Realm.Dynamic

Métodos

AddEmbeddedObjectToDictionary(objeto, string)

Cria um objeto incorporado e o adiciona ao dicionário especificado. Isso também atribui a propriedade correta do objeto incorporado recém-criado.

Declaração

public IEmbeddedObject AddEmbeddedObjectToDictionary(object dictionary, string key)

Parâmetros

Tipo	Nome	Descrição
objeto	Dicionário	O dicionário ao qual o objeto será adicionado.
string	chave	A chave para a qual o objeto será adicionado.

Devoluções

Tipo	Descrição
IEmbeddedObject	O objeto recém-criado, depois de ter sido adicionado ao dicionário.

Observações

Dicionários contendo objetos incorporados não podem adicionar objetos diretamente, pois isso exigiria a construção de um objeto incorporado sem proprietário, o que não é possível. É por isso que AddEmbeddedObjectToDictionary(objeto, string) e SetEmbeddedObjectInDictionary(objeto, string) devem ser usados em vez de Add(TKey, tvalue) e este[TKey].

Veja também

SetEmbeddedObjectInDictionary(objeto, string)

AddEmbeddedObjectToList(objeto)

Cria um objeto incorporado e o adiciona à lista especificada. Isso também atribui a propriedade correta do objeto incorporado recém-criado.

Declaração

public IEmbeddedObject AddEmbeddedObjectToList(object list)

Parâmetros

Tipo	Nome	Descrição
objeto	Lista	A lista à qual o objeto será adicionado.

Devoluções

Tipo	Descrição
IEmbeddedObject	O objeto recém-criado, depois de ter sido adicionado ao final da lista.

Observações

Listas de objetos incorporados não podem adicionar objetos diretamente, pois isso exigiria a construção de um objeto incorporado sem proprietário, o que não é possível. É por isso que AddEmbeddedObjectToList(objeto), InsertEmbeddedObjectInList(objeto, int) e SetEmbeddedObjectInList(objeto, int) devem ser usados em vez de Add(T), Insert(int, T) e este[int].

Veja também

InsertEmbeddedObjectInList(objeto, int)

SetEmbeddedObjectInList(objeto, int)

All(string)

Obtenha uma visão de todos os objetos de um tipo específico.

Declaração

public IQueryable<IRealmObject> All(string className)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo dos objetos conforme definido no esquema.

Devoluções

Tipo	Descrição
IQueryable<IRealmObject>	Uma collection consultável que, sem filtragem adicional, permite iterar todos os objeto de className, nesse Realm.

Observações

Como o objeto dentro da visualização são acessados dinamicamente, a visualização não pode ser query para usar LINQ ou outros predicados de expression.

CreateEmbeddedObjectForProperty(IRealmObjectBase, string)

Fábrica para um objeto incorporado managed em um Realm. Válido apenas dentro de uma transação de escrita. Objeto incorporado precisam ser de propriedade imediatamente, e é por isso que eles só podem ser criados para uma propriedade específica.

Declaração

public IEmbeddedObject CreateEmbeddedObjectForProperty(IRealmObjectBase parent, string propertyName)

Parâmetros

Tipo	Nome	Descrição
IRealmObjectBase	principal	O IRealmObject ou IEmbeddedObject principal que possuirá o objeto incorporado recém-criado.
string	Nome da propriedade	A propriedade à qual o objeto incorporado recém-criado será atribuído.

Devoluções

Tipo	Descrição
IEmbeddedObject	Um objeto incorporado acessado dinamicamente.

CreateObject(string)

Loja para um managed objeto sem uma chave primária em um Realm. Válido apenas dentro de uma transação de escrita.

Declaração

public IRealmObjectBase CreateObject(string className)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo de objeto a criar, conforme definido no esquema.

Devoluções

Tipo	Descrição
IRealmObjectBase	Um Objeto de Realm acessado dinamicamente.

Observações

Se a Instância de Realm tiver sido criada a partir de um esquema não digitado (como ao migrar de uma versão mais antiga de um Realm), o objeto retornado será totalmente dinâmico. Se o Realm tiver sido criado a partir de um esquema digitado, como é o caso padrão ao chamar GetInstance(RealmConfigurationBase?) , O objeto retornado será uma instância de uma classe definida pelo usuário.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se você usar este método em um objeto que tenha uma chave primária definida.

CreateObject(string, ObjectId?)

Factory para um objeto gerenciado com uma chave primária em um realm. Válido apenas dentro de uma Transação de escrita .

Declaração

public IRealmObjectBase CreateObject(string className, ObjectId? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo de objeto a criar, conforme definido no esquema.
ObjectId?	chave primária	A chave primária do objeto a ser criado.

Devoluções

Tipo	Descrição
IRealmObjectBase	Um Objeto de Realm acessado dinamicamente.

Observações

Se a Instância de Realm tiver sido criada a partir de um esquema não digitado (como ao migrar de uma versão mais antiga de um Realm), o objeto retornado será totalmente dinâmico. Se o Realm tiver sido criado a partir de um esquema digitado, como é o caso padrão ao chamar GetInstance(RealmConfigurationBase?) , O objeto retornado será uma instância de uma classe definida pelo usuário.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se o tipo do primaryKey for diferente do especificado no esquema.

CreateObject(string, Guia?)

Factory para um objeto gerenciado com uma chave primária em um realm. Válido apenas dentro de uma Transação de escrita .

Declaração

public IRealmObjectBase CreateObject(string className, Guid? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo de objeto a criar, conforme definido no esquema.
Guia?	chave primária	A chave primária do objeto a ser criado.

Devoluções

Tipo	Descrição
IRealmObjectBase	Um Objeto de Realm acessado dinamicamente.

Observações

Se a Instância de Realm tiver sido criada a partir de um esquema não digitado (como ao migrar de uma versão mais antiga de um Realm), o objeto retornado será totalmente dinâmico. Se o Realm tiver sido criado a partir de um esquema digitado, como é o caso padrão ao chamar GetInstance(RealmConfigurationBase?) , O objeto retornado será uma instância de uma classe definida pelo usuário.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se o tipo do primaryKey for diferente do especificado no esquema.

CreateObject(string, longa?)

Factory para um objeto gerenciado com uma chave primária em um realm. Válido apenas dentro de uma Transação de escrita .

Declaração

public IRealmObjectBase CreateObject(string className, long? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo de objeto a criar, conforme definido no esquema.
longo?	chave primária	A chave primária do objeto a ser criado.

Devoluções

Tipo	Descrição
IRealmObjectBase	Um Objeto de Realm acessado dinamicamente.

Observações

Se a Instância de Realm tiver sido criada a partir de um esquema não digitado (como ao migrar de uma versão mais antiga de um Realm), o objeto retornado será totalmente dinâmico. Se o Realm tiver sido criado a partir de um esquema digitado, como é o caso padrão ao chamar GetInstance(RealmConfigurationBase?) , O objeto retornado será uma instância de uma classe definida pelo usuário.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se o tipo do primaryKey for diferente do especificado no esquema.

CreateObject(cadeia de caracteres, cadeia de caracteres?)

Factory para um objeto gerenciado com uma chave primária em um realm. Válido apenas dentro de uma Transação de escrita .

Declaração

public IRealmObjectBase CreateObject(string className, string? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	O tipo de objeto a criar, conforme definido no esquema.
string	chave primária	A chave primária do objeto a ser criado.

Devoluções

Tipo	Descrição
IRealmObjectBase	Um Objeto de Realm acessado dinamicamente.

Observações

Se a Instância de Realm tiver sido criada a partir de um esquema não digitado (como ao migrar de uma versão mais antiga de um Realm), o objeto retornado será totalmente dinâmico. Se o Realm tiver sido criado a partir de um esquema digitado, como é o caso padrão ao chamar GetInstance(RealmConfigurationBase?) , O objeto retornado será uma instância de uma classe definida pelo usuário.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se o tipo do primaryKey for diferente do especificado no esquema.

Find(string, ObjectId?)

Pesquisa rápida de um objeto para uso dinâmico, a partir de uma classe que tem uma propriedade PrimaryKey.

Declaração

public IRealmObject? Find(string className, ObjectId? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	Nome da classe em situação dinâmica.
ObjectId?	chave primária	A chave primária deve ser correspondida exatamente, o mesmo que uma pesquisa == .

Devoluções

Tipo	Descrição
IRealmObject	null ou um objeto que corresponde à chave primária.

Exceções

Tipo	Condição
RealmClassLacksPrimaryKeyException	Se a classe IRealmObject T não tiver PrimaryKeyAttribute.

Encontrar(cadeia de caracteres, Guia?)

Pesquisa rápida de um objeto para uso dinâmico, a partir de uma classe que tem uma propriedade PrimaryKey.

Declaração

public IRealmObject? Find(string className, Guid? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	Nome da classe em situação dinâmica.
Guia?	chave primária	A chave primária deve ser correspondida exatamente, o mesmo que uma pesquisa == .

Devoluções

Tipo	Descrição
IRealmObject	null ou um objeto que corresponde à chave primária.

Exceções

Tipo	Condição
RealmClassLacksPrimaryKeyException	Se a classe IRealmObject T não tiver PrimaryKeyAttribute.

Encontrar(cadeia, longa?)

Pesquisa rápida de um objeto para uso dinâmico, a partir de uma classe que tem uma propriedade PrimaryKey.

Declaração

public IRealmObject? Find(string className, long? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	Nome da classe em situação dinâmica.
longo?	chave primária	A chave primária deve ser correspondida exatamente, o mesmo que uma pesquisa == . Um argumento do tipo long? funciona para todas as propriedades inteiras, suportadas como PrimaryKey.

Devoluções

Tipo	Descrição
IRealmObject	null ou um objeto que corresponde à chave primária.

Exceções

Tipo	Condição
RealmClassLacksPrimaryKeyException	Se a classe IRealmObject T não tiver PrimaryKeyAttribute.

Encontrar(cadeia de caracteres, cadeia de caracteres?)

Pesquisa rápida de um objeto para uso dinâmico, a partir de uma classe que tem uma propriedade PrimaryKey.

Declaração

public IRealmObject? Find(string className, string? primaryKey)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	Nome da classe em situação dinâmica.
string	chave primária	A chave primária deve ser correspondida exatamente, o mesmo que uma pesquisa == .

Devoluções

Tipo	Descrição
IRealmObject	null ou um objeto que corresponde à chave primária.

Exceções

Tipo	Condição
RealmClassLacksPrimaryKeyException	Se a classe IRealmObject T não tiver PrimaryKeyAttribute.

InsertEmbeddedObjectInList(objeto, int)

Cria um objeto incorporado e o insere na lista especificada no índice especificado. Isso também atribui a propriedade correta do objeto incorporado recém-criado.

Declaração

public IEmbeddedObject InsertEmbeddedObjectInList(object list, int index)

Parâmetros

Tipo	Nome	Descrição
objeto	Lista	A lista na qual o objeto será inserido.
int	index	O índice no qual o objeto será inserido.

Devoluções

Tipo	Descrição
IEmbeddedObject	O objeto recém-criado, após ter sido inserido na lista.

Observações

Listas de objetos incorporados não podem adicionar objetos diretamente, pois isso exigiria a construção de um objeto incorporado sem proprietário, o que não é possível. É por isso que AddEmbeddedObjectToList(objeto), InsertEmbeddedObjectInList(objeto, int) e SetEmbeddedObjectInList(objeto, int) devem ser usados em vez de Add(T), Insert(int, T) e este[int].

Veja também

InsertEmbeddedObjectInList(objeto, int)

SetEmbeddedObjectInList(objeto, int)

RemoveAll(string)

Remova todos os objetos de um tipo do Realm.

Declaração

public void RemoveAll(string className)

Parâmetros

Tipo	Nome	Descrição
string	Nome da classe	Tipo dos objetos a serem removidos, conforme definido no esquema.

Exceções

Tipo	Condição
RealmInvalidTransactionException	Se você invocar isso quando não houver uma transação de escrita ativa no Realm,
ArgumentException	Se você passar className que não pertence ao esquema deste Realm.

SetEmbeddedObjectInDictionary(objeto, string)

Cria um objeto incorporado e o define no dicionário especificado para a chave especificada. Isso também atribui a propriedade correta do objeto incorporado recém-criado.

Declaração

public IEmbeddedObject SetEmbeddedObjectInDictionary(object dictionary, string key)

Parâmetros

Tipo	Nome	Descrição
objeto	Dicionário	O dicionário no qual o objeto será definido.
string	chave	A chave para a qual o objeto será definido.

Devoluções

Tipo	Descrição
IEmbeddedObject	O objeto recém-criado, depois de ter sido atribuído à chave especificada no dicionário.

Observações

Dicionários contendo objetos incorporados não podem adicionar objetos diretamente, pois isso exigiria a construção de um objeto incorporado sem proprietário, o que não é possível. É por isso que AddEmbeddedObjectToDictionary(objeto, string) e SetEmbeddedObjectInDictionary(objeto, string) devem ser usados em vez de Add(TKey, tvalue) e este[TKey].

Veja também

AddEmbeddedObjectToDictionary(objeto, string)

SetEmbeddedObjectInList(objeto, int)

Cria um objeto incorporado e o define na lista especificada no índice especificado. Isso também atribui a propriedade correta do objeto incorporado recém-criado.

Declaração

public IEmbeddedObject SetEmbeddedObjectInList(object list, int index)

Parâmetros

Tipo	Nome	Descrição
objeto	Lista	A lista na qual o objeto será definido.
int	index	O índice no qual o objeto será definido.

Devoluções

Tipo	Descrição
IEmbeddedObject	O objeto recém-criado, após ter sido definido para o índice especificado na lista.

Observações

Listas de objetos incorporados não podem adicionar objetos diretamente, pois isso exigiria a construção de um objeto incorporado sem proprietário, o que não é possível. É por isso que AddEmbeddedObjectToList(objeto), InsertEmbeddedObjectInList(objeto, int) e SetEmbeddedObjectInList(objeto, int) devem ser usados em vez de Add(T), Insert(int, T) e este[int].

Definir um objeto em um índice removerá o objeto existente da lista e cancelará sua propriedade. Como os objetos incorporados sem propriedade são excluídos automaticamente, o objeto antigo que a lista continha em index será excluído quando a transação for confirmada.

Veja também

InsertEmbeddedObjectInList(objeto, int)

SetEmbeddedObjectInList(objeto, int)