SqlFileStream Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uwidacznia dane programu SQL Server przechowywane za pomocą atrybutu kolumny FILESTREAM jako sekwencję bajtów.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Dziedziczenie
Uwagi
Klasa SqlFileStream służy do pracy z danymi przechowywanymi varbinary(max) z atrybutem FILESTREAM w bazie danych programu SQL Server 2008. Aby pracować z danymi FILESTREAM, należy zainstalować program .NET Framework 3.5 z dodatkiem SP1 (lub nowszym SqlFileStream ).
Określenie atrybutu FILESTREAM w varbinary(max) kolumnie powoduje, że program SQL Server będzie przechowywać dane w lokalnym systemie plików NTFS zamiast w pliku bazy danych. Transact-SQL instrukcje zapewniają możliwości manipulowania danymi na serwerze, a interfejsy systemu plików Win32 zapewniają dostęp strumieniowy do danych.
Note
Nie można otwierać pojedynczych plików przechowywanych w kolumnie FILESTREAM bezpośrednio z systemu plików NTFS. Przesyłanie strumieniowe danych FILESTREAM działa tylko w kontekście transakcji programu SQL Server.
Klasa SqlFileStream pochodzi z Stream klasy, która reprezentuje abstrakcję sekwencji bajtów z dowolnego źródła danych, takiego jak plik lub blok pamięci. Funkcję FILESTREAM można odczytać, przesyłając dane ze strumienia do struktury danych, takiej jak tablica bajtów. Możesz zapisać w strumieniu FILESTREAM, przesyłając dane ze struktury danych do strumienia. Można również wyszukiwać w strumieniu, co umożliwia wykonywanie zapytań i modyfikowanie danych w bieżącym położeniu w strumieniu.
Aby zapoznać się z dokumentacją koncepcyjną i przykładami kodu, zobacz FILESTREAM Data (Dane FILESTREAM).
Konstruktory
| Nazwa | Opis |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Inicjuje nowe wystąpienie klasy SqlFileStream. |
| SqlFileStream(String, Byte[], FileAccess) |
Inicjuje nowe wystąpienie klasy SqlFileStream. |
Właściwości
| Nazwa | Opis |
|---|---|
| CanRead |
Pobiera wartość wskazującą, czy bieżący strumień obsługuje odczyt. |
| CanSeek |
Pobiera wartość wskazującą, czy bieżący strumień obsługuje wyszukiwanie. |
| CanTimeout |
Pobiera wartość wskazującą, czy bieżący strumień może upłynął limit czasu. |
| CanWrite |
Pobiera wartość wskazującą, czy bieżący strumień obsługuje zapisywanie. |
| Length |
Pobiera wartość wskazującą długość bieżącego strumienia w bajtach. |
| Name |
Pobiera ścieżkę logiczną przekazanego SqlFileStream do konstruktora. |
| Position |
Pobiera lub ustawia położenie w bieżącym strumieniu. |
| ReadTimeout |
Pobiera lub ustawia wartość w milisekundach, która określa, jak długo strumień będzie próbował odczytać przed upływem limitu czasu. |
| TransactionContext |
Pobiera lub ustawia kontekst transakcji dla tego SqlFileStream obiektu. |
| WriteTimeout |
Pobiera lub ustawia wartość w milisekundach, która określa, jak długo strumień będzie próbował zapisać przed upływem limitu czasu. |
Metody
| Nazwa | Opis |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Rozpoczyna operację odczytu asynchronicznego. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Rozpoczyna asynchroniczną operację zapisu. |
| Close() |
Zamyka bieżący strumień i zwalnia wszystkie zasoby (takie jak gniazda i dojścia plików) skojarzone z bieżącym strumieniem. Zamiast wywoływać tę metodę, upewnij się, że strumień jest prawidłowo usuwany. (Odziedziczone po Stream) |
| CopyTo(Stream, Int32) |
Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu. Obie pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów. (Odziedziczone po Stream) |
| CopyTo(Stream) |
Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu. Obie pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów. (Odziedziczone po Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Asynchronicznie odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu i tokenu anulowania. Obie pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów. (Odziedziczone po Stream) |
| CopyToAsync(Stream, Int32) |
Asynchronicznie odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu. Obie pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów. (Odziedziczone po Stream) |
| CopyToAsync(Stream) |
Asynchronicznie odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu. Obie pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów. (Odziedziczone po Stream) |
| CreateObjRef(Type) |
Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject) |
| CreateWaitHandle() |
Przestarzałe.
Przestarzałe.
Przestarzałe.
WaitHandle Przydziela obiekt. (Odziedziczone po Stream) |
| Dispose() |
Zwalnia wszystkie zasoby używane przez program Stream. (Odziedziczone po Stream) |
| Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez Stream program i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po Stream) |
| EndRead(IAsyncResult) |
Czeka na ukończenie oczekującego odczytu asynchronicznego. |
| EndWrite(IAsyncResult) |
Kończy asynchroniczną operację zapisu. |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| Finalize() |
Zapewnia, że zasoby są zwalniane, a inne operacje oczyszczania są wykonywane, gdy moduł odśmiecający elementy bezużyteczne odzyska obiekt SqlFileStream. |
| Flush() |
czyści wszystkie bufory dla tego strumienia i powoduje zapisanie wszystkich buforowanych danych na urządzeniu źródłowym. |
| FlushAsync() |
Asynchronicznie czyści wszystkie bufory dla tego strumienia i powoduje zapisanie wszystkich buforowanych danych na urządzeniu bazowym. (Odziedziczone po Stream) |
| FlushAsync(CancellationToken) |
Asynchronicznie czyści wszystkie bufory dla tego strumienia, powoduje zapisanie wszystkich buforowanych danych na urządzeniu źródłowym i monitorowanie żądań anulowania. (Odziedziczone po Stream) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetLifetimeService() |
Przestarzałe.
Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
| ObjectInvariant() |
Przestarzałe.
Zapewnia obsługę elementu Contract. (Odziedziczone po Stream) |
| Read(Byte[], Int32, Int32) |
Odczytuje sekwencję bajtów z bieżącego strumienia i rozwija pozycję w strumieniu według liczby odczytanych bajtów. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchronicznie odczytuje sekwencję bajtów z bieżącego strumienia, rozwija pozycję w strumieniu według liczby odczytanych bajtów i monitoruje żądania anulowania. (Odziedziczone po Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Asynchronicznie odczytuje sekwencję bajtów z bieżącego strumienia i rozwija pozycję w strumieniu według liczby odczytanych bajtów. (Odziedziczone po Stream) |
| ReadByte() |
Odczytuje bajt ze strumienia i rozwija pozycję w strumieniu według jednego bajtu lub zwraca -1, jeśli na końcu strumienia. |
| Seek(Int64, SeekOrigin) |
Ustawia położenie w bieżącym strumieniu. |
| SetLength(Int64) |
Ustawia długość bieżącego strumienia. |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| Write(Byte[], Int32, Int32) |
Zapisuje sekwencję bajtów w bieżącym strumieniu i przechodzi bieżącą pozycję w tym strumieniu przez liczbę zapisanych bajtów. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchronicznie zapisuje sekwencję bajtów w bieżącym strumieniu, przechodzi bieżącą pozycję w tym strumieniu przez liczbę zapisanych bajtów i monitoruje żądania anulowania. (Odziedziczone po Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Asynchronicznie zapisuje sekwencję bajtów do bieżącego strumienia i przechodzi bieżącą pozycję w tym strumieniu przez liczbę zapisanych bajtów. (Odziedziczone po Stream) |
| WriteByte(Byte) |
Zapisuje bajt do bieżącej pozycji w strumieniu i rozwija pozycję w strumieniu według jednego bajtu. |
