SqlContext Klasse

Definition

Stellt eine Abstraktion des Aufruferkontextes dar, die Zugriff auf das SqlPipe-Objekt, das SqlTriggerContext-Objekt und das WindowsIdentity-Objekt bereitstellt.Represents an abstraction of the caller's context, which provides access to the SqlPipe, SqlTriggerContext, and WindowsIdentity objects. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class SqlContext sealed
public sealed class SqlContext
type SqlContext = class
Public NotInheritable Class SqlContext
Vererbung
SqlContext

Beispiele

Im folgenden Beispiel werden ein neues SqlDataRecord SqlMetaDataund ein erstellt.The following example creates a new SqlDataRecord and its SqlMetaData. Anschließend markiert das Beispiel den Anfang eines Resultsets mithilfe der SendResultsStart -Methode, sendet mithilfe der SendResultsRow -Methode Datensätze mit Beispiel Daten an den Client zurück und markiert das Ende des Resultsets SendResultsEnd mit der-Methode.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

Hinweise

Das SqlContext -Objekt kann verwendet werden, um den Auslöse Kontext (für Code, der in einem-Endpunkt ausgeführt wird) und das Pipe-Objekt (sofern verfügbar, wie in gespeicherten Prozeduren) abzurufen.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). Sie kann auch verwendet werden, um ein WindowsIdentity -Objekt abzurufen, das die Microsoft Windows-Identität des aufrufenden Clients darstellt, wenn sich der Client beim Server mithilfe der integrierten Authentifizierung authentifiziert hat.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.

Eigenschaften

IsAvailable

Gibt an, ob der aufrufende Code in SQL Server ausgeführt wird und ob auf die Kontextverbindung zugegriffen werden kann.Specifies whether the calling code is running within SQL Server, and if the context connection can be accessed.

Pipe

Ruft das Pipe-Objekt ab, das dem Aufrufer das Senden von Resultsets, Meldungen und Ergebnissen der Ausführung von Befehlen zurück an den Client ermöglicht.Gets the pipe object that allows the caller to send result sets, messages, and the results of executing commands back to the client.

TriggerContext

Ruft den Triggerkontext ab, mit dem dem Aufrufer Informationen über den Auslöser des Triggers und eine Zuordnung der aktualisierten Spalten bereitgestellt werden.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

Die Microsoft Windows-Identität des Aufrufers.The Microsoft Windows identity of the caller.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: