SqlFileStream Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Maakt SQL Server gegevens beschikbaar die zijn opgeslagen met het kenmerk FILESTREAM-kolom als een reeks bytes.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Overname
Opmerkingen
De klasse SqlFileStream wordt gebruikt om te werken met varbinary(max) gegevens die zijn opgeslagen met het kenmerk FILESTREAM in een SQL Server 2008-database. U moet het .NET Framework 3.5 SP1 (of hoger) installeren om SqlFileStream te gebruiken om met FILESTREAM-gegevens te werken.
Als u het kenmerk FILESTREAM opgeeft op een varbinary(max) kolom, worden de gegevens SQL Server opgeslagen in het lokale NTFS-bestandssysteem in plaats van in het databasebestand. Transact-SQL instructies bieden mogelijkheden voor gegevensmanipulatie binnen de server en win32-bestandssysteeminterfaces bieden streamingtoegang tot de gegevens.
Note
Afzonderlijke bestanden die zijn opgeslagen in een FILESTREAM-kolom kunnen niet rechtstreeks vanuit het NTFS-bestandssysteem worden geopend. Het streamen van FILESTREAM-gegevens werkt alleen in de context van een SQL Server transactie.
De SqlFileStream klasse is afgeleid van de Stream klasse, die een abstractie van een reeks bytes vertegenwoordigt van een willekeurige gegevensbron, zoals een bestand of een blok geheugen. U kunt lezen vanuit een FILESTREAM door gegevens uit een stroom over te dragen naar een gegevensstructuur, zoals een matrix van bytes. U kunt naar een FILESTREAM schrijven door de gegevens uit een gegevensstructuur over te dragen naar een stroom. U kunt ook zoeken in de stroom, zodat u gegevens op de huidige positie in de stream kunt opvragen en wijzigen.
Zie FILESTREAM Data voor conceptuele documentatie en codevoorbeelden.
Zie Designing and Implementing FILESTREAM Storage in SQL Server 2008 Books Online voor documentatie over het instellen en configureren van FILESTREAM-SQL Server gegevens in SQL Server 2008.
Constructors
| Name | Description |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Initialiseert een nieuw exemplaar van de SqlFileStream klasse. |
| SqlFileStream(String, Byte[], FileAccess) |
Initialiseert een nieuw exemplaar van de SqlFileStream klasse. |
Eigenschappen
| Name | Description |
|---|---|
| CanRead |
Hiermee wordt een waarde opgehaald die aangeeft of de huidige stroom het lezen ondersteunt. |
| CanSeek |
Hiermee wordt een waarde opgehaald die aangeeft of de huidige stroom zoeken ondersteunt. |
| CanTimeout |
Hiermee wordt een waarde opgehaald die aangeeft of er een time-out optreedt voor de huidige stroom. |
| CanWrite |
Hiermee wordt een waarde opgehaald die aangeeft of de huidige stroom schrijfkracht ondersteunt. |
| Length |
Hiermee wordt een waarde opgehaald die de lengte van de huidige stroom in bytes aangeeft. |
| Name |
Hiermee haalt u het logische pad op van het SqlFileStream doorgegeven aan de constructor. |
| Position |
Hiermee haalt u de positie in de huidige stroom op of stelt u deze in. |
| ReadTimeout |
Hiermee wordt een waarde opgehaald of ingesteld, in milliseconden, die bepaalt hoe lang de stroom probeert te lezen voordat er een time-out optreedt. |
| TransactionContext |
Hiermee wordt de transactiecontext voor dit SqlFileStream object opgehaald of ingesteld. |
| WriteTimeout |
Hiermee wordt een waarde opgehaald of ingesteld, in milliseconden, die bepaalt hoe lang de stream probeert te schrijven voordat er een time-out optreedt. |
Methoden
| Name | Description |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Begint een asynchrone leesbewerking. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Hiermee wordt een asynchrone schrijfbewerking gestart. |
| Close() |
Hiermee sluit u de huidige stroom en worden alle resources (zoals sockets en bestandsingangen) die aan de huidige stroom zijn gekoppeld, vrijgegeven. In plaats van deze methode aan te roepen, moet u ervoor zorgen dat de stream correct wordt verwijderd. (Overgenomen van Stream) |
| CopyTo(Stream, Int32) |
Leest de bytes uit de huidige stream en schrijft ze naar een andere stroom, met behulp van een opgegeven buffergrootte. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyTo(Stream) |
Leest de bytes uit de huidige stream en schrijft ze naar een andere stream. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Asynchroon leest de bytes uit de huidige stream en schrijft deze naar een andere stroom, met behulp van een opgegeven buffergrootte en annuleringstoken. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream, Int32) |
Asynchroon leest de bytes uit de huidige stream en schrijft deze naar een andere stroom, met behulp van een opgegeven buffergrootte. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream) |
Asynchroon leest de bytes uit de huidige stream en schrijft ze naar een andere stream. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| CreateWaitHandle() |
Verouderd.
Wijst een WaitHandle object toe. (Overgenomen van Stream) |
| Dispose() |
Alle resources die worden gebruikt door de Stream. (Overgenomen van Stream) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de Stream beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Stream) |
| EndRead(IAsyncResult) |
Wacht totdat de asynchrone leesbewerking is voltooid. |
| EndWrite(IAsyncResult) |
Hiermee wordt een asynchrone schrijfbewerking beëindigd. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| Finalize() |
Zorgt ervoor dat resources worden vrijgemaakt en andere opschoonbewerkingen worden uitgevoerd wanneer de garbagecollector de SqlFileStream. |
| Flush() |
wist alle buffers voor deze stroom en zorgt ervoor dat eventuele gebufferde gegevens naar het onderliggende apparaat worden geschreven. |
| FlushAsync() |
Asynchroon wist alle buffers voor deze stroom en zorgt ervoor dat eventuele gebufferde gegevens naar het onderliggende apparaat worden geschreven. (Overgenomen van Stream) |
| FlushAsync(CancellationToken) |
Asynchroon wist alle buffers voor deze stroom, zorgt ervoor dat gebufferde gegevens naar het onderliggende apparaat worden geschreven en annuleringsaanvragen worden gecontroleerd. (Overgenomen van Stream) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetLifetimeService() |
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| InitializeLifetimeService() |
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| ObjectInvariant() |
Verouderd.
Biedt ondersteuning voor een Contract. (Overgenomen van Stream) |
| Read(Byte[], Int32, Int32) |
Hiermee wordt een reeks bytes uit de huidige stroom gelezen en wordt de positie binnen de stream verplaatst door het aantal bytes dat is gelezen. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchroon leest een reeks bytes uit de huidige stroom, verplaatst de positie binnen de stream door het aantal gelezen bytes en bewaakt annuleringsaanvragen. (Overgenomen van Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Asynchroon leest een reeks bytes uit de huidige stroom en wordt de positie binnen de stream verplaatst door het aantal gelezen bytes. (Overgenomen van Stream) |
| ReadByte() |
Hiermee leest u een byte uit de stroom en wordt de positie binnen de stream met één byte vooruit gelezen of wordt -1 geretourneerd als aan het einde van de stream. |
| Seek(Int64, SeekOrigin) |
Hiermee stelt u de positie in de huidige stroom in. |
| SetLength(Int64) |
Hiermee stelt u de lengte van de huidige stroom in. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| Write(Byte[], Int32, Int32) |
Hiermee schrijft u een reeks bytes naar de huidige stroom en wordt de huidige positie binnen deze stroom verplaatst door het aantal geschreven bytes. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchroon schrijft een reeks bytes naar de huidige stroom, verplaatst de huidige positie binnen deze stream door het aantal geschreven bytes en bewaakt annuleringsaanvragen. (Overgenomen van Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Asynchroon schrijft een reeks bytes naar de huidige stroom en wordt de huidige positie binnen deze stroom verplaatst door het aantal geschreven bytes. (Overgenomen van Stream) |
| WriteByte(Byte) |
Hiermee schrijft u een byte naar de huidige positie in de stroom en wordt de positie binnen de stream met één byte vooruit. |