SqlPipe Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Umožňuje, aby spravované uložené procedury spuštěné v procesu v databázi SQL Server vracely výsledky zpět volajícímu. Tato třída se nemůže dědit.
public ref class SqlPipe sealed
public sealed class SqlPipe
type SqlPipe = class
Public NotInheritable Class SqlPipe
- Dědičnost
-
SqlPipe
Příklady
Následující příklad používá SqlConnection a SqlCommand k výběru řádků ze zdroje dat v uložené proceduře. Příklad pak použije SqlPipe příkaz ke spuštění příkazu a odeslání výsledků zpět klientovi.
[Microsoft.SqlServer.Server.SqlProcedure()]
public static void StoredProcExecuteCommand(int rating)
{
// Connect through the context connection.
using (SqlConnection connection = new SqlConnection("context connection=true"))
{
connection.Open();
SqlCommand command = new SqlCommand(
"SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor " +
"WHERE CreditRating <= @rating", connection);
command.Parameters.AddWithValue("@rating", rating);
// Execute the command and send the results directly to the client.
SqlContext.Pipe.ExecuteAndSend(command);
}
}
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub StoredProcExecuteCommand(ByVal rating As Integer)
Dim command As SqlCommand
' Connect through the context connection
Using connection As New SqlConnection("context connection=true")
connection.Open()
command = New SqlCommand( _
"SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor " & _
"WHERE CreditRating <= @rating", connection)
command.Parameters.AddWithValue("@rating", rating)
' Execute the command and send the results directly to the client
SqlContext.Pipe.ExecuteAndSend(command)
End Using
End Sub
Poznámky
Instance této třídy je zpřístupněna spravovaným uloženým procedurami prostřednictvím Pipe vlastnosti SqlContext třídy .
Vlastnosti
| IsSendingResults |
Získá hodnotu, která označuje, zda SqlPipe je v režimu odesílání jedné sady výsledků zpět do klienta. Tato vlastnost je jen ke čtení. |
Metody
| ExecuteAndSend(SqlCommand) |
Spustí příkaz předaný jako parametr a odešle výsledky klientovi. |
| Send(SqlDataReader) |
Odešle vícenásobnou sadu výsledků dotazu přímo klientovi nebo aktuálnímu příjemci výstupu. |
| Send(SqlDataRecord) |
Odešle sadu výsledků s jedním řádkem přímo klientovi nebo aktuálnímu příjemci výstupu. |
| Send(String) |
Odešle řetězcovou zprávu přímo klientovi nebo aktuálnímu příjemci výstupu. |
| SendResultsEnd() |
Označí konec sady výsledků dotazu a vrátí SqlPipe instanci zpět do počátečního stavu. |
| SendResultsRow(SqlDataRecord) |
Odešle jeden řádek dat zpět klientovi. |
| SendResultsStart(SqlDataRecord) |
Označí začátek sady výsledků dotazu, která má být odeslána zpět klientovi, a pomocí parametru záznamu vytvoří metadata, která popisují sadu výsledků. |