BufferedStream.Seek(Int64, SeekOrigin) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

BufferedStream.cs

Définit la position dans le flux actuel mis en mémoire tampon.

public:
 override long Seek(long offset, System::IO::SeekOrigin origin);

public override long Seek (long offset, System.IO.SeekOrigin origin);

override this.Seek : int64 * System.IO.SeekOrigin -> int64

Public Overrides Function Seek (offset As Long, origin As SeekOrigin) As Long

Paramètres

offset

Int64

Offset d'octet par rapport à origin.

origin

SeekOrigin

Valeur de type SeekOrigin indiquant le point de référence à partir duquel la nouvelle position est obtenue.

Retours

Int64

Nouvelle position dans le flux actuel mis en mémoire tampon.

Exceptions

IOException

Le flux n’est pas ouvert ou bien il est null.

NotSupportedException

Le flux ne prend pas en charge la recherche.

ObjectDisposedException

Des méthodes ont été appelées après la fermeture du flux.

Remarques

Si offset est négatif, la nouvelle position précède la position spécifiée par origin du nombre d'octets spécifié par offset. Si offset a la valeur 0, la nouvelle position correspond à la position spécifiée par origin. Si offset est positif, la nouvelle position suit la position spécifiée par origin du nombre d'octets spécifié par offset.

Lorsqu’un BufferedStream objet est le flux de base d’un StreamReader objet, l’appel de la Seek méthode peut faire en sorte que la position du flux ne correspond plus à la position de la mémoire tampon interne dans le lecteur. Pour réinitialiser la mémoire tampon interne, appelez la StreamReader.DiscardBufferedData méthode ; toutefois, cette méthode ralentit les performances et ne doit être appelée que lorsque cela est absolument nécessaire.

La recherche vers n’importe quel emplacement au-delà de la longueur du flux est prise en charge.

Voir aussi

• SeekOrigin
• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier