Objet SqlContext

S’applique à : SQL Server

Vous appelez du code managé sur le serveur lorsque vous appelez une procédure ou une fonction, lorsque vous appelez une méthode sur un type CLR (Common Language Runtime) défini par l’utilisateur, ou lorsque votre action déclenche un déclencheur défini dans l’un des langages Microsoft .NET Framework. Comme l'exécution de ce code est demandée dans le cadre d'une connexion utilisateur, l'accès au contexte de l'appelant à partir du code en cours d'exécution dans le serveur est requis. De plus, certaines opérations d'accès aux données ne peuvent être valides que si elles sont exécutées sous le contexte de l'appelant. Par exemple, l'accès à des pseudo-tables insérées et supprimées utilisées dans les opérations de déclencheur n'est valide que sous le contexte de l'appelant.

Le contexte de l’appelant est abstrait dans un objet SqlContext . Pour plus d’informations sur les méthodes et propriétés SqlTriggerContext , consultez la documentation de référence de la classe Microsoft.SqlServer.Server.SqlTriggerContext dans le Kit de développement logiciel (SDK) .NET Framework.

SqlContext fournit l’accès aux composants suivants :

• SqlPipe : l’objet SqlPipe représente le « canal » à travers lequel les résultats circulent vers le client. Pour plus d’informations sur l’objet SqlPipe, consultez l’objet SqlPipe.

• SqlTriggerContext : l’objet SqlTriggerContext ne peut être récupéré qu’à partir d’un déclencheur CLR. Il fournit des informations sur l'opération qui a provoqué l'activation du déclencheur et un mappage des colonnes mises à jour. Pour plus d’informations sur l’objet SqlTriggerContext , consultez l’objet SqlTriggerContext.

• IsAvailable : la propriété IsAvailable est utilisée pour déterminer la disponibilité du contexte.

• WindowsIdentity : la propriété WindowsIdentity est utilisée pour récupérer l’identité Windows de l’appelant.

Détermination de la disponibilité du contexte

Interrogez la classe SqlContext pour voir si le code en cours d’exécution est en cours d’exécution. Pour ce faire, vérifiez la propriété IsAvailable de l’objet SqlContext . La propriété IsAvailable est en lecture seule et retourne True si le code appelant s’exécute à l’intérieur de SQL Server et si d’autres membres SqlContext sont accessibles. Si la propriété IsAvailable retourne False, tous les autres membres SqlContext lèvent une exception InvalidOperationException, le cas échéant. Si IsAvailable retourne False, toute tentative d’ouverture d’un objet de connexion avec « context connection=true » dans le chaîne de connexion échoue.

Extraction de l'identité Windows

Le code CLR s’exécutant à l’intérieur de SQL Server est toujours appelé dans le contexte du compte de processus. Si le code doit effectuer certaines actions à l’aide de l’identité de l’utilisateur appelant, au lieu de l’identité du processus SQL Server, un jeton d’emprunt d’identité doit être obtenu via la propriété WindowsIdentity de l’objet SqlContext . La propriété WindowsIdentity retourne une instance WindowsIdentity représentant l’identité Microsoft Windows de l’appelant, ou null si le client a été authentifié à l’aide de l’authentification SQL Server. Seuls les assemblys marqués avec des autorisations EXTERNAL_ACCESS ou UNSAFE peuvent accéder à cette propriété.

Après avoir obtenu l’objet WindowsIdentity , les appelants peuvent emprunter l’identité du compte client et effectuer des actions en leur nom.

L’identité de l’appelant est disponible uniquement via SqlContext.WindowsIdentity si le client qui a lancé l’exécution de la procédure stockée ou de la fonction connectée au serveur à l’aide de l’authentification Windows. Si l’authentification SQL Server a été utilisée à la place, cette propriété a la valeur Null et le code ne peut pas emprunter l’identité de l’appelant.

Exemple

L'exemple suivant montre comment obtenir l'identité Windows du client appelant et emprunter l'identité du client.

C#

[Microsoft.SqlServer.Server.SqlProcedure]  
public static void WindowsIDTestProc()  
{  
    WindowsIdentity clientId = null;  
    WindowsImpersonationContext impersonatedUser = null;  
  
    // Get the client ID.  
    clientId = SqlContext.WindowsIdentity;  
  
    // This outer try block is used to thwart exception filter   
    // attacks which would prevent the inner finally   
    // block from executing and resetting the impersonation.  
    try  
    {  
        try  
        {  
            impersonatedUser = clientId.Impersonate();  
            if (impersonatedUser != null)  
            {  
                // Perform some action using impersonation.  
            }  
        }  
        finally  
        {  
            // Undo impersonation.  
            if (impersonatedUser != null)  
                impersonatedUser.Undo();  
        }  
    }  
    catch  
    {  
        throw;  
    }  
}  

Visual Basic

<Microsoft.SqlServer.Server.SqlProcedure()> _  
Public Shared Sub  WindowsIDTestProcVB ()  
    Dim clientId As WindowsIdentity  
    Dim impersonatedUser As WindowsImpersonationContext  
  
    ' Get the client ID.  
    clientId = SqlContext.WindowsIdentity  
  
    ' This outer try block is used to thwart exception filter   
    ' attacks which would prevent the inner finally   
    ' block from executing and resetting the impersonation.  
  
    Try  
        Try  
  
            impersonatedUser = clientId.Impersonate()  
  
            If impersonatedUser IsNot Nothing Then  
                ' Perform some action using impersonation.  
            End If  
  
        Finally  
            ' Undo impersonation.  
            If impersonatedUser IsNot Nothing Then  
                impersonatedUser.Undo()  
            End If  
        End Try  
  
    Catch e As Exception  
  
        Throw e  
  
    End Try  
End Sub  

Voir aussi

Objet SqlPipe
Objet SqlTriggerContext
Déclencheurs CLR
Extensions spécifiques in-process de SQL Server à ADO.NET