Thread.EndThreadAffinity Método

Definição

Namespace:

System.Threading

Assembly:

System.Threading.Thread.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Notifica um host que o código gerenciado terminou de executar as instruções que dependem da identidade do thread do sistema operacional físico atual.

public:
 static void EndThreadAffinity();

public static void EndThreadAffinity ();

[System.Security.SecurityCritical]
public static void EndThreadAffinity ();

static member EndThreadAffinity : unit -> unit

[<System.Security.SecurityCritical>]
static member EndThreadAffinity : unit -> unit

Public Shared Sub EndThreadAffinity ()

Atributos

SecurityCriticalAttribute

Exceções

SecurityException

O chamador não tem a permissão necessária.

Exemplos

O exemplo a seguir demonstra o uso dos BeginThreadAffinity EndThreadAffinity métodos e para notificar um host de que um bloco de código depende da identidade de um thread de sistema operacional físico.

using namespace System::Threading;
using namespace System::Security::Permissions;

public ref class MyUtility
{
public:
   [SecurityPermissionAttribute(SecurityAction::Demand, ControlThread=true)]
   void PerformTask()
   {
      // Code that does not have thread affinity goes here.
      //
      Thread::BeginThreadAffinity();
      //
      // Code that has thread affinity goes here.
      //
      Thread::EndThreadAffinity();
      //
      // More code that does not have thread affinity.
   }
};

using System.Threading;
using System.Security.Permissions;

[SecurityPermission(SecurityAction.Demand, Flags=SecurityPermissionFlag.ControlThread)]
public class MyUtility
{
    [SecurityPermission(SecurityAction.Demand, Flags=SecurityPermissionFlag.ControlThread)]
    public void PerformTask()
    {
        // Code that does not have thread affinity goes here.
        //
        Thread.BeginThreadAffinity();
        //
        // Code that has thread affinity goes here.
        //
        Thread.EndThreadAffinity();
        //
        // More code that does not have thread affinity.
    }
}

Imports System.Threading
Imports System.Security.Permissions

<SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlThread)> _
Friend Class MyUtility
    <SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlThread)> _
    Public Sub PerformTask() 
        ' Code that does not have thread affinity goes here.
        '
        Thread.BeginThreadAffinity()
        '
        ' Code that has thread affinity goes here.
        '
        Thread.EndThreadAffinity()
        '
        ' More code that does not have thread affinity.
    End Sub
End Class

Comentários

alguns hosts da Common Language Runtime, como Microsoft SQL Server 2005, fornecem seu próprio gerenciamento de threads. Um host que fornece seu próprio gerenciamento de threads pode mover uma tarefa em execução de um thread de sistema operacional físico para outro a qualquer momento. A maioria das tarefas não é afetada por essa alternância. No entanto, algumas tarefas têm afinidade de thread – ou seja, elas dependem da identidade de um thread de sistema operacional físico. Essas tarefas devem informar ao host quando eles executam o código que não deve ser alternado.

Por exemplo, se o aplicativo chamar uma API do sistema para adquirir um bloqueio do sistema operacional que tenha afinidade de thread, como um CRITICAL_SECTION Win32, você deverá chamar BeginThreadAffinity antes de adquirir o bloqueio e EndThreadAffinity depois de liberar o bloqueio.

usar esse método no código que é executado em SQL Server 2005 requer que o código seja executado no nível de proteção de host mais alto.

Confira também

• BeginThreadAffinity()