Thread.BeginThreadAffinity Método

Definição

Namespace:
System.Threading
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Notifica um host que o código gerenciado está prestes a executar instruções que dependem da identidade do thread atual do sistema operacional físico.

public:
 static void BeginThreadAffinity();
public static void BeginThreadAffinity();
[System.Security.SecurityCritical]
public static void BeginThreadAffinity();
static member BeginThreadAffinity : unit -> unit
[<System.Security.SecurityCritical>]
static member BeginThreadAffinity : unit -> unit
Public Shared Sub BeginThreadAffinity ()
Atributos
SecurityCriticalAttribute

Exceções

SecurityException

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

Exemplos

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

using System.Threading;

public class MyUtility
{
    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.
    }
}

open System.Threading

let 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 do common language runtime, como Microsoft SQL Server 2005, fornecem seu próprio gerenciamento de thread. Um host que fornece seu próprio gerenciamento de thread pode mover uma tarefa em execução de um thread do 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, dependem da identidade de um thread do sistema operacional físico. Essas tarefas devem informar o 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 win32 CRITICAL_SECTION, você deverá chamar BeginThreadAffinity antes de adquirir o bloqueio e EndThreadAffinity depois de liberar o bloqueio.

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

Aplica-se a

Confira também