DbBatch Osztály

Definíció

Névtér:

System.Data.Common

Szerelvény:

System.Data.Common.dll

Forrás:

DbBatch.cs

Olyan parancskötegeket jelöl, amelyek egyetlen menetben végrehajthatók egy adatforráson. Alaposztályt biztosít a parancskötegeket képviselő adatbázis-specifikus osztályokhoz.

public ref class DbBatch abstract : IAsyncDisposable, IDisposable

public abstract class DbBatch : IAsyncDisposable, IDisposable

type DbBatch = class
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable

Öröklődés

Object

DbBatch

Megvalósítás

IAsyncDisposable IDisposable

Megjegyzések

A kötegvégrehajtás pontos szemantikája az ADO.NET szolgáltatóktól eltérő, különösen a hibakezelés körül. Ha lehetséges, javasoljuk, hogy a kötegen belüli parancsok hibája azonnal leállítja a köteget, hagyja ki az összes további parancsot, és állítsa vissza a már végrehajtott parancsokat. Előfordulhat azonban, hogy ez a viselkedés nem támogatott az adatbázisokban; tekintse meg az ADO.NET szolgáltató dokumentációját.

Konstruktorok

Name	Description
DbBatch()	Inicializálja a DbBatch osztály új példányát.

Tulajdonságok

Name	Description
BatchCommands	Lekéri az objektumok gyűjteményét DbBatchCommand .
Connection	Lekéri vagy beállítja a DbConnection használt elemet.DbBatch
DbBatchCommands	Ha felül van bírálva egy származtatott osztályban, lekéri az objektumok gyűjteményét DbBatchCommand .
DbConnection	Ha felül van bírálva egy származtatott osztályban, lekéri vagy beállítja a DbConnection használt osztályt DbBatch.
DbTransaction	Ha egy származtatott osztályban felül van bírálva, lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbBatch alapjául szolgáló részt.
Timeout	Lekéri vagy beállítja a várakozási időt (másodpercben), mielőtt befejezi a köteg végrehajtására tett kísérletet, és hibát okozna.
Transaction	Lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbBatch alapjául szolgáló objektumot.

Metódusok

Name	Description
Cancel()	Megkísérli megszakítani a végrehajtást.DbBatch
CreateBatchCommand()	Új objektumpéldányt DbBatchCommand hoz létre.
CreateDbBatchCommand()	Ha felül van bírálva egy származtatott osztályban, egy objektum új példányát DbBatchCommand hozza létre.
Dispose()	Végrehajtja a nem felügyelt erőforrások felszabadításával, felszabadításával vagy alaphelyzetbe állításával kapcsolatos alkalmazásalapú feladatokat.
DisposeAsync()	Aszinkron módon megsemmisíti a kötegobjektumot.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExecuteDbDataReader(CommandBehavior)	Ha egy származtatott osztályban felül van bírálva, végrehajtja a köteget a kapcsolaton, és visszaad egy DbDataReader olyan értéket, amely az eredmények eléréséhez használható.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	A szolgáltatóknak ezt a módszert úgy kell implementálniuk, hogy a túlterhelések nem alapértelmezett implementációt biztosítsanak ExecuteReader . Az alapértelmezett implementáció meghívja a szinkron ExecuteReader() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteReader által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve. Ez a metódus elfogad egy lemondási jogkivonatot, amely a művelet korai törlésének igénylésére használható. A megvalósítások figyelmen kívül hagyhatják ezt a kérést.
ExecuteNonQuery()	Végrehajtja a köteget a kapcsolati objektumon, és visszaadja az összes kötegparancsban érintett sorok teljes számát.
ExecuteNonQueryAsync(CancellationToken)	Ez aszinkron verziója.ExecuteNonQuery() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat opcionálisan figyelmen kívül hagyható. Az alapértelmezett implementáció meghívja a szinkron ExecuteNonQuery() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. A rendszer ExecuteNonQuery() a visszaadott Tevékenységkivétel tulajdonságon keresztül közli a kivételeket. Ne hívja meg az DbCommand objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik.
ExecuteReader(CommandBehavior)	Végrehajtja a köteget a kapcsolaton, és visszaad egy DbDataReader olyan értéket, amely az eredmények eléréséhez használható.
ExecuteReaderAsync(CancellationToken)	A köteg aszinkron verziója ExecuteReader, amely a köteget a kapcsolaton keresztül hajtja végre, és visszaad egy DbDataReader olyan verziót, amely az eredmények eléréséhez használható.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	A köteg aszinkron verziója ExecuteReader, amely a köteget a kapcsolaton keresztül hajtja végre, és visszaad egy DbDataReader olyan verziót, amely az eredmények eléréséhez használható.
ExecuteScalar()	Végrehajtja a köteget, és az első visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt.
ExecuteScalarAsync(CancellationToken)	A köteget végrehajtó és az első visszaadott eredményhalmaz első sorának első oszlopát visszaadó aszinkron verziója ExecuteScalar(). A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Prepare()	Létrehozza a köteg vagy az egyes parancsok előkészített (vagy lefordított) verzióját az adatforráson.
PrepareAsync(CancellationToken)	Aszinkron módon létrehozza a köteg vagy az egyes parancsok előkészített (vagy lefordított) verzióját az adatforráson.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Bővítő metódusok

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Konfigurálja, hogy az aszinkron eldobható feladatok hogyan lesznek végrehajtva.