IClosable.Close Méthode
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.
Libère les ressources système exposées par un objet Windows Runtime.
.NET Cette interface apparaît sous la forme System.IDisposable.
C++/CX Cette interface apparaît sous la forme Platform::IDisposable.
public:
void Close();void Close();public void Close();function close()Public Sub Close ()Les notes d’implémentation/d’appelant qui suivent sont principalement pertinentes pour WRL.
Implémentez cette méthode pour libérer les ressources système exclusives utilisées, telles que les handles de fichiers, les flux et les sockets réseau. La méthode doit également libérer d’autres ressources en cours d’utilisation, notamment les références d’objets et la mémoire, pour les préparer à la réutilisation.
Cette méthode doit appeler la méthode Close de tout objet qu’elle contient qui implémente IClosable.
La méthode Close doit libérer les ressources système le plus rapidement possible, sans bloquer l’exécution des opérations asynchrones. Pour s’assurer que toutes les ressources sont complètement libérées, l’appelant doit attendre que toutes les opérations asynchrones en cours se terminent avant d’appeler Close.
Une fois close retourné, l’objet est toujours en mémoire, mais sans les ressources système dont il a besoin ; par conséquent, la plupart de ses membres ne sont pas utilisables. Un membre qui dépend d’une ressource système libérée peut retourner RO_E_CLOSED pour indiquer que l’objet est fermé et qu’il ne peut pas terminer l’opération demandée.
Si vous appelez Close plusieurs fois, il n’y a aucun effet ; la méthode retourne S_OK.
Les méthodes closes ne peuvent pas être appelées via C++/CX sur Windows Runtime instances de classe où la classe a implémenté IClosable, mais sont automatiquement appelées à la fin de l’étendue actuelle. Le code C++/CX pour les classes runtime doit appeler le destructeur ou définir la dernière référence sur null.
En C#, cette méthode est exposée en tant que Dispose. Vous pouvez appeler Disposer directement ou utiliser une instruction using.
| Produit | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |