SerialPort.Dispose(Boolean) 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 no administrados que usa SerialPort y, de forma opcional, libera los recursos administrados.
protected:
override void Dispose(bool disposing);
protected override void Dispose (bool disposing);
override this.Dispose : bool -> unit
Protected Overrides Sub Dispose (disposing As Boolean)
Parámetros
- disposing
- Boolean
Es true
para liberar tanto recursos administrados como no administrados; es false
para liberar únicamente recursos no administrados.
Excepciones
El puerto tiene un estado no válido.
o bien
Se ha producido un error al intentar establecer el estado del puerto subyacente. Por ejemplo, los parámetros que se han pasado desde este objeto SerialPort no eran válidos.
Comentarios
El método público Dispose() llama a este método y al Finalize() método , si se ha invalidado. Dispose() invoca el método protegido Dispose con el disposing
parámetro establecido en true
. Finalize
Dispose invoca con disposing
establecido en false
.
Cuando el parámetro disposing
es true
, este método libera todos los recursos retenidos por los objetos administrados a los que el control SerialPort hace referencia. Este método invoca al método Dispose() de cada uno de los objetos a los que se hace referencia.
Este método vacía y cierra el objeto de secuencia en la BaseStream propiedad .
Notas a los desarrolladores de herederos
Dispose() puede recibir varias llamadas de otros objetos. Al invalidar Dispose(Boolean), tenga cuidado de no hacer referencia a objetos que se hayan eliminado en una llamada anterior a Dispose(). Para obtener más información sobre cómo implementar Dispose(Boolean), vea Implementación de un método Dispose.
Para obtener más información sobre Dispose() y Finalize(), vea Limpieza de recursos no administrados.