CommandBehavior Enum

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.Common.dll
Assembly's:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Bron:
CommandBehavior.cs
Bron:
CommandBehavior.cs
Bron:
DataColumn.cs

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
Object
ValueType
Enum
CommandBehavior
Kenmerken
FlagsAttribute

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

De CommandBehavior waarden worden gebruikt door de ExecuteReader methode van IDbCommand en eventuele implementatieklassen.

Een bitsgewijze combinatie van deze waarden kan worden gebruikt.

CommandBehavior wordt genegeerd wanneer deze wordt gebruikt om een SqlNotificationRequest of SqlDependency te definiëren en mag daarom niet worden gebruikt. Gebruik de constructor CommandBehavior die in deze twee gevallen geen parameter vereist.

Notities over afzonderlijke opsommingsleden

KeyInfoWanneer u .NET Framework-gegevensprovider voor SQL Server gebruikt, wordt de instructie voorafgegaan door SET FMTONLY OFF enSET NO_BROWSETABLE ON. Gebruikers moeten zich bewust zijn van mogelijke bijwerkingen, zoals interferentie met het gebruik van SET FMTONLY ON instructies. Zie SET FMTONLY (Transact-SQL)voor meer informatie.

Note

Hiermee SequentialAccess kunt u grote waarden en binaire gegevens ophalen. Anders kan er een OutOfMemoryException fout optreden en wordt de verbinding gesloten.

Wanneer u opgeeft SequentialAccess, moet u lezen uit de kolommen in de volgorde waarin ze worden geretourneerd, hoewel u niet elke kolom hoeft te lezen. Zodra u een locatie in de geretourneerde gegevensstroom hebt gelezen, kunnen gegevens op of voor die locatie niet meer worden gelezen uit de DataReader. Wanneer u de OleDbDataReader gebruikt, kunt u de huidige kolomwaarde opnieuw lezen totdat u er voorbij hebt gelezen. Wanneer u de SqlDataReaderkolomwaarde gebruikt, kunt u een kolomwaarde slechts één keer lezen.

Van toepassing op