SqlFileStream Construtores

Definição

Inicializa uma nova instância da classe SqlFileStream.

Sobrecargas

SqlFileStream(String, Byte[], FileAccess)

Inicializa uma nova instância da classe SqlFileStream.

SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)

Inicializa uma nova instância da classe SqlFileStream.

Comentários

A tabela a seguir lista as permissões cas (segurança de acesso ao código) que todos os chamadores na pilha devem ter para usar os SqlFileStream construtores.

Acesso a arquivos Permissão
Ler Read
Gravar Write
ReadWrite Read e Write

Para obter mais informações sobre o CAS, consulte Segurança de acesso ao código e ADO.NET.

SqlFileStream(String, Byte[], FileAccess)

Inicializa uma nova instância da classe SqlFileStream.

public SqlFileStream (string path, byte[] transactionContext, System.IO.FileAccess access);

Parâmetros

path
String

O caminho lógico para o arquivo. O caminho pode ser recuperado usando a função Transact-SQL Pathname na coluna FILESTREAM subjacente da tabela.

transactionContext
Byte[]

O contexto de transação para o objeto SqlFileStream. Os aplicativos devem retornar uma matriz de bytes retornada com uma chamada ao método GET_FILESTREAM_TRANSACTION_CONTEXT.

access
FileAccess

O modo de acesso a ser usado ao abrir o arquivo. Os valores de enumeração FileAccess com suporte são Read, Write e ReadWrite.

Ao usar FileAccess.Read, o objeto SqlFileStream pode ser usado para ler todos os dados existentes.

Ao usar FileAccess.Write, o SqlFileStream aponta para um arquivo de zero byte. Os dados existentes serão substituídos quando o objeto for fechado e a transação for confirmada.

Ao usar FileAccess.ReadWrite, o SqlFileStream aponta para um arquivo que tem todos os dados existentes. O identificador está posicionado no início do arquivo. É possível usar um dos métodos System.IOSeek para mover a posição do identificador no arquivo para gravar ou anexar novos dados.

Exceções

path é uma referência nula ou transactionContext é nulo.

path é uma cadeia de caracteres vazia (“”), contém somente espaços em branco ou contém um ou mais caracteres inválidos.

path começa com “\\.\”, por exemplo, “\\.\PHYSICALDRIVE0”.

O identificador retornado pela chamada a NTCreateFile não é do tipo FILE_TYPE_DISK.

options contém um valor sem suporte.

Não é possível encontrar o arquivo.

Ocorreu um erro de E/S.

O chamador não tem a permissão necessária.

O path especificado é inválido, por exemplo, ele está em uma unidade não mapeada.

O acesso solicitado não é permitido pelo sistema operacional para o caminho especificado. Isso ocorre quando o acesso Write ou ReadWrite é especificado e o arquivo ou diretório está configurado para o acesso somente leitura.

NtCreateFile falha com o código de erro definido como ERROR_SHARING_VIOLATION.

Comentários

Se uma exceção for lançada, todas as transações abertas deverão ser revertidas. Caso contrário, pode ocorrer perda de dados.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)

Inicializa uma nova instância da classe SqlFileStream.

public SqlFileStream (string path, byte[] transactionContext, System.IO.FileAccess access, System.IO.FileOptions options, long allocationSize);

Parâmetros

path
String

O caminho lógico para o arquivo. O caminho pode ser recuperado usando a função Transact-SQL Pathname na coluna FILESTREAM subjacente da tabela.

transactionContext
Byte[]

O contexto de transação para o objeto SqlFileStream. Quando definido como nulo, uma transação implícita será usada para o objeto SqlFileStream. Os aplicativos devem retornar uma matriz de bytes retornada com uma chamada ao método GET_FILESTREAM_TRANSACTION_CONTEXT.

access
FileAccess

O modo de acesso a ser usado ao abrir o arquivo. Os valores de enumeração FileAccess com suporte são Read, Write e ReadWrite.

Ao usar FileAccess.Read, o objeto SqlFileStream pode ser usado para ler todos os dados existentes.

Ao usar FileAccess.Write, o SqlFileStream aponta para um arquivo de zero byte. Os dados existentes serão substituídos quando o objeto for fechado e a transação for confirmada.

Ao usar FileAccess.ReadWrite, o SqlFileStream aponta para um arquivo que tem todos os dados existentes. O identificador está posicionado no início do arquivo. É possível usar um dos métodos System.IOSeek para mover a posição do identificador no arquivo para gravar ou anexar novos dados.

options
FileOptions

Especifica a opção a usar ao abrir o arquivo. Os valores de FileOptions compatíveis são Asynchronous, WriteThrough, SequentialScan e RandomAccess.

allocationSize
Int64

O tamanho de alocação a usar ao criar um arquivo. Se definido como 0, o valor padrão será usado.

Exceções

path é uma referência nula ou transactionContext é nulo.

path é uma cadeia de caracteres vazia (“”), contém somente espaços em branco ou contém um ou mais caracteres inválidos.

path começa com “\\.\”, por exemplo, “\\.\PHYSICALDRIVE0”.

O identificador retornado pela chamada para NTCreateFile não é do tipo FILE_TYPE_DISK.

options contém um valor sem suporte.

Não é possível encontrar o arquivo.

Ocorreu um erro de E/S.

O chamador não tem a permissão necessária.

O path especificado é inválido, por exemplo, ele está em uma unidade não mapeada.

O acesso solicitado não é permitido pelo sistema operacional para o caminho especificado. Isso ocorre quando o acesso Write ou ReadWrite é especificado e o arquivo ou diretório está configurado para o acesso somente leitura.

NtCreateFile falha com o código de erro definido como ERROR_SHARING_VIOLATION.

Comentários

Se uma exceção for lançada, todas as transações abertas deverão ser revertidas. Caso contrário, pode ocorrer perda de dados.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1