Stream.Dispose Stream.Dispose Stream.Dispose Stream.Dispose Method

Definizione

Rilascia tutte le risorse usate dall'oggetto Stream.Releases all resources used by the Stream object.

Overload

Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Stream.Releases all resources used by the Stream.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Stream e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Stream.Releases all resources used by the Stream.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementazioni

Commenti

Questo metodo elimina il flusso, scrivendo le modifiche apportate all'archivio di backup e chiudendo il flusso per rilasciare le risorse.This method disposes the stream, by writing any changes to the backing store and closing the stream to release resources.

La Dispose chiamata a consente di riallocare le risorse utilizzate dall'oggetto Stream per altri scopi.Calling Dispose allows the resources used by the Stream to be reallocated for other purposes. Per ulteriori informazioni su Dispose, vedere pulizia di risorse non gestite.For more information about Dispose, see Cleaning Up Unmanaged Resources.

Note per gli eredi

Inserire tutta la logica di pulizia per l'oggetto Dispose(Boolean)flusso in.Place all cleanup logic for your stream object in Dispose(Boolean). Non eseguire l' Close()override di.Do not override Close().

Si noti che a causa dei requisiti di compatibilità con le versioni precedenti, l'implementazione di questo metodo differisce dalle linee guida consigliate per il modello Dispose.Note that because of backward compatibility requirements, this method's implementation differs from the recommended guidance for the Dispose pattern. Questo metodo chiama Close(), che quindi chiama Dispose(Boolean).This method calls Close(), which then calls Dispose(Boolean).

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Stream e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

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)

Parametri

disposing
Boolean Boolean Boolean Boolean

true per rilasciare sia le risorse gestite sia quelle non gestite, false per rilasciare solo le risorse non gestite.true to release both managed and unmanaged resources; false to release only unmanaged resources.

Commenti

È necessario rilasciare tutte le risorse true specificando disposingfor.You should release all resources by specifying true for disposing. Quando disposing ètrue, il flusso può anche garantire che i dati vengano scaricati nel buffer sottostante e accedano ad altri oggetti finalizzabili.When disposing is true, the stream can also ensure data is flushed to the underlying buffer, and access other finalizable objects. Questo potrebbe non essere possibile quando viene chiamato da un finalizzatore a causa di una mancanza di ordinamento tra i finalizzatori.This may not be possible when called from a finalizer due a lack of ordering among finalizers.

Se il flusso usa un handle del sistema operativo per comunicare con la relativa origine, provare a usare una SafeHandle sottoclasse di a questo scopo.If your stream is using an operating system handle to communicate with its source, consider using a subclass of SafeHandle for this purpose.

Questo metodo viene chiamato dal metodo pubblico Dispose e dal Finalize metodo.This method is called by the public Dispose method and the Finalize method. Disposerichiama il metodo protetto Dispose con il disposing parametro impostato su true.Dispose invokes the protected Dispose method with the disposing parameter set to true. FinalizeDispose richiama con disposing impostato su false.Finalize invokes Dispose with disposing set to false.

Note per gli eredi

Nelle classi derivate, non eseguire Close() l'override del metodo, bensì inserire tutta la logica di pulizia del Dispose(Boolean) flusso nel metodo.In derived classes, do not override the Close() method, instead, put all of the Stream cleanup logic in the Dispose(Boolean) method.

Il metodo Dispose() può essere chiamato più volte da altri oggetti.Dispose() can be called multiple times by other objects. In caso di override di Dispose(Boolean), non fare riferimento a oggetti già eliminati in una chiamata precedente a Dispose().When overriding Dispose(Boolean), be careful not to reference objects that have been previously disposed of in an earlier call to Dispose(). Per ulteriori informazioni sull' Dispose(Boolean)implementazione di, vedere implementazione di un metodo Dispose.For more information about how to implement Dispose(Boolean), see Implementing a Dispose Method.

Per ulteriori informazioni su Dispose() e Finalize(), vedere pulizia di risorse non gestite.For more information about Dispose() and Finalize(), see Cleaning Up Unmanaged Resources.

Si applica a