SqlFileStream Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Espone i dati di SQL Server archiviati con l'attributo di colonna FILESTREAM come sequenza di byte.
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- Ereditarietà
Commenti
La SqlFileStream classe viene usata per lavorare con varbinary(max) i dati archiviati con l'attributo FILESTREAM in un database di SQL Server 2008. Per usare SqlFileStream i dati FILESTREAM, è necessario installare .NET Framework 3.5 SP1 (o versione successiva).
Se si specifica l'attributo FILESTREAM in una varbinary(max) colonna, SQL Server archivia i dati nel file system NTFS locale anziché nel file di database. Transact-SQL istruzioni forniscono funzionalità di manipolazione dei dati all'interno del server e le interfacce del file system Win32 forniscono l'accesso in streaming ai dati.
Annotazioni
I singoli file archiviati in una colonna FILESTREAM non possono essere aperti direttamente dal file system NTFS. Il flusso di dati FILESTREAM funziona solo nel contesto di una transazione di SQL Server.
La SqlFileStream classe è derivata dalla Stream classe , che rappresenta un'astrazione di una sequenza di byte da un'origine dati arbitraria, ad esempio un file o un blocco di memoria. È possibile leggere da un fileSTREAM trasferendo i dati da un flusso in una struttura di dati, ad esempio una matrice di byte. È possibile scrivere in un fileSTREAM trasferendo i dati da una struttura di dati in un flusso. È anche possibile cercare all'interno del flusso, che consente di eseguire query e modificare i dati nella posizione corrente all'interno del flusso.
Per la documentazione concettuale e gli esempi di codice, vedere Dati FILESTREAM.
Costruttori
| Nome | Descrizione |
|---|---|
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Inizializza una nuova istanza della classe SqlFileStream. |
| SqlFileStream(String, Byte[], FileAccess) |
Inizializza una nuova istanza della classe SqlFileStream. |
Proprietà
| Nome | Descrizione |
|---|---|
| CanRead |
Ottiene un valore che indica se il flusso corrente supporta la lettura. |
| CanSeek |
Ottiene un valore che indica se il flusso corrente supporta la ricerca. |
| CanTimeout |
Ottiene un valore che indica se il flusso corrente può scadere. |
| CanWrite |
Ottiene un valore che indica se il flusso corrente supporta la scrittura. |
| Length |
Ottiene un valore che indica la lunghezza del flusso corrente in byte. |
| Name |
Ottiene il percorso logico dell'oggetto SqlFileStream passato al costruttore. |
| Position |
Ottiene o imposta la posizione all'interno del flusso corrente. |
| ReadTimeout |
Ottiene o imposta un valore, espresso in millisecondi, che determina per quanto tempo il flusso tenterà di leggere prima del timeout. |
| TransactionContext |
Ottiene o imposta il contesto della transazione per questo SqlFileStream oggetto. |
| WriteTimeout |
Ottiene o imposta un valore, espresso in millisecondi, che determina per quanto tempo il flusso tenterà di scrivere prima del timeout. |
Metodi
| Nome | Descrizione |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Avvia un'operazione di lettura asincrona. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Avvia un'operazione di scrittura asincrona. |
| Close() |
Chiude il flusso corrente e rilascia tutte le risorse (ad esempio socket e handle di file) associate al flusso corrente. Invece di chiamare questo metodo, assicurarsi che il flusso sia eliminato correttamente. (Ereditato da Stream) |
| CopyTo(Stream, Int32) |
Legge i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione del buffer specificata. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati. (Ereditato da Stream) |
| CopyTo(Stream) |
Legge i byte dal flusso corrente e li scrive in un altro flusso. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati. (Ereditato da Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Legge in modo asincrono i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione del buffer e un token di annullamento specificati. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati. (Ereditato da Stream) |
| CopyToAsync(Stream, Int32) |
Legge in modo asincrono i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione del buffer specificata. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati. (Ereditato da Stream) |
| CopyToAsync(Stream) |
Legge in modo asincrono i byte dal flusso corrente e li scrive in un altro flusso. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati. (Ereditato da Stream) |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| CreateWaitHandle() |
Obsoleti.
Obsoleti.
Obsoleti.
Alloca un WaitHandle oggetto . (Ereditato da Stream) |
| Dispose() |
Rilascia tutte le risorse usate da Stream. (Ereditato da Stream) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da Stream e, facoltativamente, rilascia le risorse gestite. (Ereditato da Stream) |
| EndRead(IAsyncResult) |
Attende il completamento della lettura asincrona in sospeso. |
| EndWrite(IAsyncResult) |
Termina un'operazione di scrittura asincrona. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Finalize() |
Assicura che le risorse vengano liberate e che vengano eseguite altre operazioni di pulizia quando il Garbage Collector recupera .SqlFileStream |
| Flush() |
cancella tutti i buffer per questo flusso e fa sì che tutti i dati memorizzati nel buffer vengano scritti nel dispositivo sottostante. |
| FlushAsync() |
Cancella in modo asincrono tutti i buffer per questo flusso e determina la scrittura di tutti i dati memorizzati nel buffer nel dispositivo sottostante. (Ereditato da Stream) |
| FlushAsync(CancellationToken) |
Cancella in modo asincrono tutti i buffer per questo flusso, determina la scrittura di tutti i dati memorizzati nel buffer nel dispositivo sottostante e monitora le richieste di annullamento. (Ereditato da Stream) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ObjectInvariant() |
Obsoleti.
Fornisce il supporto per un oggetto Contract. (Ereditato da Stream) |
| Read(Byte[], Int32, Int32) |
Legge una sequenza di byte dal flusso corrente e sposta in avanti la posizione all'interno del flusso in base al numero di byte letti. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Legge in modo asincrono una sequenza di byte dal flusso corrente, sposta in avanti la posizione all'interno del flusso in base al numero di byte letti e monitora le richieste di annullamento. (Ereditato da Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Legge in modo asincrono una sequenza di byte dal flusso corrente e sposta in avanti la posizione all'interno del flusso in base al numero di byte letti. (Ereditato da Stream) |
| ReadByte() |
Legge un byte dal flusso e sposta in avanti la posizione all'interno del flusso di un byte oppure restituisce -1 se alla fine del flusso. |
| Seek(Int64, SeekOrigin) |
Imposta la posizione all'interno del flusso corrente. |
| SetLength(Int64) |
Imposta la lunghezza del flusso corrente. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Write(Byte[], Int32, Int32) |
Scrive una sequenza di byte nel flusso corrente e sposta in avanti la posizione corrente all'interno del flusso in base al numero di byte scritti. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Scrive in modo asincrono una sequenza di byte nel flusso corrente, sposta in avanti la posizione corrente all'interno del flusso in base al numero di byte scritti e monitora le richieste di annullamento. (Ereditato da Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Scrive in modo asincrono una sequenza di byte nel flusso corrente e sposta in avanti la posizione corrente all'interno del flusso in base al numero di byte scritti. (Ereditato da Stream) |
| WriteByte(Byte) |
Scrive un byte nella posizione corrente nel flusso e sposta in avanti la posizione all'interno del flusso di un byte. |
