SqlFileStream 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
公开与作为字节序列的 FILESTREAM 列属性存储的 SQL Server 数据。
public ref class SqlFileStream sealed : System::IO::Streampublic sealed class SqlFileStream : System.IO.Streamtype SqlFileStream = class
inherit StreamPublic NotInheritable Class SqlFileStream
Inherits Stream- 继承
注解
类SqlFileStream用于处理varbinary(max)在 SQL Server 2008 数据库中使用 FILESTREAM 属性存储的数据。 必须安装 .NET Framework 3.5 SP1 (或更高版本) 才能使用 SqlFileStream FILESTREAM 数据。
对列指定 FILESTREAM 属性varbinary(max)会导致SQL Server将数据存储在本地 NTFS 文件系统而不是数据库文件中。 Transact-SQL 语句提供服务器中的数据操作功能，Win32 文件系统接口提供对数据的流访问。
注意
无法直接从 NTFS 文件系统打开存储在 FILESTREAM 列中的单个文件。 流式处理 FILESTREAM 数据仅适用于SQL Server事务的上下文。
类 SqlFileStream 派生自 Stream 类，该类表示来自某些任意数据源（如文件或内存块）的字节序列的抽象。 可以通过将数据从流传输到数据结构（如字节数组）中，从 FILESTREAM 读取数据。 可以通过将数据从数据结构传输到流中来写入 FILESTREAM。 还可以在流中查找，这样就可以查询和修改流中当前位置的数据。
有关概念文档和代码示例，请参阅 FILESTREAM 数据。
有关在 SQL Server 上设置和配置 FILESTREAM 数据的文档，请参阅 SQL Server 2008 联机丛书中的设计和实现 FILESTREAM 存储。
构造函数
| SqlFileStream(String, Byte[], FileAccess) |
初始化 SqlFileStream 类的新实例。 |
| SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64) |
初始化 SqlFileStream 类的新实例。 |
属性
| CanRead |
获取一个值，该值指示当前流是否支持读取。 |
| CanSeek |
获取一个值，该值指示当前流是否支持查找。 |
| CanTimeout |
获取指示当前流是否可以超时的值。 |
| CanWrite |
获取一个值，该值指示当前流是否支持写入。 |
| Length |
获取一个指示当前流的长度的值（以字节为单位）。 |
| Name |
获取传递给构造函数的 SqlFileStream 的逻辑路径。 |
| Position |
获取或设置当前流中的位置。 |
| ReadTimeout |
获取或设置一个值（以毫秒为单位），该值确定流在超时前将尝试读取的时间。 |
| TransactionContext |
获取或设置此 SqlFileStream 对象的事务上下文。 |
| WriteTimeout |
获取或设置一个值（以毫秒为单位），该值确定流在超时前将尝试写入多长时间。 |
方法
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
开始异步读操作。 |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
开始异步写操作。 |
| Close() |
关闭当前流并释放与之关联的所有资源（如套接字和文件句柄）。 不直接调用此方法，而应确保流得以正确释放。 (继承自 Stream) |
| CopyTo(Stream) |
从当前流中读取字节并将其写入到另一流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CopyTo(Stream, Int32) |
使用指定的缓冲区大小，从当前流中读取字节并将其写入到另一流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CopyToAsync(Stream) |
从当前流中异步读取字节并将其写入到另一个流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CopyToAsync(Stream, CancellationToken) |
通过指定的取消令牌，从当前流中异步读取字节并将其写入到另一个流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CopyToAsync(Stream, Int32) |
使用指定的缓冲区大小，从当前流中异步读取字节并将其写入到另一流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
使用指定的缓冲区大小和取消令牌，从当前流中异步读取字节并将其写入到另一个流中。 这两个流位置都按复制的字节数提前。 (继承自 Stream) |
| CreateObjRef(Type) |
创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject) |
| CreateWaitHandle() |
已过时.
已过时.
已过时.
分配 WaitHandle 对象。 (继承自 Stream) |
| Dispose() |
释放由 Stream 使用的所有资源。 (继承自 Stream) |
| Dispose(Boolean) |
释放由 Stream 占用的非托管资源，还可以另外再释放托管资源。 (继承自 Stream) |
| DisposeAsync() |
异步释放 Stream 使用的非托管资源。 (继承自 Stream) |
| EndRead(IAsyncResult) |
等待挂起的异步读取完成。 |
| EndWrite(IAsyncResult) |
结束异步写操作。 |
| Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
| Finalize() |
确保垃圾回收器回收 SqlFileStream 时释放资源并执行其他清理操作。 |
| Flush() |
清除此流的所有缓冲区并导致所有缓冲数据都写入基础设备中。 |
| FlushAsync() |
异步清除此流的所有缓冲区并导致所有缓冲数据都写入基础设备中。 (继承自 Stream) |
| FlushAsync(CancellationToken) |
异步清理此流的所有缓冲区，导致所有缓冲数据都写入基础设备，并且监控取消请求。 (继承自 Stream) |
| GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
| GetLifetimeService() |
已过时.
检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| InitializeLifetimeService() |
已过时.
获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
| MemberwiseClone(Boolean) |
创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject) |
| ObjectInvariant() |
已过时.
提供对 Contract 的支持。 (继承自 Stream) |
| Read(Byte[], Int32, Int32) |
从当前流读取字节序列，并将流中的位置向前移动读取的字节数。 |
| Read(Span<Byte>) |
当在派生类中重写时，从当前流读取字节序列，并将此流中的位置提升读取的字节数。 (继承自 Stream) |
| ReadAsync(Byte[], Int32, Int32) |
从当前流异步读取字节序列，并将流中的位置提升读取的字节数。 (继承自 Stream) |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
从当前流异步读取字节的序列，将流中的位置提升读取的字节数，并监视取消请求。 (继承自 Stream) |
| ReadAsync(Memory<Byte>, CancellationToken) |
从当前流异步读取字节的序列，将流中的位置提升读取的字节数，并监视取消请求。 (继承自 Stream) |
| ReadAtLeast(Span<Byte>, Int32, Boolean) |
从当前流中读取至少最小字节数，并将流中的位置向前推进读取的字节数。 (继承自 Stream) |
| ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken) |
从当前流异步读取至少最小字节数，按读取的字节数推进流中的位置，并监视取消请求。 (继承自 Stream) |
| ReadByte() |
从流中读取一个字节，并将流内的位置向前提升一个字节，或者如果已到达流结尾，则返回 -1。 |
| ReadExactly(Byte[], Int32, Int32) |
|
| ReadExactly(Span<Byte>) |
从当前流中读取字节，并推进流中的位置， |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
从当前流异步读取 |
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
从当前流异步读取字节，推进流中的位置，直到 |
| Seek(Int64, SeekOrigin) |
设置当前流中的位置。 |
| SetLength(Int64) |
设置当前流的长度。 |
| ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
| Write(Byte[], Int32, Int32) |
将字节序列写入当前流，并按写入的字节数向前调整流的当前位置。 |
| Write(ReadOnlySpan<Byte>) |
当在派生类中重写时，向当前流中写入字节序列，并将此流中的当前位置提升写入的字节数。 (继承自 Stream) |
| WriteAsync(Byte[], Int32, Int32) |
将字节序列异步写入当前流，并将流的当前位置提升写入的字节数。 (继承自 Stream) |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
将字节的序列异步写入当前流，将该流中的当前位置向前移动写入的字节数，并监视取消请求。 (继承自 Stream) |
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
将字节的序列异步写入当前流，将该流中的当前位置向前移动写入的字节数，并监视取消请求。 (继承自 Stream) |
| WriteByte(Byte) |
将一个字节写入流内的当前位置，并将流内的位置向前提升一个字节。 |
扩展方法
| CopyToAsync(Stream, PipeWriter, CancellationToken) |
使用取消令牌从 Stream 中异步读取字节并将其写入到指定的 PipeWriter。 |
