SqlFileStream Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Exponerar SQL Server data som lagras med kolumnattributet FILESTREAM som en sekvens med byte.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Arv
Kommentarer
Klassen SqlFileStream används för att arbeta med varbinary(max) data som lagras med attributet FILESTREAM i en SQL Server 2008-databas. Du måste installera .NET Framework 3.5 SP1 (eller senare) för att använda SqlFileStream för att arbeta med FILESTREAM-data.
Om du anger attributet FILESTREAM på en varbinary(max)-kolumn kan SQL Server lagra data i det lokala NTFS-filsystemet i stället för i databasfilen. Transact-SQL-instruktioner ger funktioner för datamanipulering på servern, och Win32-filsystemgränssnitt ger direktuppspelningsåtkomst till data.
Anmärkning
Enskilda filer som lagras i en FILESTREAM-kolumn kan inte öppnas direkt från NTFS-filsystemet. Strömmande FILESTREAM-data fungerar bara i kontexten för en SQL Server transaktion.
Klassen SqlFileStream härleds från Stream klassen, som representerar en abstraktion av en sekvens med byte från någon godtycklig datakälla, till exempel en fil eller ett minnesblock. Du kan läsa från en FILESTREAM genom att överföra data från en dataström till en datastruktur, till exempel en matris med byte. Du kan skriva till en FILESTREAM genom att överföra data från en datastruktur till en dataström. Du kan också söka i strömmen, vilket gör att du kan köra frågor mot och ändra data på den aktuella positionen i strömmen.
Konceptuell dokumentation och kodexempel finns i FILESTREAM-data.
Dokumentation om hur du konfigurerar FILESTREAM-data på SQL Server finns i Designa och implementera FILESTREAM Storage i SQL Server 2008 Books Online.
Konstruktorer
| Name | Description |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Initierar en ny instans av SqlFileStream klassen. |
| SqlFileStream(String, Byte[], FileAccess) |
Initierar en ny instans av SqlFileStream klassen. |
Egenskaper
| Name | Description |
|---|---|
| CanRead |
Hämtar ett värde som anger om den aktuella strömmen stöder läsning. |
| CanSeek |
Hämtar ett värde som anger om den aktuella strömmen stöder sökning. |
| CanTimeout |
Hämtar ett värde som anger om den aktuella strömmen kan överskrida tidsgränsen. |
| CanWrite |
Hämtar ett värde som anger om den aktuella strömmen stöder skrivning. |
| Length |
Hämtar ett värde som anger längden på den aktuella strömmen i byte. |
| Name |
Hämtar den logiska sökvägen för den SqlFileStream som skickas till konstruktorn. |
| Position |
Hämtar eller anger positionen i den aktuella strömmen. |
| ReadTimeout |
Hämtar eller anger ett värde i millisekunder som avgör hur länge strömmen ska försöka läsa innan tidsgränsen nås. |
| TransactionContext |
Hämtar eller anger transaktionskontexten för det här SqlFileStream objektet. |
| WriteTimeout |
Hämtar eller anger ett värde i millisekunder som avgör hur länge strömmen ska försöka skriva innan tidsgränsen nås. |
Metoder
| Name | Description |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Påbörjar en asynkron läsåtgärd. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Påbörjar en asynkron skrivåtgärd. |
| Close() |
Stänger den aktuella strömmen och släpper alla resurser (till exempel socketar och filhandtag) som är associerade med den aktuella strömmen. I stället för att anropa den här metoden kontrollerar du att dataströmmen tas bort korrekt. (Ärvd från Stream) |
| CopyTo(Stream, Int32) |
Läser byteen från den aktuella strömmen och skriver dem till en annan ström med en angiven buffertstorlek. Båda strömmarnas positioner avanceras av antalet kopierade byte. (Ärvd från Stream) |
| CopyTo(Stream) |
Läser byteen från den aktuella strömmen och skriver dem till en annan ström. Båda strömmarnas positioner avanceras av antalet kopierade byte. (Ärvd från Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Läser asynkront byte från den aktuella strömmen och skriver dem till en annan dataström med en angiven buffertstorlek och annulleringstoken. Båda strömmarnas positioner avanceras av antalet kopierade byte. (Ärvd från Stream) |
| CopyToAsync(Stream, Int32) |
Läser asynkront byte från den aktuella strömmen och skriver dem till en annan ström med en angiven buffertstorlek. Båda strömmarnas positioner avanceras av antalet kopierade byte. (Ärvd från Stream) |
| CopyToAsync(Stream) |
Läser asynkront byte från den aktuella strömmen och skriver dem till en annan ström. Båda strömmarnas positioner avanceras av antalet kopierade byte. (Ärvd från Stream) |
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| CreateWaitHandle() |
Föråldrad.
Allokerar ett WaitHandle objekt. (Ärvd från Stream) |
| Dispose() |
Släpper alla resurser som används av Stream. (Ärvd från Stream) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av Stream och släpper eventuellt de hanterade resurserna. (Ärvd från Stream) |
| EndRead(IAsyncResult) |
Väntar på att den väntande asynkrona läsningen ska slutföras. |
| EndWrite(IAsyncResult) |
Avslutar en asynkron skrivåtgärd. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| Finalize() |
Säkerställer att resurser frigörs och att andra rensningsåtgärder utförs när skräpinsamlaren SqlFileStreamåtertar . |
| Flush() |
rensar alla buffertar för den här strömmen och gör att buffrade data skrivs till den underliggande enheten. |
| FlushAsync() |
Rensar asynkront alla buffertar för den här strömmen och gör att buffrade data skrivs till den underliggande enheten. (Ärvd från Stream) |
| FlushAsync(CancellationToken) |
Rensar asynkront alla buffertar för den här strömmen, gör att buffrade data skrivs till den underliggande enheten och övervakar begäranden om annullering. (Ärvd från Stream) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetLifetimeService() |
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| InitializeLifetimeService() |
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| ObjectInvariant() |
Föråldrad.
Tillhandahåller stöd för en Contract. (Ärvd från Stream) |
| Read(Byte[], Int32, Int32) |
Läser en sekvens med byte från den aktuella dataströmmen och flyttar positionen inom dataströmmen med antalet lästa byte. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Läser asynkront en sekvens med byte från den aktuella strömmen, avancerar positionen i strömmen med antalet lästa byte och övervakar begäranden om annullering. (Ärvd från Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Läser asynkront en sekvens med byte från den aktuella strömmen och avancerar positionen i strömmen med antalet lästa byte. (Ärvd från Stream) |
| ReadByte() |
Läser en byte från strömmen och flyttar positionen i strömmen med en byte, eller returnerar -1 om i slutet av strömmen. |
| Seek(Int64, SeekOrigin) |
Anger positionen i den aktuella strömmen. |
| SetLength(Int64) |
Anger längden på den aktuella strömmen. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| Write(Byte[], Int32, Int32) |
Skriver en sekvens med byte till den aktuella strömmen och avancerar den aktuella positionen i den här strömmen med antalet skrivna byte. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Skriver asynkront en sekvens med byte till den aktuella strömmen, avancerar den aktuella positionen i den här strömmen med antalet skrivna byte och övervakar begäranden om annullering. (Ärvd från Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Skriver asynkront en sekvens med byte till den aktuella strömmen och avancerar den aktuella positionen i den här strömmen med antalet skrivna byte. (Ärvd från Stream) |
| WriteByte(Byte) |
Skriver en byte till den aktuella positionen i strömmen och flyttar positionen inom strömmen med en byte. |