CollectionBase Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit la classe de base abstract pour une collection fortement typée.
public ref class CollectionBase abstract : System::Collections::IListpublic abstract class CollectionBase : System.Collections.IList[System.Serializable]
public abstract class CollectionBase : System.Collections.IList[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class CollectionBase : System.Collections.IListtype CollectionBase = class
interface ICollection
interface IEnumerable
interface IList[<System.Serializable>]
type CollectionBase = class
interface IList
interface ICollection
interface IEnumerable[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CollectionBase = class
interface IList
interface ICollection
interface IEnumerablePublic MustInherit Class CollectionBase
Implements IList- Héritage
-
CollectionBase
- Dérivé
- Attributs
- Implémente
L’exemple de code suivant implémente la CollectionBase classe et utilise cette implémentation pour créer une collection d’objets Int16 .
#using <System.dll>
using namespace System;
using namespace System::Collections;
public ref class Int16Collection: public CollectionBase
{
public:
property Int16 Item [int]
{
Int16 get( int index )
{
return ( (Int16)(List[ index ]));
}
void set( int index, Int16 value )
{
List[ index ] = value;
}
}
int Add( Int16 value )
{
return (List->Add( value ));
}
int IndexOf( Int16 value )
{
return (List->IndexOf( value ));
}
void Insert( int index, Int16 value )
{
List->Insert( index, value );
}
void Remove( Int16 value )
{
List->Remove( value );
}
bool Contains( Int16 value )
{
// If value is not of type Int16, this will return false.
return (List->Contains( value ));
}
protected:
virtual void OnInsert( int /*index*/, Object^ /*value*/ ) override
{
// Insert additional code to be run only when inserting values.
}
virtual void OnRemove( int /*index*/, Object^ /*value*/ ) override
{
// Insert additional code to be run only when removing values.
}
virtual void OnSet( int /*index*/, Object^ /*oldValue*/, Object^ /*newValue*/ ) override
{
// Insert additional code to be run only when setting values.
}
virtual void OnValidate( Object^ value ) override
{
if ( value->GetType() != Type::GetType( "System.Int16" ) )
throw gcnew ArgumentException( "value must be of type Int16.","value" );
}
};
void PrintIndexAndValues( Int16Collection^ myCol );
void PrintValues2( Int16Collection^ myCol );
int main()
{
// Create and initialize a new CollectionBase.
Int16Collection^ myI16 = gcnew Int16Collection;
// Add elements to the collection.
myI16->Add( (Int16)1 );
myI16->Add( (Int16)2 );
myI16->Add( (Int16)3 );
myI16->Add( (Int16)5 );
myI16->Add( (Int16)7 );
// Display the contents of the collection using the enumerator.
Console::WriteLine( "Contents of the collection (using enumerator):" );
PrintValues2( myI16 );
// Display the contents of the collection using the Count property and the Item property.
Console::WriteLine( "Initial contents of the collection (using Count and Item):" );
PrintIndexAndValues( myI16 );
// Search the collection with Contains and IndexOf.
Console::WriteLine( "Contains 3: {0}", myI16->Contains( 3 ) );
Console::WriteLine( "2 is at index {0}.", myI16->IndexOf( 2 ) );
Console::WriteLine();
// Insert an element into the collection at index 3.
myI16->Insert( 3, (Int16)13 );
Console::WriteLine( "Contents of the collection after inserting at index 3:" );
PrintIndexAndValues( myI16 );
// Get and set an element using the index.
myI16->Item[ 4 ] = 123;
Console::WriteLine( "Contents of the collection after setting the element at index 4 to 123:" );
PrintIndexAndValues( myI16 );
// Remove an element from the collection.
myI16->Remove( (Int16)2 );
// Display the contents of the collection using the Count property and the Item property.
Console::WriteLine( "Contents of the collection after removing the element 2:" );
PrintIndexAndValues( myI16 );
}
// Uses the Count property and the Item property.
void PrintIndexAndValues( Int16Collection^ myCol )
{
for ( int i = 0; i < myCol->Count; i++ )
Console::WriteLine( " [{0}]: {1}", i, myCol->Item[ i ] );
Console::WriteLine();
}
// Uses the enumerator.
void PrintValues2( Int16Collection^ myCol )
{
System::Collections::IEnumerator^ myEnumerator = myCol->GetEnumerator();
while ( myEnumerator->MoveNext() )
Console::WriteLine( " {0}", myEnumerator->Current );
Console::WriteLine();
}
/*
This code produces the following output.
Contents of the collection (using enumerator):
1
2
3
5
7
Initial contents of the collection (using Count and Item):
[0]: 1
[1]: 2
[2]: 3
[3]: 5
[4]: 7
Contains 3: True
2 is at index 1.
Contents of the collection after inserting at index 3:
[0]: 1
[1]: 2
[2]: 3
[3]: 13
[4]: 5
[5]: 7
Contents of the collection after setting the element at index 4 to 123:
[0]: 1
[1]: 2
[2]: 3
[3]: 13
[4]: 123
[5]: 7
Contents of the collection after removing the element 2:
[0]: 1
[1]: 3
[2]: 13
[3]: 123
[4]: 7
*/
using System;
using System.Collections;
public class Int16Collection : CollectionBase {
public Int16 this[ int index ] {
get {
return( (Int16) List[index] );
}
set {
List[index] = value;
}
}
public int Add( Int16 value ) {
return( List.Add( value ) );
}
public int IndexOf( Int16 value ) {
return( List.IndexOf( value ) );
}
public void Insert( int index, Int16 value ) {
List.Insert( index, value );
}
public void Remove( Int16 value ) {
List.Remove( value );
}
public bool Contains( Int16 value ) {
// If value is not of type Int16, this will return false.
return( List.Contains( value ) );
}
protected override void OnInsert( int index, Object value ) {
// Insert additional code to be run only when inserting values.
}
protected override void OnRemove( int index, Object value ) {
// Insert additional code to be run only when removing values.
}
protected override void OnSet( int index, Object oldValue, Object newValue ) {
// Insert additional code to be run only when setting values.
}
protected override void OnValidate( Object value ) {
if ( value.GetType() != typeof(System.Int16) )
throw new ArgumentException( "value must be of type Int16.", "value" );
}
}
public class SamplesCollectionBase {
public static void Main() {
// Create and initialize a new CollectionBase.
Int16Collection myI16 = new Int16Collection();
// Add elements to the collection.
myI16.Add( (Int16) 1 );
myI16.Add( (Int16) 2 );
myI16.Add( (Int16) 3 );
myI16.Add( (Int16) 5 );
myI16.Add( (Int16) 7 );
// Display the contents of the collection using foreach. This is the preferred method.
Console.WriteLine( "Contents of the collection (using foreach):" );
PrintValues1( myI16 );
// Display the contents of the collection using the enumerator.
Console.WriteLine( "Contents of the collection (using enumerator):" );
PrintValues2( myI16 );
// Display the contents of the collection using the Count property and the Item property.
Console.WriteLine( "Initial contents of the collection (using Count and Item):" );
PrintIndexAndValues( myI16 );
// Search the collection with Contains and IndexOf.
Console.WriteLine( "Contains 3: {0}", myI16.Contains( 3 ) );
Console.WriteLine( "2 is at index {0}.", myI16.IndexOf( 2 ) );
Console.WriteLine();
// Insert an element into the collection at index 3.
myI16.Insert( 3, (Int16) 13 );
Console.WriteLine( "Contents of the collection after inserting at index 3:" );
PrintIndexAndValues( myI16 );
// Get and set an element using the index.
myI16[4] = 123;
Console.WriteLine( "Contents of the collection after setting the element at index 4 to 123:" );
PrintIndexAndValues( myI16 );
// Remove an element from the collection.
myI16.Remove( (Int16) 2 );
// Display the contents of the collection using the Count property and the Item property.
Console.WriteLine( "Contents of the collection after removing the element 2:" );
PrintIndexAndValues( myI16 );
}
// Uses the Count property and the Item property.
public static void PrintIndexAndValues( Int16Collection myCol ) {
for ( int i = 0; i < myCol.Count; i++ )
Console.WriteLine( " [{0}]: {1}", i, myCol[i] );
Console.WriteLine();
}
// Uses the foreach statement which hides the complexity of the enumerator.
// NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
public static void PrintValues1( Int16Collection myCol ) {
foreach ( Int16 i16 in myCol )
Console.WriteLine( " {0}", i16 );
Console.WriteLine();
}
// Uses the enumerator.
// NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
public static void PrintValues2( Int16Collection myCol ) {
System.Collections.IEnumerator myEnumerator = myCol.GetEnumerator();
while ( myEnumerator.MoveNext() )
Console.WriteLine( " {0}", myEnumerator.Current );
Console.WriteLine();
}
}
/*
This code produces the following output.
Contents of the collection (using foreach):
1
2
3
5
7
Contents of the collection (using enumerator):
1
2
3
5
7
Initial contents of the collection (using Count and Item):
[0]: 1
[1]: 2
[2]: 3
[3]: 5
[4]: 7
Contains 3: True
2 is at index 1.
Contents of the collection after inserting at index 3:
[0]: 1
[1]: 2
[2]: 3
[3]: 13
[4]: 5
[5]: 7
Contents of the collection after setting the element at index 4 to 123:
[0]: 1
[1]: 2
[2]: 3
[3]: 13
[4]: 123
[5]: 7
Contents of the collection after removing the element 2:
[0]: 1
[1]: 3
[2]: 13
[3]: 123
[4]: 7
*/
Imports System.Collections
Public Class Int16Collection
Inherits CollectionBase
Default Public Property Item(index As Integer) As Int16
Get
Return CType(List(index), Int16)
End Get
Set
List(index) = value
End Set
End Property
Public Function Add(value As Int16) As Integer
Return List.Add(value)
End Function 'Add
Public Function IndexOf(value As Int16) As Integer
Return List.IndexOf(value)
End Function 'IndexOf
Public Sub Insert(index As Integer, value As Int16)
List.Insert(index, value)
End Sub
Public Sub Remove(value As Int16)
List.Remove(value)
End Sub
Public Function Contains(value As Int16) As Boolean
' If value is not of type Int16, this will return false.
Return List.Contains(value)
End Function 'Contains
Protected Overrides Sub OnInsert(index As Integer, value As Object)
' Insert additional code to be run only when inserting values.
End Sub
Protected Overrides Sub OnRemove(index As Integer, value As Object)
' Insert additional code to be run only when removing values.
End Sub
Protected Overrides Sub OnSet(index As Integer, oldValue As Object, newValue As Object)
' Insert additional code to be run only when setting values.
End Sub
Protected Overrides Sub OnValidate(value As Object)
If Not GetType(System.Int16).IsAssignableFrom(value.GetType()) Then
Throw New ArgumentException("value must be of type Int16.", "value")
End If
End Sub
End Class
Public Class SamplesCollectionBase
Public Shared Sub Main()
' Creates and initializes a new CollectionBase.
Dim myI16 As New Int16Collection()
' Adds elements to the collection.
myI16.Add( 1 )
myI16.Add( 2 )
myI16.Add( 3 )
myI16.Add( 5 )
myI16.Add( 7 )
' Display the contents of the collection using For Each. This is the preferred method.
Console.WriteLine("Contents of the collection (using For Each):")
PrintValues1(myI16)
' Display the contents of the collection using the enumerator.
Console.WriteLine("Contents of the collection (using enumerator):")
PrintValues2(myI16)
' Display the contents of the collection using the Count property and the Item property.
Console.WriteLine("Initial contents of the collection (using Count and Item):")
PrintIndexAndValues(myI16)
' Searches the collection with Contains and IndexOf.
Console.WriteLine("Contains 3: {0}", myI16.Contains(3))
Console.WriteLine("2 is at index {0}.", myI16.IndexOf(2))
Console.WriteLine()
' Inserts an element into the collection at index 3.
myI16.Insert(3, 13)
Console.WriteLine("Contents of the collection after inserting at index 3:")
PrintIndexAndValues(myI16)
' Gets and sets an element using the index.
myI16(4) = 123
Console.WriteLine("Contents of the collection after setting the element at index 4 to 123:")
PrintIndexAndValues(myI16)
' Removes an element from the collection.
myI16.Remove(2)
' Display the contents of the collection using the Count property and the Item property.
Console.WriteLine("Contents of the collection after removing the element 2:")
PrintIndexAndValues(myI16)
End Sub
' Uses the Count property and the Item property.
Public Shared Sub PrintIndexAndValues(myCol As Int16Collection)
Dim i As Integer
For i = 0 To myCol.Count - 1
Console.WriteLine(" [{0}]: {1}", i, myCol(i))
Next i
Console.WriteLine()
End Sub
' Uses the For Each statement which hides the complexity of the enumerator.
' NOTE: The For Each statement is the preferred way of enumerating the contents of a collection.
Public Shared Sub PrintValues1(myCol As Int16Collection)
Dim i16 As Int16
For Each i16 In myCol
Console.WriteLine(" {0}", i16)
Next i16
Console.WriteLine()
End Sub
' Uses the enumerator.
' NOTE: The For Each statement is the preferred way of enumerating the contents of a collection.
Public Shared Sub PrintValues2(myCol As Int16Collection)
Dim myEnumerator As System.Collections.IEnumerator = myCol.GetEnumerator()
While myEnumerator.MoveNext()
Console.WriteLine(" {0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
'This code produces the following output.
'
'Contents of the collection (using For Each):
' 1
' 2
' 3
' 5
' 7
'
'Contents of the collection (using enumerator):
' 1
' 2
' 3
' 5
' 7
'
'Initial contents of the collection (using Count and Item):
' [0]: 1
' [1]: 2
' [2]: 3
' [3]: 5
' [4]: 7
'
'Contains 3: True
'2 is at index 1.
'
'Contents of the collection after inserting at index 3:
' [0]: 1
' [1]: 2
' [2]: 3
' [3]: 13
' [4]: 5
' [5]: 7
'
'Contents of the collection after setting the element at index 4 to 123:
' [0]: 1
' [1]: 2
' [2]: 3
' [3]: 13
' [4]: 123
' [5]: 7
'
'Contents of the collection after removing the element 2:
' [0]: 1
' [1]: 3
' [2]: 13
' [3]: 123
' [4]: 7
Important
Nous vous déconseillons d’utiliser la classe pour le CollectionBase nouveau développement. Au lieu de cela, nous vous recommandons d’utiliser la classe générique Collection<T> . Pour plus d’informations, consultez Collections non génériques ne doivent pas être utilisées sur GitHub.
Une CollectionBase instance est toujours modifiable. Consultez ReadOnlyCollectionBase pour obtenir une version en lecture seule de cette classe.
La capacité d’un CollectionBase est le nombre d’éléments que peut CollectionBase contenir. À mesure que des éléments sont ajoutés à un CollectionBase, la capacité est automatiquement augmentée en fonction des besoins par le biais de la réaffectation. La capacité peut être réduite en définissant la Capacity propriété explicitement.
Cette classe de base est fournie pour faciliter la création d’une collection personnalisée fortement typée pour les implémenteurs. Les implémenteurs sont encouragés à étendre cette classe de base au lieu de créer leur propre classe.
|
Collection |
Initialise une nouvelle instance de la classe CollectionBase avec la capacité initiale par défaut. |
|
Collection |
Initialise une nouvelle instance de la classe CollectionBase avec la capacité spécifiée. |
| Capacity |
Obtient ou définit le nombre d'éléments que CollectionBase peut contenir. |
| Count |
Obtient le nombre d'éléments contenus dans l'instance CollectionBase. Cette propriété ne peut pas être remplacée. |
|
Inner |
Obtient ArrayList contenant la liste des éléments dans l'instance de CollectionBase. |
| List |
Obtient IList contenant la liste des éléments dans l'instance de CollectionBase. |
| Clear() |
Supprime tous les objets de l'instance de CollectionBase. Cette méthode ne peut pas être substituée. |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
|
Get |
Retourne un énumérateur qui itère au sein de l'instance CollectionBase. |
|
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
|
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
|
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
|
On |
Effectue des traitements personnalisés supplémentaires pendant l’effacement du contenu de l’instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires après l'effacement du contenu de l'instance de CollectionBase. |
|
On |
Exécute les processus personnalisés supplémentaires avant l'insertion d'un nouvel élément dans l'instance de CollectionBase. |
|
On |
Exécute les processus personnalisés supplémentaires après l'insertion d'un nouvel élément dans l'instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires lors de la suppression d'un élément de l'instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires après la suppression d'un élément de l'instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires avant la définition d'une valeur dans l'instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires après la définition d'une valeur dans l'instance de CollectionBase. |
|
On |
Exécute des processus personnalisés supplémentaires lors de la validation d'une valeur. |
|
Remove |
Supprime l'élément à l'index spécifié de l'instance de CollectionBase. Cette méthode n'est pas substituable. |
|
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
|
ICollection. |
Copie l'ensemble de l'objet CollectionBase vers un objet Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible. |
|
ICollection. |
Obtient une valeur indiquant si l’accès à CollectionBase est synchronisé (thread-safe). |
|
ICollection. |
Obtient un objet qui peut être utilisé pour synchroniser l’accès à CollectionBase. |
|
IList. |
Ajoute un objet à la fin de la CollectionBase. |
|
IList. |
Détermine si CollectionBase contient un élément spécifique. |
|
IList. |
Recherche le Object spécifié et retourne l’index de base zéro de la première occurrence dans l’ensemble du CollectionBase. |
|
IList. |
Insère un élément dans la classe CollectionBase au niveau de l'index spécifié. |
|
IList. |
Obtient une valeur indiquant si CollectionBase est de taille fixe. |
|
IList. |
Obtient une valeur indiquant si CollectionBase est en lecture seule. |
|
IList. |
Obtient ou définit l'élément au niveau de l'index spécifié. |
|
IList. |
Supprime la première occurrence d’un objet spécifique de CollectionBase. |
| Cast<TResult>(IEnumerable) |
Effectue un cast des éléments d'un IEnumerable vers le type spécifié. |
|
Of |
Filtre les éléments d'un IEnumerable en fonction du type spécifié. |
|
As |
Active la parallélisation d'une requête. |
|
As |
Convertit un IEnumerable en IQueryable. |
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |
Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.
Cette implémentation ne fournit pas de wrapper synchronisé (thread-safe) pour un CollectionBase, mais les classes dérivées peuvent créer leurs propres versions synchronisées de à l’aide CollectionBase de la SyncRoot propriété .
L’énumération par le biais d’une collection n’est pas intrinsèquement une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires: