Skip to Main Content
C# in a Nutshell
book

C# in a Nutshell

by Ben Albahari, Ted Neward, Peter Drayton
March 2002
Intermediate to advanced content levelIntermediate to advanced
864 pages
31h 8m
English
O'Reilly Media, Inc.
Content preview from C# in a Nutshell

Name

IDisposable

Synopsis

This interface provides a last-ditch cleanup hook with well-known timing semantics (similar in concept to a C++ destructor). This is called deterministic finalization.

As part of normal garbage-collection operation, the CLR looks for (and calls if available) the object’s Finalize method right before it removes an object from heap memory. Unfortunately, because the CLR may not garbage-collect the object as soon as it becomes available for collection, objects may hold onto resources for longer than necessary. The IDisposable interface is intended to work with language constructs to let you ensure that key resources are released in a time-efficient manner.

In C#, any object whose type implements the IDisposable interface must have a corresponding Dispose() method defined for it. This in turn makes the object eligible for use in the C# using block declaration. For more details, see Section 2.9 in Chapter 2.

If a type provides a Finalize method, then it should also inherit this interface and provide a corresponding Dispose() method. In addition, once the Dispose() method is called, part of its implementation should be to call the GC.SuppressFinalize() method to prevent the garbage collector from finalizing this object again when garbage collection occurs.

public interface IDisposable {
// Public Instance Methods
   public method void Dispose();  
}

Implemented By

Multiple types

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

C# 8.0 in a Nutshell

C# 8.0 in a Nutshell

Joseph Albahari, Eric Johannsen
C# 10 in a Nutshell

C# 10 in a Nutshell

Joseph Albahari
C# in a Nutshell, Second Edition

C# in a Nutshell, Second Edition

Peter Drayton, Ben Albahari, Ted Neward
Code like a Pro in C#

Code like a Pro in C#

Jort Rodenburg

Publisher Resources

ISBN: 0596001819Catalog PageErrata