SqlFileStream 클래스

정의

네임스페이스:

System.Data.SqlTypes

어셈블리:

System.Data.dll

FILESTREAM 열 특성에 바이트 시쿼스로 저장된 SQL Server 데이터를 노출합니다.

public ref class SqlFileStream sealed : System::IO::Stream

public sealed class SqlFileStream : System.IO.Stream

type SqlFileStream = class
    inherit Stream

Public NotInheritable Class SqlFileStream
Inherits Stream

상속

Object

MarshalByRefObject

Stream

SqlFileStream

설명

클래스는 SqlFileStream SQL Server 2008 데이터베이스에서 FILESTREAM 특성으로 저장된 데이터를 사용하는 varbinary(max) 데 사용됩니다. FILESTREAM 데이터를 사용하는 데 사용 SqlFileStream 하려면 .NET Framework 3.5 SP1 이상을 설치해야 합니다.

열에 varbinary(max) FILESTREAM 특성을 지정하면 SQL Server 데이터베이스 파일 대신 로컬 NTFS 파일 시스템에 데이터를 저장합니다. Transact-SQL 문은 서버 내에서 데이터 조작 기능을 제공하며 Win32 파일 시스템 인터페이스는 데이터에 대한 스트리밍 액세스를 제공합니다.

참고

FILESTREAM 열에 저장된 개별 파일은 NTFS 파일 시스템에서 직접 열 수 없습니다. FILESTREAM 데이터 스트리밍은 SQL Server 트랜잭션의 컨텍스트에서만 작동합니다.

클래스는 SqlFileStream 파일 또는 메모리 블록과 같은 일부 임의 데이터 원본에서 바이트 시퀀스의 추상화를 나타내는 클래스에서 파생 Stream 됩니다. 스트림에서 바이트 배열과 같은 데이터 구조로 데이터를 전송하여 FILESTREAM에서 읽을 수 있습니다. 데이터 구조에서 스트림으로 데이터를 전송하여 FILESTREAM에 쓸 수 있습니다. 스트림 내에서 검색할 수도 있습니다. 그러면 스트림 내의 현재 위치에서 데이터를 쿼리하고 수정할 수 있습니다.

개념 설명서 및 코드 예제는 FILESTREAM 데이터를 참조하세요.

SQL Server FILESTREAM 데이터 설정 및 구성에 대한 설명서는 SQL Server 2008 온라인 설명서에서 FILESTREAM Storage 디자인 및 구현을 참조하세요.

생성자

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)	count 현재 스트림에서 바이트 수를 읽고 스트림 내의 위치를 이동합니다. (다음에서 상속됨 Stream)
ReadExactly(Span<Byte>)	현재 스트림에서 바이트를 읽고 가 채워질 때까지 buffer 스트림 내의 위치를 이동합니다. (다음에서 상속됨 Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	현재 스트림에서 바이트 수를 비동기적으로 읽고 count , 스트림 내의 위치를 확장하고, 취소 요청을 모니터링합니다. (다음에서 상속됨 Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 buffer 스트림 내의 위치를 발전시키고, 취소 요청을 모니터링합니다. (다음에서 상속됨 Stream)
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)	스트림의 현재 위치에 바이트를 쓰고 스트림 내 위치를 1바이트씩 앞으로 이동합니다.

확장 메서드

CopyToAsync(Stream, PipeWriter, CancellationToken)

Stream의 바이트를 비동기식으로 읽고 취소 토큰을 사용하여 지정된 PipeWriter에 씁니다.

추가 정보

• FILESTREAM 데이터
• SQL Server 데이터 형식 매핑(ADO.NET)
• SQL Server 이진 및 Large-Value 데이터(ADO.NET)