SmtpClient.Dispose Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skickar ett QUIT-meddelande till SMTP-servern, avslutar TCP-anslutningen på ett korrekt sätt och släpper alla resurser som används av den aktuella instansen SmtpClient av klassen.
Överlagringar
| Name | Description |
|---|---|
| Dispose() |
Skickar ett QUIT-meddelande till SMTP-servern, avslutar TCP-anslutningen på ett korrekt sätt och släpper alla resurser som används av den aktuella instansen SmtpClient av klassen. |
| Dispose(Boolean) |
Skickar ett QUIT-meddelande till SMTP-servern, avslutar TCP-anslutningen på ett korrekt sätt, släpper alla resurser som används av den aktuella instansen SmtpClient av klassen och tar eventuellt bort de hanterade resurserna. |
Kommentarer
Anslutningen som upprättas av den aktuella instansen SmtpClient av klassen till SMTP-servern kan återanvändas om ett program vill skicka flera meddelanden till samma SMTP-server. Detta är särskilt användbart när autentisering eller kryptering används för att upprätta en anslutning till SMTP-servern. Det kan vara dyrt att autentisera och upprätta en TLS-session. Ett krav på att återupprätta en anslutning för varje meddelande när du skickar en stor mängd e-post till samma SMTP-server kan ha en betydande inverkan på prestandan. Det finns ett antal e-postprogram med stora volymer som skickar uppdateringar av e-poststatus, nyhetsbrevsdistributioner eller e-postaviseringar. Många e-postklientprogram stöder också ett off-line-läge där användarna kan skapa många e-postmeddelanden som skickas senare när en anslutning till SMTP-servern upprättas. Det är vanligt att en e-postklient skickar alla SMTP-meddelanden till en specifik SMTP-server (tillhandahålls av Internetleverantören) som sedan vidarebefordrar det här e-postmeddelandet till andra SMTP-servrar.
SMTP-anslutningarna SmtpClient för klassimplementeringspooler så att de kan undvika omkostnaderna för att återupprätta en anslutning för varje meddelande till samma server. Ett program kan återanvända samma SmtpClient objekt för att skicka många olika e-postmeddelanden till samma SMTP-server och till många olika SMTP-servrar. Därför finns det inget sätt att avgöra när ett program är klart med objektet SmtpClient och det bör rensas.
När en SMTP-session är klar och klienten vill avsluta anslutningen måste den skicka ett QUIT-meddelande till servern för att indikera att den inte har fler meddelanden att skicka. På så sätt kan servern frigöra resurser som är associerade med anslutningen från klienten och bearbeta de meddelanden som skickades av klienten.
Metoderna Dispose itererar genom alla etablerade anslutningar och skickar ett QUIT-meddelande till varje SMTP-server, följt av att korrekt avsluta TCP-anslutningen. De här metoderna frigör även de ohanterade resurser som används av Socket och kan också ta bort de hanterade resurserna.
Dispose()
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
Skickar ett QUIT-meddelande till SMTP-servern, avslutar TCP-anslutningen på ett korrekt sätt och släpper alla resurser som används av den aktuella instansen SmtpClient av klassen.
public:
virtual void Dispose();
public void Dispose();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
Implementeringar
Kommentarer
Anslutningen som upprättas av den aktuella instansen SmtpClient av klassen till SMTP-servern kan återanvändas om ett program vill skicka flera meddelanden till samma SMTP-server. Detta är särskilt användbart när autentisering eller kryptering används för att upprätta en anslutning till SMTP-servern. Det kan vara dyrt att autentisera och upprätta en TLS-session. Ett krav på att återupprätta en anslutning för varje meddelande när du skickar en stor mängd e-post till samma SMTP-server kan ha en betydande inverkan på prestandan. Det finns ett antal e-postprogram med stora volymer som skickar uppdateringar av e-poststatus, nyhetsbrevsdistributioner eller e-postaviseringar. Många e-postklientprogram stöder också ett off-line-läge där användarna kan skapa många e-postmeddelanden som skickas senare när en anslutning till SMTP-servern upprättas. Det är vanligt att en e-postklient skickar alla SMTP-meddelanden till en specifik SMTP-server (tillhandahålls av Internetleverantören) som sedan vidarebefordrar det här e-postmeddelandet till andra SMTP-servrar.
SMTP-anslutningarna SmtpClient för klassimplementeringspooler så att de kan undvika omkostnaderna för att återupprätta en anslutning för varje meddelande till samma server. Ett program kan återanvända samma SmtpClient objekt för att skicka många olika e-postmeddelanden till samma SMTP-server och till många olika SMTP-servrar. Därför finns det inget sätt att avgöra när ett program är klart med objektet SmtpClient och det bör rensas.
När en SMTP-session är klar och klienten vill avsluta anslutningen måste den skicka ett QUIT-meddelande till servern för att indikera att den inte har fler meddelanden att skicka. På så sätt kan servern frigöra resurser som är associerade med anslutningen från klienten och bearbeta de meddelanden som skickades av klienten.
Dispose Om du anropar metoden för ett SmtpClient objekt som kör en asynkron SendAsync åtgärd avbryts sändningsåtgärden SendAsyncCancel som om metoden hade anropats.
Klassen SmtpClient har ingen Finalize metod. Därför måste ett program anropa Dispose för att uttryckligen frigöra resurser.
Metoden Dispose itererar genom alla etablerade anslutningar till SMTP-servern som anges i Host egenskapen och skickar ett QUIT-meddelande följt av ett korrekt slut på TCP-anslutningen. Metoden Dispose släpper även de ohanterade resurser som används av den underliggande Socket.
Anropa Dispose när du är klar med .SmtpClient Metoden Dispose lämnar SmtpClient i ett oanvändbart tillstånd. När du har anropat Disposemåste du släppa alla referenser till så att SmtpClient skräpinsamlaren kan frigöra det minne som SmtpClient upptogs.
Mer information finns i Rensa ohanterade resurser och implementera en rensningsmetod.
Note
Anropa Dispose alltid innan du släpper din senaste referens till SmtpClient. Annars frigörs inte de resurser som används, så skräpinsamlaren kan frigöra minnet.
Gäller för
Dispose(Boolean)
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
- Källa:
- SmtpClient.cs
Skickar ett QUIT-meddelande till SMTP-servern, avslutar TCP-anslutningen på ett korrekt sätt, släpper alla resurser som används av den aktuella instansen SmtpClient av klassen och tar eventuellt bort de hanterade resurserna.
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)
Parametrar
- disposing
- Boolean
true för att frigöra både hanterade och ohanterade resurser; false till versioner endast ohanterade resurser.
Kommentarer
Anslutningen som upprättas av den aktuella instansen SmtpClient av klassen till SMTP-servern kan återanvändas om ett program vill skicka flera meddelanden till samma SMTP-server. Detta är särskilt användbart när autentisering eller kryptering används för att upprätta en anslutning till SMTP-servern. Det kan vara dyrt att autentisera och upprätta en TLS-session. Ett krav på att återupprätta en anslutning för varje meddelande när du skickar en stor mängd e-post till samma SMTP-server kan ha en betydande inverkan på prestandan. Det finns ett antal e-postprogram med stora volymer som skickar uppdateringar av e-poststatus, nyhetsbrevsdistributioner eller e-postaviseringar. Många e-postklientprogram stöder också ett off-line-läge där användarna kan skapa många e-postmeddelanden som skickas senare när en anslutning till SMTP-servern upprättas. Det är vanligt att en e-postklient skickar alla SMTP-meddelanden till en specifik SMTP-server (tillhandahålls av Internetleverantören) som sedan vidarebefordrar det här e-postmeddelandet till andra SMTP-servrar.
SMTP-anslutningarna SmtpClient för klassimplementeringspooler så att de kan undvika omkostnaderna för att återupprätta en anslutning för varje meddelande till samma server. Ett program kan återanvända samma SmtpClient objekt för att skicka många olika e-postmeddelanden till samma SMTP-server och till många olika SMTP-servrar. Därför finns det inget sätt att avgöra när ett program är klart med objektet SmtpClient och det bör rensas.
När en SMTP-session är klar och klienten vill avsluta anslutningen måste den skicka ett QUIT-meddelande till servern för att indikera att den inte har fler meddelanden att skicka. På så sätt kan servern frigöra resurser som är associerade med anslutningen från klienten och bearbeta de meddelanden som skickades av klienten.
Dispose Om du anropar metoden för ett SmtpClient objekt som kör en asynkron SendAsync åtgärd avbryts sändningsåtgärden SendAsyncCancel som om metoden hade anropats.
Klassen SmtpClient har ingen Finalize metod. Därför måste ett program anropa Dispose för att uttryckligen frigöra resurser.
Metoden Dispose itererar genom alla etablerade anslutningar till SMTP-servern som anges i Host egenskapen och skickar ett QUIT-meddelande följt av ett korrekt slut på TCP-anslutningen. Metoden Dispose släpper även de ohanterade resurser som används av Socket och kan också ta bort de hanterade resurserna.
Anropa Dispose när du är klar med .SmtpClient Metoden Dispose lämnar SmtpClient i ett oanvändbart tillstånd. När du har anropat Disposemåste du släppa alla referenser till så att SmtpClient skräpinsamlaren kan frigöra det minne som SmtpClient upptogs.
Mer information finns i Rensa ohanterade resurser och implementera en rensningsmetod.
Note
Anropa Dispose alltid innan du släpper din senaste referens till SmtpClient. Annars frigörs inte de resurser som används, så skräpinsamlaren kan frigöra minnet.