Langage

ICollection.Add(Object) Méthode

Définition

Garantit que cette collection contient l’élément spécifié (opération facultative).

[Android.Runtime.Register("add", "(Ljava/lang/Object;)Z", "GetAdd_Ljava_lang_Object_Handler:Java.Util.ICollectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public bool Add(Java.Lang.Object? e);
[<Android.Runtime.Register("add", "(Ljava/lang/Object;)Z", "GetAdd_Ljava_lang_Object_Handler:Java.Util.ICollectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Add : Java.Lang.Object -> bool

Paramètres

e
Object

élément dont la présence dans cette collection doit être assurée

Retours

true si cette collection a changé suite à l’appel

Attributs

Remarques

Garantit que cette collection contient l’élément spécifié (opération facultative). Retourne true si cette collection a changé à la suite de l’appel. (Renvoie false si cette collection n’autorise pas les doublons et contient déjà l’élément spécifié.)

Les collections qui prennent en charge cette opération peuvent placer des limitations sur les éléments qui peuvent être ajoutés à cette collection. En particulier, certaines collections refusent d’ajouter null des éléments, et d’autres imposent des restrictions sur le type d’éléments qui peuvent être ajoutés. Les classes de collection doivent clairement spécifier dans leur documentation toutes les restrictions sur les éléments qui peuvent être ajoutés.

Si une collection refuse d’ajouter un élément particulier pour une raison autre que celle qu’elle contient déjà, elle doit lever une exception (au lieu de retourner false). Cela conserve l’invariant qu’une collection contient toujours l’élément spécifié une fois cet appel retourné.

Documentation Java pour java.util.Collection.add(E).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à