IClosable.Close Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Libera los recursos del sistema expuestos por un objeto Windows Runtime.
.RED Esta interfaz aparece como System.IDisposable.
C++/CX Esta interfaz aparece como Platform::IDisposable.
public:
void Close();void Close();public void Close();function close()Public Sub Close ()Comentarios
Las notas de implementación o llamador que siguen son principalmente relevantes para WRL.
Notas para los implementadores
Implemente este método para liberar los recursos exclusivos del sistema que están en uso, como identificadores de archivos, secuencias y sockets de red. El método también debe liberar otros recursos que están en uso, incluidas las referencias de objetos y la memoria, para prepararlos para su reutilización.
Este método debe llamar al método Close de cualquier objeto que contenga que implemente IClosable.
El método Close debe liberar los recursos del sistema lo antes posible, sin bloquear para que se completen las operaciones asincrónicas. Para asegurarse de que todos los recursos están completamente liberados, el autor de la llamada debe esperar a que se completen todas las operaciones asincrónicas pendientes antes de llamar a Close.
Después de que Close devuelva, el objeto todavía está en memoria, pero sin los recursos del sistema que necesita; por lo tanto, la mayoría de sus miembros no son utilizables. Un miembro que depende de un recurso del sistema liberado puede devolver RO_E_CLOSED para indicar que el objeto está cerrado y no puede completar la operación solicitada.
Notas a los autores de llamadas
Si llamas a Close varias veces, no hay ningún efecto; el método devuelve S_OK.
Los métodos Close no se pueden llamar a través de C++/CX en Windows Runtime instancias de clase donde la clase implementó IClosable, pero se llama automáticamente al final del ámbito actual. El código de C++/CX para las clases en tiempo de ejecución debe llamar al destructor o establecer la última referencia en NULL.
En C#, este método se expone como Dispose. Puede llamar directamente a Dispose o usar una instrucción using.