SqlFileStream Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A FILESTREAM oszlopattribútummal tárolt SQL Server adatokat teszi elérhetővé bájtok sorozataként.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Öröklődés
Megjegyzések
A SqlFileStream osztály az varbinary(max) SQL Server adatbázis FILESTREAM attribútumával tárolt adatok kezelésére szolgál. Telepítenie kell a .NET Framework 3.5 SP1 -et (vagy újabb verziót) a SqlFileStream használatához a FILESTREAM-adatok használatához.
A FILESTREAM attribútum megadása egy varbinary(max) oszlopban SQL Server az adatokat a helyi NTFS fájlrendszerben, nem pedig az adatbázisfájlban tárolja. Transact-SQL utasítások adatmanipulációs képességeket biztosítanak a kiszolgálón, a Win32 fájlrendszer felületei pedig streamelési hozzáférést biztosítanak az adatokhoz.
Note
A FILESTREAM oszlopban tárolt egyes fájlok nem nyithatóak meg közvetlenül az NTFS fájlrendszerből. A FILESTREAM-adatok streamelése csak egy SQL Server tranzakció kontextusában működik.
Az SqlFileStream osztály az Stream osztályból származik, amely egy bájtsorozat absztrakcióját jelenti valamilyen tetszőleges adatforrásból, például egy fájlból vagy egy memóriablokkból. A FILESTREAMből úgy olvashat, hogy adatokat továbbít egy adatfolyamból egy adatstruktúrába, például bájtokból álló tömbbe. A FILESTREAMbe úgy írhat, hogy az adatokat egy adatstruktúrából streambe alakítja át. A streamen belül is kereshet, amely lehetővé teszi az adatok lekérdezését és módosítását a stream aktuális helyén.
Elméleti dokumentációt és kód példákat a FILESTREAM-adatok című témakörben talál.
A FILESTREAM-adatok SQL Server való beállításával és konfigurálásával kapcsolatos dokumentációt a 2008-SQL Server Books Online SQL Server Designing and Implementing FILESTREAM Storage című témakörben találja.
Konstruktorok
| Name | Description |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Inicializálja a SqlFileStream osztály új példányát. |
| SqlFileStream(String, Byte[], FileAccess) |
Inicializálja a SqlFileStream osztály új példányát. |
Tulajdonságok
| Name | Description |
|---|---|
| CanRead |
Egy értéket kap, amely jelzi, hogy az aktuális stream támogatja-e az olvasást. |
| CanSeek |
Egy értéket kap, amely jelzi, hogy az aktuális stream támogatja-e a keresést. |
| CanTimeout |
Egy értéket kap, amely jelzi, hogy az aktuális stream időtúllépést okozhat-e. |
| CanWrite |
Egy értéket kap, amely jelzi, hogy az aktuális stream támogatja-e az írást. |
| Length |
Lekéri az aktuális stream hosszát bájtban jelző értéket. |
| Name |
Lekéri az átadott logikai útvonalat SqlFileStream a konstruktornak. |
| Position |
Lekéri vagy beállítja az aktuális streamen belüli pozíciót. |
| ReadTimeout |
Ezredmásodpercben lekéri vagy beállítja azt az értéket, amely meghatározza, hogy a stream mennyi ideig kísérel meg olvasni, mielőtt túllépi az időkorlátot. |
| TransactionContext |
Lekéri vagy beállítja az objektum tranzakciós környezetét SqlFileStream . |
| WriteTimeout |
Ezredmásodpercben lekéri vagy beállít egy értéket, amely meghatározza, hogy a stream mennyi ideig kísérel meg írni, mielőtt időtúllépést végezne. |
Metódusok
| Name | Description |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Aszinkron olvasási műveletet kezd. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Aszinkron írási műveletet kezd. |
| Close() |
Bezárja az aktuális streamet, és felszabadítja az aktuális adatfolyamhoz társított összes erőforrást (például szoftvercsatornákat és fájlfogópontokat). A metódus meghívása helyett győződjön meg arról, hogy a stream megfelelően van elosztva. (Öröklődés forrása Stream) |
| CopyTo(Stream, Int32) |
Beolvassa a bájtokat az aktuális streamből, és egy megadott pufferméret használatával egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream) |
| CopyTo(Stream) |
Beolvassa a bájtokat az aktuális streamből, és egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Aszinkron módon beolvassa a bájtokat az aktuális streamből, és egy megadott pufferméret és lemondási jogkivonat használatával egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream) |
| CopyToAsync(Stream, Int32) |
Aszinkron módon beolvassa a bájtokat az aktuális adatfolyamból, és egy megadott puffermérettel egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream) |
| CopyToAsync(Stream) |
Aszinkron módon beolvassa a bájtokat az aktuális streamből, és egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream) |
| CreateObjRef(Type) |
Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject) |
| CreateWaitHandle() |
Elavult.
Elavult.
Elavult.
Objektum lefoglalása WaitHandle . (Öröklődés forrása Stream) |
| Dispose() |
Felszabadítja a .-hez használt összes erőforrást Stream. (Öröklődés forrása Stream) |
| Dispose(Boolean) |
Felszabadítja a felügyelt erőforrások által Stream használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása Stream) |
| EndRead(IAsyncResult) |
Megvárja, amíg a függőben lévő aszinkron olvasás befejeződik. |
| EndWrite(IAsyncResult) |
Aszinkron írási művelet befejezése. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| Finalize() |
Biztosítja, hogy az erőforrások felszabadítva legyenek, és más tisztítási műveletek is végrehajtva legyenek, amikor a szemétgyűjtő visszanyeri a SqlFileStream. |
| Flush() |
Törli a stream összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja. |
| FlushAsync() |
Aszinkron módon törli az adatfolyam összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja. (Öröklődés forrása Stream) |
| FlushAsync(CancellationToken) |
Aszinkron módon törli a stream összes pufferét, a pufferelt adatokat az alapul szolgáló eszközre írja, és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetLifetimeService() |
Elavult.
Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| InitializeLifetimeService() |
Elavult.
Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| MemberwiseClone(Boolean) |
Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject) |
| ObjectInvariant() |
Elavult.
Támogatja a Contract. (Öröklődés forrása Stream) |
| Read(Byte[], Int32, Int32) |
Beolvassa az aktuális streamből származó bájtok sorozatát, és az olvasási bájtok számával előrelépteti a streamen belüli pozíciót. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Aszinkron módon beolvassa a bájtok sorozatát az aktuális adatfolyamból, az olvasási bájtok számával előrelép a streamben, és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Aszinkron módon beolvassa az aktuális adatfolyamból származó bájtok sorozatát, és az olvasási bájtok számával előrelépteti a streamen belüli pozíciót. (Öröklődés forrása Stream) |
| ReadByte() |
Beolvassa a bájtot a streamből, és egy bájttal előrelép a streamben, vagy -1 ad vissza, ha a stream végén van. |
| Seek(Int64, SeekOrigin) |
Beállítja az aktuális streamen belüli pozíciót. |
| SetLength(Int64) |
Az aktuális stream hosszát állítja be. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| Write(Byte[], Int32, Int32) |
Bájtok sorozatát írja az aktuális adatfolyamba, és a megírt bájtok számával előrelép a stream aktuális pozícióján. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Aszinkron módon bájtok sorozatát írja az aktuális streambe, az aktuális pozíciót a streamen belül a megírt bájtok számával lépteti előre, és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Aszinkron módon bájtok sorozatát írja az aktuális adatfolyamba, és a megírt bájtok számával előrelépteti a stream aktuális pozícióját. (Öröklődés forrása Stream) |
| WriteByte(Byte) |
Bájtot ír a stream aktuális helyére, és egy bájttal előrelépteti a streamen belüli pozíciót. |
