System.Classes.TThread.Synchronize

• Aller au parent : TThread

Delphi

procedure Synchronize(AMethod: TThreadMethod); overload;
procedure Synchronize(AThreadProc: TThreadProcedure); overload;
class procedure Synchronize(AThread: TThread; AMethod: TThreadMethod); overload; static;
class procedure Synchronize(AThread: TThread; AThreadProc: TThreadProcedure); overload; static;

C++

void __fastcall Synchronize(TThreadMethod AMethod)/* overload */;
void __fastcall Synchronize(_di_TThreadProcedure AThreadProc)/* overload */;
static void __fastcall Synchronize(TThread* AThread, TThreadMethod AMethod)/* overload */;
static void __fastcall Synchronize(TThread* AThread, _di_TThreadProcedure AThreadProc)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	protected	System.Classes.pas System.Classes.hpp	System.Classes	TThread

Description

Exécute un appel de méthode dans le thread principal.

Synchronize provoque l'exécution de l'appel spécifié par AMethod en utilisant le thread principal, ce qui évite les conflits multithread. Le thread en cours est transmis dans le paramètre AThread.

Si vous n'êtes pas sûr qu'un appel de méthode soit adapté à l'utilisation de threads, effectuez l'appel depuis la méthode Synchronize pour garantir son exécution dans le thread principal.

L'exécution du thread en cours est interrompue tant que la méthode s'exécute dans le thread principal.

Avertissement : N'appelez pas Synchronize à partir du thread principal. Cela peut conduire à une boucle infinie.

Remarque : Vous pouvez aussi protéger les méthodes non sécurisées en utilisant des sections critiques ou le synchroniseur en écriture exclusive multilecture.

Remarque : Lorsque vous utilisez la version statique de la méthode Synchronize avec nil/NULL en tant que premier paramètre, la méthode référencée par AMethod sera synchronisée dans le thread principal.

Un exemple d'une situation où vous pouvez utiliser Synchronize est lorsque vous voulez interagir avec un composant VCL. Utilisez une méthode anonyme in-situ pour résoudre le problème de la transmission des variables à la méthode que vous voulez synchroniser :

Synchronize(
  procedure
  begin
    Form1.Memo1.Lines.Add(‘Begin Execution’);
  end);

Voir aussi

• Execute

• OnTerminate

• TCriticalSection

• TMultiReadExclusiveWriteSynchronizer

• CheckSynchronize

• Utilisation du thread VCL principal

Exemples de code

• Synchronize (Delphi)
• ThreadSynchronize (C++)
• ThreadSynchronize (Delphi)
• TThreadYield (Delphi)
• TThreadYield (C++)
• Exemple Threads