SqlFileStream 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í.
Zveřejňuje data SQL Serveru uložená s atributem sloupce FILESTREAM jako posloupnost bajtů.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Dědičnost
Poznámky
Třída SqlFileStream slouží k práci s daty uloženými varbinary(max) s atributem FILESTREAM v databázi SYSTÉMU SQL Server 2008. Abyste mohli pracovat SqlFileStream s daty FILESTREAM, musíte nainstalovat rozhraní .NET Framework 3.5 SP1 (nebo novější).
Zadání atributu FILESTREAM ve varbinary(max) sloupci způsobí, že SQL Server uloží data v místním systému souborů NTFS místo do souboru databáze. Transact-SQL příkazy poskytují možnosti manipulace s daty na serveru a rozhraní systému souborů Win32 poskytují přístup ke streamovaným datům.
Note
Jednotlivé soubory uložené ve sloupci FILESTREAM nelze otevřít přímo ze systému souborů NTFS. Streamovaná data FILESTREAM fungují pouze v kontextu transakce SQL Serveru.
Třída SqlFileStream je odvozena od Stream třídy, která představuje abstrakci posloupnosti bajtů z některého libovolného zdroje dat, jako je soubor nebo blok paměti. Ze FILESTREAMu můžete číst přenosem dat z datového proudu do datové struktury, jako je například pole bajtů. Do FILESTREAM můžete zapisovat přenosem dat z datové struktury do datového proudu. Můžete také hledat v rámci datového proudu, který umožňuje dotazovat a upravovat data na aktuální pozici v rámci datového proudu.
Koncepční dokumentaci a příklady kódu najdete v tématu FILESTREAM Data.
Konstruktory
| Name | Description |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Inicializuje novou instanci SqlFileStream třídy. |
| SqlFileStream(String, Byte[], FileAccess) |
Inicializuje novou instanci SqlFileStream třídy. |
Vlastnosti
| Name | Description |
|---|---|
| CanRead |
Získá hodnotu určující, zda aktuální datový proud podporuje čtení. |
| CanSeek |
Získá hodnotu určující, zda aktuální datový proud podporuje hledání. |
| CanTimeout |
Získá hodnotu označující, zda aktuální datový proud může časový limit vypršel. |
| CanWrite |
Získá hodnotu určující, zda aktuální datový proud podporuje zápis. |
| Length |
Získá hodnotu označující délku aktuálního datového proudu v bajtech. |
| Name |
Získá logickou cestu předaného SqlFileStream konstruktoru. |
| Position |
Získá nebo nastaví pozici v aktuálním datovém proudu. |
| ReadTimeout |
Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud pokusí přečíst před uplynutím časového limitu. |
| TransactionContext |
Získá nebo nastaví kontext transakce pro tento SqlFileStream objekt. |
| WriteTimeout |
Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud pokusí zapsat před uplynutím časového limitu. |
Metody
| Name | Description |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Zahájí asynchronní operaci čtení. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Zahájí asynchronní operaci zápisu. |
| Close() |
Zavře aktuální datový proud a uvolní všechny prostředky (například sokety a popisovače souborů) přidružené k aktuálnímu datovému proudu. Místo volání této metody se ujistěte, že je datový proud správně uvolněn. (Zděděno od Stream) |
| CopyTo(Stream, Int32) |
Načte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti. Obě pozice datových proudů jsou rozšířeny počtem bajtů zkopírovaných. (Zděděno od Stream) |
| CopyTo(Stream) |
Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu. Obě pozice datových proudů jsou rozšířeny počtem bajtů zkopírovaných. (Zděděno od Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti a tokenu zrušení. Obě pozice datových proudů jsou rozšířeny počtem bajtů zkopírovaných. (Zděděno od Stream) |
| CopyToAsync(Stream, Int32) |
Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti. Obě pozice datových proudů jsou rozšířeny počtem bajtů zkopírovaných. (Zděděno od Stream) |
| CopyToAsync(Stream) |
Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu. Obě pozice datových proudů jsou rozšířeny počtem bajtů zkopírovaných. (Zděděno od Stream) |
| CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
| CreateWaitHandle() |
Zastaralé.
Zastaralé.
Zastaralé.
WaitHandle Přidělí objekt. (Zděděno od Stream) |
| Dispose() |
Uvolní všechny prostředky používané nástrojem Stream. (Zděděno od Stream) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané Stream a volitelně uvolní spravované prostředky. (Zděděno od Stream) |
| EndRead(IAsyncResult) |
Čeká na dokončení čekajícího asynchronního čtení. |
| EndWrite(IAsyncResult) |
Ukončí asynchronní operaci zápisu. |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| Finalize() |
Zajišťuje, že prostředky jsou uvolněny a další operace čištění se provádějí, když uvolňování paměti uvolní SqlFileStream. |
| Flush() |
vymaže všechny vyrovnávací paměti pro tento datový proud a způsobí zápis všech uložených dat do vyrovnávací paměti do podkladového zařízení. |
| FlushAsync() |
Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud a způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení. (Zděděno od Stream) |
| FlushAsync(CancellationToken) |
Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud, způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení a monitoruje žádosti o zrušení. (Zděděno od Stream) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetLifetimeService() |
Zastaralé.
Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
| ObjectInvariant() |
Zastaralé.
Poskytuje podporu pro .Contract (Zděděno od Stream) |
| Read(Byte[], Int32, Int32) |
Přečte posloupnost bajtů z aktuálního datového proudu a posune pozici v datovém proudu o počet přečtených bajtů. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchronně přečte posloupnost bajtů z aktuálního datového proudu, posune pozici v datovém proudu o počet přečtených bajtů a monitoruje žádosti o zrušení. (Zděděno od Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Asynchronně čte posloupnost bajtů z aktuálního datového proudu a posune pozici v datovém proudu o počet přečtených bajtů. (Zděděno od Stream) |
| ReadByte() |
Přečte bajt ze streamu a posune pozici v rámci datového proudu o jeden bajt nebo vrátí -1, pokud je na konci datového proudu. |
| Seek(Int64, SeekOrigin) |
Nastaví pozici v aktuálním datovém proudu. |
| SetLength(Int64) |
Nastaví délku aktuálního datového proudu. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| Write(Byte[], Int32, Int32) |
Zapíše posloupnost bajtů do aktuálního datového proudu a posune aktuální pozici v tomto datovém proudu o počet zapsaných bajtů. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchronně zapíše posloupnost bajtů do aktuálního datového proudu, posune aktuální pozici v tomto datovém proudu o počet zapsaných bajtů a monitoruje žádosti o zrušení. (Zděděno od Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Asynchronně zapíše posloupnost bajtů do aktuálního datového proudu a posune aktuální pozici v tomto datovém proudu o počet zapsaných bajtů. (Zděděno od Stream) |
| WriteByte(Byte) |
Zapíše bajt na aktuální pozici v datovém proudu a posune pozici v rámci datového proudu o jeden bajt. |
