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.