SqlContext SqlContext SqlContext SqlContext Class

Definition

表示调用方上下文的抽象,该上下文提供对 SqlPipeSqlTriggerContextWindowsIdentity 对象的访问。 Represents an abstraction of the caller's context, which provides access to the SqlPipe, SqlTriggerContext, and WindowsIdentity objects. 此类不能被继承。 This class cannot be inherited.

public ref class SqlContext sealed
public sealed class SqlContext
type SqlContext = class
Public NotInheritable Class SqlContext
Inheritance
SqlContextSqlContextSqlContextSqlContext

Examples

下面的示例创建一个新SqlDataRecord并将其SqlMetaDataThe following example creates a new SqlDataRecord and its SqlMetaData. 该示例然后表示结果集使用开头SendResultsStart方法中,将使用示例数据记录发送回客户端使用SendResultsRow方法,并使用集结果的结尾标记SendResultsEnd方法。The example then marks the beginning of a result set using the SendResultsStart method, sends records with example data back to the client using the SendResultsRow method, and marks the end of the result set with the SendResultsEnd method.

[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

Remarks

SqlContext对象可以用于获取触发器上下文 (适用于在触发器中执行的代码) 和管道对象 (如果可用,如存储过程中)。The SqlContext object can be used to obtain the trigger context (for code executing in a trigger) and the pipe object (when available, such as in stored procedures). 此外可以用于获取WindowsIdentity对象,表示调用客户端的 Microsoft Windows 标识,如果客户端进行身份验证服务器使用集成身份验证。It can also be used to obtain a WindowsIdentity object that represents the Microsoft Windows identity of the calling client, if the client authenticated with the server using integrated authentication.

Properties

IsAvailable IsAvailable IsAvailable IsAvailable

指定调用代码是否在 SQL Server 中运行,以及上下文连接是否可访问。 Specifies whether the calling code is running within SQL Server, and if the context connection can be accessed.

Pipe Pipe Pipe Pipe

获取允许调用方将结果集、消息和命令的执行结果发送回客户端的管道对象。 Gets the pipe object that allows the caller to send result sets, messages, and the results of executing commands back to the client.

TriggerContext TriggerContext TriggerContext TriggerContext

获取触发器上下文,该上下文用于向调用方提供有关导致触发器激发的原因的信息,以及被更新的列的映射。 Gets the trigger context used to provide the caller with information about what caused the trigger to fire, and a map of the columns that were updated.

WindowsIdentity WindowsIdentity WindowsIdentity WindowsIdentity

调用方的 Microsoft Windows 标识。 The Microsoft Windows identity of the caller.

Methods

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。 Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。 Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

获取当前实例的 Type Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。 Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

返回表示当前对象的字符串。 Returns a string that represents the current object.

(Inherited from Object)

Applies to