Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore SqlFileStream (String, Byte[], FileAccess)

 

Data di pubblicazione: ottobre 2016

Inizializza una nuova istanza della classe SqlFileStream.

Spazio dei nomi:   System.Data.SqlTypes
Assembly:  System.Data (in System.Data.dll)

public SqlFileStream(
	string path,
	byte[] transactionContext,
	FileAccess access
)

Parametri

path
Type: System.String

Percorso logico del file. Il percorso può essere recuperato usando la funzione Transact-SQL Pathname o la colonna FILESTREAM sottostante nella tabella.

transactionContext
Type: System.Byte[]

Contesto di transazione per l'oggetto SqlFileStream. Le applicazioni devono restituire la matrice di byte restituita dalla chiamata del metodo GET_FILESTREAM_TRANSACTION_CONTEXT.

access
Type: System.IO.FileAccess

Modalità di accesso usata per l'apertura del file. I valori dell'enumerazione FileAccess supportati sono Read, Write e ReadWrite.

Quando si usa FileAccess.Read, l'oggetto SqlFileStream può essere usato per leggere tutti i dati esistenti.

Quando si usa FileAccess.Write, SqlFileStream punta a un file di zero byte. I dati esistenti verranno sovrascritti quando l'oggetto viene chiuso e viene eseguito il commit della transazione.

Quando si usa FileAccess.ReadWrite, SqlFileStream punta a un file che contiene tutti i dati esistenti. L'handle è posizionato all'inizio del file. È possibile usare uno dei metodi System.IOSeek per spostare la posizione dell'handle all'interno del file per scrivere o aggiungere nuovi dati.

Exception Condition
ArgumentNullException

path è un riferimento Null oppure transactionContext è Null.

ArgumentOutOfRangeException

path è una stringa vuota (""), contiene solo spazi vuoti oppure contiene uno o più caratteri non validi.

path inizia con "\\.\", ad esempio "\\.\PHYSICALDRIVE0 ".

L'handle restituito dalla chiamata a NTCreateFile non è di tipo FILE_TYPE_DISK.

options contiene un valore non supportato.

FileNotFoundException

Impossibile trovare il file.

IOException

Si è verificato un errore di I/O.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

DirectoryNotFoundException

L'oggetto path specificato non è valido, ad esempio si trova in un'unità non mappata.

UnauthorizedAccessException

L'accesso richiesto non è consentito dal sistema operativo per il percorso specificato. Questo problema si verifica quando è specificato l'accesso Write o ReadWrite e la directory o il file è impostato per l'accesso in sola lettura.

InvalidOperationException

NtCreateFile non riesce con codice di errore impostato su ERROR_SHARING_VIOLATION.

Se viene generata un'eccezione, devono essere il rollback delle transazioni aperte. In caso contrario, può verificarsi una perdita di dati.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: