IRelatedEnd Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define o fim de uma relação.
public interface class IRelatedEnd
public interface IRelatedEnd
type IRelatedEnd = interface
Public Interface IRelatedEnd
- Derivado
Exemplos
O exemplo seguinte adiciona novas SalesOrderHeader entidades à Contact entidade. Depois, recebe todas as extremidades relacionadas da Contact entidade e mostra o nome da relação, o nome do papel de origem e o nome do papel de destino para cada extremidade relacionada.
using (AdventureWorksEntities context =
new AdventureWorksEntities())
{
Contact contact = new Contact();
// Create a new SalesOrderHeader.
SalesOrderHeader newSalesOrder1 = new SalesOrderHeader();
// Add SalesOrderHeader to the Contact.
contact.SalesOrderHeaders.Add(newSalesOrder1);
// Create another SalesOrderHeader.
SalesOrderHeader newSalesOrder2 = new SalesOrderHeader();
// Add SalesOrderHeader to the Contact.
contact.SalesOrderHeaders.Add(newSalesOrder2);
// Get all related ends
IEnumerable<IRelatedEnd> relEnds =
((IEntityWithRelationships)contact).RelationshipManager
.GetAllRelatedEnds();
foreach (IRelatedEnd relEnd in relEnds)
{
Console.WriteLine("Relationship Name: {0}", relEnd.RelationshipName);
Console.WriteLine("Source Role Name: {0}", relEnd.SourceRoleName);
Console.WriteLine("Target Role Name: {0}", relEnd.TargetRoleName);
}
}
Observações
IRelatedEnd define os requisitos para um objeto que representa um fim numa associação. Esta interface é implementada pela RelatedEnd classe. RelatedEnd é a classe base para as EntityCollection<TEntity> classes e EntityReference<TEntity> .
Propriedades
| Name | Description |
|---|---|
| IsLoaded |
Obtém um valor que indica se todos os objetos relacionados foram carregados. |
| RelationshipName |
Obtém o nome da relação em que este fim relacionado participa. |
| RelationshipSet |
Devolve uma referência aos metadados para a extremidade relacionada. |
| SourceRoleName |
Recebe o nome do papel no final da relação. |
| TargetRoleName |
Recebe o nome do papel no final da relação. |
Métodos
| Name | Description |
|---|---|
| Add(IEntityWithRelationships) |
Adiciona um objeto à extremidade relacionada. |
| Add(Object) |
Adiciona um objeto à extremidade relacionada. |
| Attach(IEntityWithRelationships) |
Define uma relação entre dois objetos ligados. |
| Attach(Object) |
Define uma relação entre dois objetos ligados. |
| CreateSourceQuery() |
Devolve um IEnumerable que representa os objetos que pertencem ao extremo relacionado. |
| GetEnumerator() |
Retorna um IEnumerator que itera através da coleção de objetos relacionados. |
| Load() |
Carrega o objeto ou objetos relacionados nesta extremidade relacionada com a opção de fusão por defeito. |
| Load(MergeOption) |
Carrega o objeto ou objetos relacionados na extremidade relacionada com a opção de fusão especificada. |
| Remove(IEntityWithRelationships) |
Remove um objeto da coleção de objetos na extremidade correspondente. |
| Remove(Object) |
Remove um objeto da coleção de objetos na extremidade correspondente. |