SqlContext 类

定义

命名空间:

Microsoft.SqlServer.Server

程序集:

System.Data.dll

表示调用方上下文的抽象，该上下文提供对 SqlPipe、SqlTriggerContext 和 WindowsIdentity 对象的访问。 此类不能被继承。

public ref class SqlContext sealed

public sealed class SqlContext

type SqlContext = class

Public NotInheritable Class SqlContext

继承

Object

SqlContext

示例

以下示例创建一个新的 SqlDataRecord 及其 SqlMetaData。 然后，该示例使用 方法标记结果集的开头，使用 SendResultsStartSendResultsRow 方法将包含示例数据的记录发送回客户端，并使用 SendResultsEnd 方法标记结果集的末尾。

[Microsoft.SqlServer.Server.SqlProcedure]
public static void StoredProcReturnResultSet()
{
    // Create the record and specify the metadata for the columns.
    SqlDataRecord record = new SqlDataRecord(
        new SqlMetaData("col1", SqlDbType.NVarChar, 100),
        new SqlMetaData("col2", SqlDbType.Int));

    // Mark the begining of the result-set.
    SqlContext.Pipe.SendResultsStart(record);

    // Send 10 rows back to the client.
    for (int i = 0; i < 10; i++)
    {
        // Set values for each column in the row.
        record.SetString(0, "row " + i.ToString());
        record.SetInt32(1, i);

        // Send the row back to the client.
        SqlContext.Pipe.SendResultsRow(record);
    }

    // Mark the end of the result-set.
    SqlContext.Pipe.SendResultsEnd();
}

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub StoredProcReturnResultSet()

    ' Create the record and specify the metadata for the columns.
    Dim record As New SqlDataRecord( _
        New SqlMetaData("col1", SqlDbType.NVarChar, 100), _
        New SqlMetaData("col2", SqlDbType.Int))

    ' Mark the begining of the result-set.
    SqlContext.Pipe.SendResultsStart(record)

    ' Send 10 rows back to the client.
    Dim i As Integer
    For i = 0 To 9

        ' Set values for each column in the row.
        record.SetString(0, "row " & i.ToString())
        record.SetInt32(1, i)

        ' Send the row back to the client.
        SqlContext.Pipe.SendResultsRow(record)
    Next

    ' Mark the end of the result-set.
    SqlContext.Pipe.SendResultsEnd()
End Sub

注解

对象 SqlContext 可用于获取触发器) 中执行的代码的触发器上下文 (，管道对象 (可用时，例如在存储过程) 中。 如果客户端使用集成身份验证通过服务器进行身份验证，则它还可用于获取 WindowsIdentity 表示调用客户端的 Microsoft Windows 标识的对象。

属性

IsAvailable	指定调用代码是否在 SQL Server 中运行，以及上下文连接是否可访问。
Pipe	获取允许调用方将结果集、消息和命令的执行结果发送回客户端的管道对象。
TriggerContext	获取触发器上下文，该上下文用于向调用方提供有关导致触发器激发的原因的信息，以及被更新的列的映射。
WindowsIdentity	调用方的 Microsoft Windows 标识。