Partager via


SqlFileStream Classe

Définition

Expose les données SQL Server stockées avec l’attribut de colonne FILESTREAM sous la forme d’une séquence d’octets.

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
Héritage

Remarques

La SqlFileStream classe est utilisée pour utiliser les varbinary(max) données stockées avec l’attribut FILESTREAM dans une base de données SQL Server 2008. Vous devez installer .NET Framework 3.5 SP1 (ou version ultérieure) à utiliser SqlFileStream pour utiliser des données FILESTREAM.

Si vous spécifiez l’attribut FILESTREAM sur une varbinary(max) colonne, SQL Server stocke les données dans le système de fichiers NTFS local au lieu du fichier de base de données. Transact-SQL instructions fournissent des fonctionnalités de manipulation des données au sein du serveur, et les interfaces de système de fichiers Win32 fournissent un accès en streaming aux données.

Note

Les fichiers individuels stockés dans une colonne FILESTREAM ne peuvent pas être ouverts directement à partir du système de fichiers NTFS. La diffusion en continu de données FILESTREAM fonctionne uniquement dans le contexte d’une transaction SQL Server.

La SqlFileStream classe est dérivée de la Stream classe, qui représente une abstraction d’une séquence d’octets de certaines sources de données arbitraires telles qu’un fichier ou un bloc de mémoire. Vous pouvez lire à partir d’un FILESTREAM en transférant des données d’un flux dans une structure de données telle qu’un tableau d’octets. Vous pouvez écrire dans un FILESTREAM en transférant les données d’une structure de données dans un flux. Vous pouvez également rechercher dans le flux, ce qui vous permet d’interroger et de modifier des données à la position actuelle dans le flux.

Pour obtenir des exemples de documentation conceptuelle et de code, consultez Les données FILESTREAM.

Constructeurs

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

Initialise une nouvelle instance de la classe SqlFileStream.

SqlFileStream(String, Byte[], FileAccess)

Initialise une nouvelle instance de la classe SqlFileStream.

Propriétés

Nom Description
CanRead

Obtient une valeur indiquant si le flux actuel prend en charge la lecture.

CanSeek

Obtient une valeur indiquant si le flux actuel prend en charge la recherche.

CanTimeout

Obtient une valeur indiquant si le flux actuel peut expirer.

CanWrite

Obtient une valeur indiquant si le flux actuel prend en charge l’écriture.

Length

Obtient une valeur indiquant la longueur du flux actuel en octets.

Name

Obtient le chemin logique du SqlFileStream constructeur passé.

Position

Obtient ou définit la position dans le flux actuel.

ReadTimeout

Obtient ou définit une valeur, en millisecondes, qui détermine la durée pendant laquelle le flux tente de lire avant l’expiration du délai d’attente.

TransactionContext

Obtient ou définit le contexte de transaction de cet SqlFileStream objet.

WriteTimeout

Obtient ou définit une valeur, en millisecondes, qui détermine la durée pendant laquelle le flux tentera d’écrire avant l’expiration du délai d’attente.

Méthodes

Nom Description
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Commence une opération de lecture asynchrone.

BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Commence une opération d’écriture asynchrone.

Close()

Ferme le flux actuel et libère toutes les ressources (telles que les sockets et les handles de fichiers) associées au flux actuel. Au lieu d’appeler cette méthode, vérifiez que le flux est correctement supprimé.

(Hérité de Stream)
CopyTo(Stream, Int32)

Lit les octets du flux actuel et les écrit dans un autre flux à l’aide d’une taille de mémoire tampon spécifiée. Les deux positions de flux sont avancées par le nombre d’octets copiés.

(Hérité de Stream)
CopyTo(Stream)

Lit les octets du flux actuel et les écrit dans un autre flux. Les deux positions de flux sont avancées par le nombre d’octets copiés.

(Hérité de Stream)
CopyToAsync(Stream, Int32, CancellationToken)

Lit de manière asynchrone les octets du flux actuel et les écrit dans un autre flux à l’aide d’une taille de mémoire tampon et d’un jeton d’annulation spécifiés. Les deux positions de flux sont avancées par le nombre d’octets copiés.

(Hérité de Stream)
CopyToAsync(Stream, Int32)

Lit de façon asynchrone les octets du flux actuel et les écrit dans un autre flux à l’aide d’une taille de mémoire tampon spécifiée. Les deux positions de flux sont avancées par le nombre d’octets copiés.

(Hérité de Stream)
CopyToAsync(Stream)

Lit de manière asynchrone les octets du flux actuel et les écrit dans un autre flux. Les deux positions de flux sont avancées par le nombre d’octets copiés.

(Hérité de Stream)
CreateObjRef(Type)

Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
CreateWaitHandle()
Obsolète.
Obsolète.
Obsolète.

Alloue un WaitHandle objet.

(Hérité de Stream)
Dispose()

Libère toutes les ressources utilisées par le Stream.

(Hérité de Stream)
Dispose(Boolean)

Libère les ressources non managées utilisées par les Stream ressources gérées et libère éventuellement les ressources managées.

(Hérité de Stream)
EndRead(IAsyncResult)

Attend la fin de la lecture asynchrone en attente.

EndWrite(IAsyncResult)

Termine une opération d’écriture asynchrone.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
Finalize()

Garantit que les ressources sont libérées et que d’autres opérations de nettoyage sont effectuées lorsque le garbage collector récupère le SqlFileStream.

Flush()

efface toutes les mémoires tampons de ce flux et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent.

FlushAsync()

Efface de façon asynchrone toutes les mémoires tampons de ce flux et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent.

(Hérité de Stream)
FlushAsync(CancellationToken)

Efface de façon asynchrone toutes les mémoires tampons de ce flux, entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent et surveille les demandes d’annulation.

(Hérité de Stream)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l’objet actuel MarshalByRefObject .

(Hérité de MarshalByRefObject)
ObjectInvariant()
Obsolète.

Fournit la prise en charge d’un Contract.

(Hérité de Stream)
Read(Byte[], Int32, Int32)

Lit une séquence d’octets à partir du flux actuel et avance la position dans le flux en fonction du nombre d’octets lus.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lit de façon asynchrone une séquence d’octets à partir du flux actuel, avance la position dans le flux en fonction du nombre d’octets lus et surveille les demandes d’annulation.

(Hérité de Stream)
ReadAsync(Byte[], Int32, Int32)

Lit de façon asynchrone une séquence d’octets à partir du flux actuel et avance la position dans le flux en fonction du nombre d’octets lus.

(Hérité de Stream)
ReadByte()

Lit un octet à partir du flux et avance la position dans le flux d’un octet, ou retourne -1 si à la fin du flux.

Seek(Int64, SeekOrigin)

Définit la position dans le flux actuel.

SetLength(Int64)

Définit la longueur du flux actuel.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
Write(Byte[], Int32, Int32)

Écrit une séquence d’octets dans le flux actuel et avance la position actuelle dans ce flux par le nombre d’octets écrits.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Écrit de façon asynchrone une séquence d’octets dans le flux actuel, avance la position actuelle dans ce flux par le nombre d’octets écrits et surveille les demandes d’annulation.

(Hérité de Stream)
WriteAsync(Byte[], Int32, Int32)

Écrit de façon asynchrone une séquence d’octets dans le flux actuel et avance la position actuelle dans ce flux par le nombre d’octets écrits.

(Hérité de Stream)
WriteByte(Byte)

Écrit un octet à la position actuelle dans le flux et avance la position dans le flux d’un octet.

S’applique à

Voir aussi