Stream.Dispose Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Uvolní všechny prostředky používané objektem Stream .

Přetížení

Name	Description
Dispose()	Uvolní všechny prostředky používané nástrojem Stream.
Dispose(Boolean)	Uvolní nespravované prostředky používané Stream a volitelně uvolní spravované prostředky.

Dispose()

Zdroj:

Stream.cs

Uvolní všechny prostředky používané nástrojem Stream.

public:
 virtual void Dispose();

public void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementuje

Dispose()

Poznámky

Tato metoda odstraní stream tím, že zapíše všechny změny do záložního úložiště a zavře stream pro uvolnění prostředků.

Volání Dispose umožňuje, aby prostředky používané relokací Stream byly relokovány pro jiné účely. Další informace naleznete v Disposetématu Čištění nespravovaných prostředků.

Poznámky pro dědice

Umístěte veškerou logiku čištění objektu streamu do Dispose(Boolean). Nepřepsat Close().

Vzhledem k požadavkům na zpětnou kompatibilitu se implementace této metody liší od doporučených pokynů pro model Dispose. Tato metoda volá Close(), která pak volá Dispose(Boolean).

Dispose(Boolean)

Zdroj:

Stream.cs

Uvolní nespravované prostředky používané Stream a volitelně uvolní spravované prostředky.

protected:
 virtual void Dispose(bool disposing);

protected virtual void Dispose(bool disposing);

abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit

Protected Overridable Sub Dispose (disposing As Boolean)

Parametry

disposing

Boolean

true uvolnění spravovaných i nespravovaných prostředků; false uvolnit pouze nespravované prostředky.

Poznámky

Všechny prostředky byste měli uvolnit zadáním parametru truedisposing. Pokud disposing ano true, stream může také zajistit, aby se data vyprázdnila do podkladové vyrovnávací paměti, a přistupovat k dalším finalizovatelným objektům. To nemusí být možné při zavolání z finalizátoru kvůli nedostatku řazení mezi finalizátory.

Pokud váš datový proud ke komunikaci se zdrojem používá popisovač operačního systému, zvažte použití podtřídy SafeHandle pro tento účel.

Tato metoda je volána veřejnou Dispose() metodou a metodou Finalize() , pokud byla přepsána. Dispose() vyvolá chráněnou Dispose metodu s parametrem nastaveným disposing na true. Finalize Dispose vyvolá se nastavenou disposing na falsehodnotu .

Poznámky pro dědice

V odvozených třídách nepřepište metodu Close() , místo toho vložte do metody veškerou logiku Dispose(Boolean) čištění Stream.

Dispose() lze volat vícekrát jinými objekty. Při přepsání Dispose(Boolean)buďte opatrní, abyste neodkazovali na objekty, které byly dříve odstraněny v dřívějším volání Dispose(). Další informace o implementaci Dispose(Boolean)naleznete v tématu Implementace metody Dispose.

Další informace o Dispose() službě a Finalize()naleznete v tématu Čištění nespravovaných prostředků.