SerialPort.Dispose(Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Освобождает неуправляемые ресурсы, используемые объектом SerialPort, а при необходимости освобождает также управляемые ресурсы.
protected:
override void Dispose(bool disposing);
protected override void Dispose (bool disposing);
override this.Dispose : bool -> unit
Protected Overrides Sub Dispose (disposing As Boolean)
Параметры
- disposing
- Boolean
Значение true
позволяет освободить как управляемые, так и неуправляемые ресурсы; значение false
освобождает только неуправляемые ресурсы.
Исключения
Порт находится в недействительном состоянии.
-или-
Попытка задать состояние базового порта завершилась неудачей. Например, вследствие недопустимости переданных этим объектом SerialPort параметров.
Комментарии
Этот метод вызывается открытым Dispose() методом и методом Finalize() , если он был переопределен. Dispose() вызывает защищенный Dispose метод с параметром disposing
, равным true
. Finalize
вызывает с присвоением Disposedisposing
значения false
.
Если параметр disposing
имеет значение true
, то данный метод освобождает все ресурсы, занятые любыми управляемыми объектами, на которые ссылается этот объект SerialPort. Этот метод вызывает метод Dispose() каждого такого объекта.
Этот метод очищает и закрывает объект потока в свойстве BaseStream .
Примечания для тех, кто наследует этот метод
Метод Dispose() может вызываться несколько раз другими объектами. При переопределении метода Dispose(Boolean) нужно избегать ссылок на объекты, которые были уничтожены предыдущими вызовами метода Dispose(). Дополнительные сведения о реализации Dispose(Boolean)см. в разделе Реализация метода Dispose.
Дополнительные сведения о Dispose() и Finalize()см. в разделе Очистка неуправляемых ресурсов.