CommandBehavior Enum

Definitie

Geeft een beschrijving van de resultaten van de query en het effect ervan op de database.

Deze opsomming ondersteunt een bitsgewijze combinatie van de waarden van de leden.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Overname
CommandBehavior
Kenmerken

Velden

Name Waarde Description
Default 0

De query kan meerdere resultatensets retourneren. De uitvoering van de query kan van invloed zijn op de databasestatus. Default stelt geen CommandBehavior vlaggen in, dus bellen ExecuteReader(CommandBehavior.Default) is functioneel gelijk aan het aanroepen ExecuteReader().

SingleResult 1

De query retourneert één resultatenset.

SchemaOnly 2

De query retourneert alleen kolomgegevens. Wanneer u SchemaOnly gebruikt, gaat de .NET Framework-Data Provider voor SQL Server vooraf aan de instructie die wordt uitgevoerd met SET FMTONLY ON.

KeyInfo 4

De query retourneert kolom- en primaire-sleutelgegevens. De provider voegt extra kolommen toe aan de resultatenset voor bestaande primaire sleutel- en tijdstempelkolommen.

SingleRow 8

De query retourneert naar verwachting één rij van de eerste resultatenset. De uitvoering van de query kan van invloed zijn op de databasestatus. Sommige .NET gegevensproviders kunnen deze informatie gebruiken om de prestaties van de opdracht te optimaliseren. Wanneer u SingleRow opgeeft met de methode ExecuteReader() van het object OleDbCommand, voert de .NET Framework-Data Provider voor OLE DB binding uit met behulp van de OLE DB-IRow-interface als deze beschikbaar is. Anders wordt de IRowset interface gebruikt. Als uw SQL-instructie naar verwachting slechts één rij retourneert SingleRow , kan het opgeven ook de prestaties van de toepassing verbeteren. Het is mogelijk om op te geven SingleRow bij het uitvoeren van query's die naar verwachting meerdere resultatensets retourneren. In dat geval, waarbij zowel een SQL-query met meerdere resultaten als één rij is opgegeven, bevat het geretourneerde resultaat alleen de eerste rij van de eerste resultatenset. De andere resultatensets van de query worden niet geretourneerd.

SequentialAccess 16

Biedt een manier voor het DataReader verwerken van rijen die kolommen met grote binaire waarden bevatten. In plaats van de hele rij te laden, SequentialAccess kunt u gegevens DataReader laden als een stroom. Vervolgens kunt u de GetBytes of GetChars methode gebruiken om een bytelocatie op te geven om de leesbewerking te starten en een beperkte buffergrootte voor de geretourneerde gegevens.

CloseConnection 32

Wanneer de opdracht wordt uitgevoerd, wordt het bijbehorende Connection object gesloten wanneer het bijbehorende DataReader object wordt gesloten.

Opmerkingen

Zie Aanvullende API-opmerkingen voor CommandBehavior voor meer informatie over deze API.

Van toepassing op