SqlFileStream Konstruktorok
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Inicializálja a SqlFileStream osztály új példányát.
Túlterhelések
| Name | Description |
|---|---|
| SqlFileStream(String, Byte[], FileAccess) |
Inicializálja a SqlFileStream osztály új példányát. |
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
Inicializálja a SqlFileStream osztály új példányát. |
Megjegyzések
Az alábbi táblázat felsorolja a kódhozzáférés biztonsági (CAS) engedélyeit, amelyeknek a verem minden hívójának használnia kell a SqlFileStream konstruktorokat.
| Fájlhozzáférés | Engedély |
|---|---|
| Olvasás | Read |
| Írj! | Write |
| OlvasásÍrás | Read és Write |
További információ a CAS-ról: Code Access Security és ADO.NET.
SqlFileStream(String, Byte[], FileAccess)
Inicializálja a SqlFileStream osztály új példányát.
public:
SqlFileStream(System::String ^ path, cli::array <System::Byte> ^ transactionContext, System::IO::FileAccess access);public SqlFileStream(string path, byte[] transactionContext, System.IO.FileAccess access);new System.Data.SqlTypes.SqlFileStream : string * byte[] * System.IO.FileAccess -> System.Data.SqlTypes.SqlFileStreamPublic Sub New (path As String, transactionContext As Byte(), access As FileAccess)Paraméterek
- path
- String
A fájl logikai elérési útja. Az elérési út a tábla mögöttes FILESTREAM oszlopában található Transact-SQL Pathname függvénnyel kérhető le.
- transactionContext
- Byte[]
Az objektum tranzakciós környezete SqlFileStream . Az alkalmazásoknak a GET_FILESTREAM_TRANSACTION_CONTEXT metódus meghívásával kell visszaadni a visszaadott bájttömböt.
- access
- FileAccess
A fájl megnyitásakor használni kívánt hozzáférési mód. A támogatott FileAccess enumerálási értékek a következőkRead: és WriteReadWrite.
A használat során FileAccess.Readaz SqlFileStream objektum az összes meglévő adat beolvasására használható.
Ha használja FileAccess.Write, SqlFileStream egy nulla bájtos fájlra mutat. A meglévő adatok felülíródnak az objektum bezárásakor és a tranzakció véglegesítésekor.
A használat során FileAccess.ReadWritea SqlFileStream fájl egy olyan fájlra mutat, amelyben az összes meglévő adat található. A leíró a fájl elején van elhelyezve. Az egyik System.IOSeek módszer használatával áthelyezheti a leíró helyét a fájlon belül új adatok írásához vagy hozzáfűzéséhez.
Kivételek
path null hivatkozás, vagy transactionContext null értékű.
path üres sztring (""), csak üres szóközt tartalmaz, vagy egy vagy több érvénytelen karaktert tartalmaz.
-VAGY-
path a következővel kezdődik: "\\.\", például "\\.\PHYSICALDRIVE0 ".
-VAGY-
Az NTCreateFile hívása által visszaadott leíró nem FILE_TYPE_DISK típusú.
A fájl nem található.
I/O-hiba történt.
A hívó nem rendelkezik a szükséges engedéllyel.
A megadott path érték érvénytelen, például leképezetlen meghajtón van.
A kért hozzáférést az operációs rendszer nem engedélyezi a megadott elérési úthoz. Ez akkor fordul elő, ha írási vagy olvasási hozzáférés van megadva, és a fájl vagy könyvtár írásvédett hozzáférésre van beállítva.
Az NtCreateFile sikertelen, és a hibakód ERROR_SHARING_VIOLATION van beállítva.
Megjegyzések
Kivétel esetén a nyitott tranzakciókat vissza kell állítani. Ellenkező esetben adatvesztés történhet.
Lásd még
A következőre érvényes:
SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)
Inicializálja a SqlFileStream osztály új példányát.
public:
SqlFileStream(System::String ^ path, cli::array <System::Byte> ^ transactionContext, System::IO::FileAccess access, System::IO::FileOptions options, long allocationSize);public SqlFileStream(string path, byte[] transactionContext, System.IO.FileAccess access, System.IO.FileOptions options, long allocationSize);new System.Data.SqlTypes.SqlFileStream : string * byte[] * System.IO.FileAccess * System.IO.FileOptions * int64 -> System.Data.SqlTypes.SqlFileStreamPublic Sub New (path As String, transactionContext As Byte(), access As FileAccess, options As FileOptions, allocationSize As Long)Paraméterek
- path
- String
A fájl logikai elérési útja. Az elérési út a tábla mögöttes FILESTREAM oszlopában található Transact-SQL Pathname függvénnyel kérhető le.
- transactionContext
- Byte[]
Az objektum tranzakciós környezete SqlFileStream . Ha null értékre van állítva, a rendszer implicit tranzakciót használ az SqlFileStream objektumhoz. Az alkalmazásoknak a GET_FILESTREAM_TRANSACTION_CONTEXT metódus meghívásával kell visszaadni a visszaadott bájttömböt.
- access
- FileAccess
A fájl megnyitásakor használni kívánt hozzáférési mód. A támogatott FileAccess enumerálási értékek a következőkRead: és WriteReadWrite.
A használat során FileAccess.Readaz SqlFileStream objektum az összes meglévő adat beolvasására használható.
Ha használja FileAccess.Write, SqlFileStream egy nulla bájtos fájlra mutat. A meglévő adatok felülíródnak az objektum bezárásakor és a tranzakció véglegesítésekor.
A használat során FileAccess.ReadWritea SqlFileStream fájl egy olyan fájlra mutat, amelyben az összes meglévő adat található. A leíró a fájl elején van elhelyezve. Az egyik System.IOSeek módszer használatával áthelyezheti a leíró helyét a fájlon belül új adatok írásához vagy hozzáfűzéséhez.
- options
- FileOptions
Megadja a fájl megnyitásakor használni kívánt beállítást. A támogatott FileOptions értékek a következőkAsynchronous: , WriteThroughSequentialScanés RandomAccess.
- allocationSize
- Int64
A fájl létrehozásakor használandó foglalási méret. Ha 0 értékre van állítva, a rendszer az alapértelmezett értéket használja.
Kivételek
path null hivatkozás, vagy transactionContext null értékű.
path üres sztring (""), csak üres szóközt tartalmaz, vagy egy vagy több érvénytelen karaktert tartalmaz.
path a következővel kezdődik: "\\.\", például "\\.\PHYSICALDRIVE0 ".
Az NTCreateFile hívása által visszaadott leíró nem FILE_TYPE_DISK típusú.
options nem támogatott értéket tartalmaz.
A fájl nem található.
I/O-hiba történt.
A hívó nem rendelkezik a szükséges engedéllyel.
A megadott path érték érvénytelen, például leképezetlen meghajtón van.
A kért hozzáférést az operációs rendszer nem engedélyezi a megadott elérési úthoz. Ez akkor fordul elő, ha írási vagy olvasási hozzáférés van megadva, és a fájl vagy könyvtár írásvédett hozzáférésre van beállítva.
Az NtCreateFile sikertelen, és a hibakód ERROR_SHARING_VIOLATION van beállítva.
Megjegyzések
Kivétel esetén a nyitott tranzakciókat vissza kell állítani. Ellenkező esetben adatvesztés történhet.
