Classe EntityCollection<TEntity>

[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]

Raccolta di entità che modellano un costrutto EDM specifico che può essere dato da tutte le entità di un determinato tipo o dalle entità che partecipano a una determinata relazione.

Gerarchia di ereditarietà

System.Object
  System.Data.Entity.Core.Objects.DataClasses.RelatedEnd
    System.Data.Entity.Core.Objects.DataClasses.EntityCollection<TEntity>

Spazio dei nomi:  System.Data.Entity.Core.Objects.DataClasses
Assembly:  EntityFramework (in EntityFramework.dll)

Sintassi

'Dichiarazione
<SerializableAttribute> _
Public Class EntityCollection(Of TEntity As Class) _
    Inherits RelatedEnd _
    Implements ICollection(Of TEntity), IEnumerable(Of TEntity),  _
    IEnumerable, IListSource
'Utilizzo
Dim instance As EntityCollection(Of TEntity)

[SerializableAttribute]
public class EntityCollection<TEntity> : RelatedEnd, 
    ICollection<TEntity>, IEnumerable<TEntity>, IEnumerable, IListSource 
where TEntity : class

[SerializableAttribute]
generic<typename TEntity>
where TEntity : ref class 
public ref class EntityCollection : public RelatedEnd, 
    ICollection<TEntity>, IEnumerable<TEntity>, IEnumerable, IListSource

[<SerializableAttribute>]
type EntityCollection<'TEntity when 'TEntity : not struct> =  
    class 
        inherit RelatedEnd 
        interface ICollection<'TEntity>
        interface IEnumerable<'TEntity>
        interface IEnumerable 
        interface IListSource 
    end

JScript does not support generic types and methods.

Parametri di tipo

• TEntity
  Tipo di entità contenute nella raccolta.

Il tipo EntityCollection<TEntity> espone i seguenti membri.

Costruttori

	rapporti	Descrizione
	EntityCollection<TEntity>	Inizializza una nuova istanza della classe EntityCollection<TEntity>.

In alto

Proprietà

	rapporti	Descrizione
	Count	Ottiene il numero di oggetti contenuti nella raccolta.
	IsLoaded	Ottiene un valore che indica se sono stati caricati tutti gli oggetti correlati. (Ereditato da RelatedEnd)
	IsReadOnly	Ottiene un valore che indica se EntityCollection<TEntity> è di sola lettura.
	RelationshipName	Ottiene il nome della relazione di cui fa parte l'entità finale correlata. (Ereditato da RelatedEnd)
	RelationshipSet	Ottiene un riferimento ai metadati per l'entità finale correlata. (Ereditato da RelatedEnd)
	SourceRoleName	Ottiene il nome del ruolo nell'entità finale di origine della relazione. (Ereditato da RelatedEnd)
	TargetRoleName	Ottiene il nome del ruolo nell'entità finale di destinazione della relazione. (Ereditato da RelatedEnd)

In alto

Metodi

	rapporti	Descrizione
	Add	Aggiunge un oggetto alla raccolta.
	Attach(IEnumerable<TEntity>)	Definisce le relazioni tra un oggetto e una raccolta di oggetti correlati in un contesto dell'oggetto.
	Attach(TEntity)	Definisce una relazione tra due oggetti connessi in un contesto dell'oggetto.
	Clear	Rimuove tutte le entità dalla raccolta.
	Contains	Determina se nella raccolta è presente un oggetto specifico.
	CopyTo	Copia tutto il contenuto della raccolta in una matrice, iniziando dall'indice specificato della matrice di destinazione.
	CreateSourceQuery	Restituisce una query di oggetto che, quando eseguita, restituisce lo stesso set di oggetti presente nella raccolta corrente.
	Equals	(Ereditato da Object)
	Finalize	(Ereditato da Object)
	GetEnumerator	Restituisce un enumeratore utilizzato per scorrere gli oggetti della raccolta.
	GetHashCode	(Ereditato da Object)
	GetType	(Ereditato da Object)
	Load()	Carica l'oggetto o gli oggetti correlati nell'entità finale correlata con l'opzione di unione predefinita. (Ereditato da RelatedEnd)
	Load(MergeOption)	Carica gli oggetti correlati nella raccolta utilizzando l'opzione di unione specificata. (Esegue l'override di RelatedEnd.Load(MergeOption)).
	LoadAsync(CancellationToken)	Carica in modo asincrono l'oggetto o gli oggetti correlati nell'entità finale correlata con l'opzione di unione predefinita. (Ereditato da RelatedEnd)
	LoadAsync(MergeOption, CancellationToken)	Carica in modo asincrono l'entità o le entità correlate nell'entità finale correlata utilizzando l'opzione di merge predefinita. (Esegue l'override di RelatedEnd.LoadAsync(MergeOption, CancellationToken)).
	MemberwiseClone	(Ereditato da Object)
	OnCollectionDeserialized	Utilizzato internamente per deserializzare oggetti entità.
	OnDeserialized	Utilizzato internamente per deserializzare oggetti entità insieme alle istanze di RelationshipManager. (Ereditato da RelatedEnd)
	OnSerializing	Utilizzato internamente per serializzare oggetti entità.
	Remove	Rimuove un oggetto dalla raccolta e contrassegna la relazione per l'eliminazione.
	ToString	(Ereditato da Object)

In alto

Eventi

	rapporti	Descrizione
	AssociationChanged	Si verifica quando viene apportata una modifica a un'entità finale correlata. (Ereditato da RelatedEnd)

In alto

Implementazioni esplicite dell'interfaccia

	rapporti	Descrizione
	IListSource.ContainsListCollection	Implementazione di IListSource.ContainsListCollection.Restituisce sempre false.Ciò significa che l'elemento IList restituito contiene i dati effettivi, non è un elenco di raccolte.
	IEnumerable.GetEnumerator	Restituisce un enumeratore utilizzato per scorrere il set di valori memorizzati nella cache da EntityCollection<TEntity>.
	IListSource.GetList	Restituisce la raccolta come IList utilizzato per l'associazione dati.
	IRelatedEnd.Add(Object)	Aggiunge un'entità all'entità finale correlata.Se il proprietario è collegato a una cache, tutte le entità finali collegate vengono aggiunte alla cache oggetti e le relazioni corrispondenti vengono aggiunte a ObjectStateManager.Anche l'elemento RelatedEnd della relazione viene corretto. (Ereditato da RelatedEnd)
	IRelatedEnd.Add(IEntityWithRelationships)	Aggiunge un'entità all'entità finale correlata.Questo metodo funziona esattamente come Add(object).Viene mantenuto per garantire la compatibilità con le versioni precedenti di IRelatedEnd. (Ereditato da RelatedEnd)
	IRelatedEnd.Attach(Object)	Collega un'entità all'entità finale correlata.Se l'entità finale correlata è già stata riempita totalmente o parzialmente, le entità esistenti vengono unite all'entità specificata.L'entità specificata non viene considerata come il set completo di entità correlate.Il proprietario e tutte le entità passate devono trovarsi nello stato Unchanged o Modified.Gli elementi eliminati sono consentiti solo quando è in corso la registrazione dell'istanza della relazione da parte del gestore degli stati. (Ereditato da RelatedEnd)
	IRelatedEnd.Attach(IEntityWithRelationships)	Collega un'entità all'entità finale correlata.Questo metodo funziona esattamente come Attach(object).Viene mantenuto per garantire la compatibilità con le versioni precedenti di IRelatedEnd. (Ereditato da RelatedEnd)
	IRelatedEnd.CreateSourceQuery	Restituisce un oggetto IEnumerable che rappresenta gli oggetti appartenenti all'entità finale correlata. (Ereditato da RelatedEnd)
	IRelatedEnd.Remove(Object)	Rimuove un'entità dall'entità finale correlata.Se il proprietario è collegato a una cache, contrassegna la relazione per l'eliminazione e se la relazione è di tipo composizione contrassegna per l'eliminazione anche l'entità. (Ereditato da RelatedEnd)
	IRelatedEnd.Remove(IEntityWithRelationships)	Rimuove un'entità dall'entità finale correlata.Questo metodo funziona esattamente come Remove(object).Viene mantenuto per garantire la compatibilità con le versioni precedenti di IRelatedEnd. (Ereditato da RelatedEnd)

In alto

Thread safety

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.Entity.Core.Objects.DataClasses