HttpResponse.WriteFile Méthode

  • Référence

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.

Surcharges

WriteFile(IntPtr, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.
WriteFile(String, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.
WriteFile(String)

Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de fichier.
WriteFile(String, Boolean)

Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de mémoire.

WriteFile(IntPtr, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.

public:
 void WriteFile(IntPtr fileHandle, long offset, long size);
public void WriteFile (IntPtr fileHandle, long offset, long size);
member this.WriteFile : nativeint * int64 * int64 -> unit
Public Sub WriteFile (fileHandle As IntPtr, offset As Long, size As Long)

Paramètres

fileHandle
IntPtr

nativeint

Handle du fichier à écrire dans le flux de sortie HTTP.

offset
Int64

Position de l'octet où l'écriture va commencer dans le fichier.

size
Int64

Nombre d'octets à écrire dans le flux de sortie.

Exceptions

ArgumentNullException

fileHandler a la valeur null.

HttpException

offset est inférieur à 0.

- ou -

size est supérieur à la taille du fichier moins offset.

Exemples

L’exemple suivant écrit tout le contenu d’un fichier texte nommé Login.txt (qui peut contenir du texte HTML littéral et des contrôles d’entrée) directement dans le flux de sortie.

String FileName;
 FileStream MyFileStream;
 IntPtr FileHandle;
 long StartPos = 0, FileSize;

 FileName = "c:\\temp\\Login.txt";

 MyFileStream = new FileStream(FileName, FileMode.Open);
 FileHandle = MyFileStream.Handle;
 FileSize = MyFileStream.Length;

 Response.Write("<b>Login: </b>");
 Response.Write("<input type=text id=user /> ");
 Response.Write("<input type=submit value=Submit /><br><br>");

 Response.WriteFile(FileHandle, StartPos, FileSize);

 MyFileStream.Close();


Dim FileName As String
Dim MyFileStream As FileStream
Dim FileHandle As IntPtr
Dim StartPos As Long = 0
Dim FileSize As Long

FileName = "c:\\temp\\Login.txt"

MyFileStream = New FileStream(FileName, FileMode.Open)
FileHandle = MyFileStream.Handle
FileSize = MyFileStream.Length

Response.Write("<b>Login: </b>")
Response.Write("<input type=text id=user /> ")
Response.Write("<input type=submit value=Submit /><br><br>")

Response.WriteFile(FileHandle, StartPos, FileSize)
   
MyFileStream.Close()

Remarques

Lorsque cette méthode est utilisée avec des fichiers volumineux, l’appel de la méthode peut lever une exception. La taille du fichier qui peut être utilisé avec cette méthode dépend de la configuration matérielle du serveur web.

S’applique à

WriteFile(String, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.

public:
 void WriteFile(System::String ^ filename, long offset, long size);
public void WriteFile (string filename, long offset, long size);
member this.WriteFile : string * int64 * int64 -> unit
Public Sub WriteFile (filename As String, offset As Long, size As Long)

Paramètres

filename
String

Nom du fichier à écrire dans le flux de sortie HTTP.

offset
Int64

Position de l'octet où l'écriture va commencer dans le fichier.

size
Int64

Nombre d'octets à écrire dans le flux de sortie.

Exceptions

HttpException

offset est inférieur à 0.

- ou -

size est supérieur à la taille du fichier moins offset.

ArgumentNullException

Le paramètre filename a la valeur null.

Exemples

L’exemple suivant écrit tout le contenu d’un fichier texte nommé Login.txt (qui peut contenir du texte littéral et des contrôles d’entrée HTML) directement dans le flux de sortie.

String FileName;
 FileInfo MyFileInfo;
 long StartPos = 0, FileSize;

 FileName = "c:\\temp\\login.txt";
 MyFileInfo = new FileInfo(FileName);
 FileSize = MyFileInfo.Length;

 Response.Write("Please Login: <br>");
 Response.WriteFile(FileName, StartPos, FileSize);


Dim FileName As String
 Dim MyFileInfo As FileInfo
 Dim StartPos, FileSize As Long
 
 FileName = "c:\\temp\\login.txt"
 MyFileInfo = New FileInfo(FileName)
 FileSize = MyFileInfo.Length 
 
 Response.Write("Please Login: <br>")
 Response.WriteFile(FileName, StartPos, FileSize)

Remarques

Lorsque cette méthode est utilisée avec des fichiers volumineux, l’appel de la méthode peut lever une exception. La taille du fichier qui peut être utilisé avec cette méthode dépend de la configuration matérielle du serveur web.

S’applique à

WriteFile(String)

Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de fichier.

public:
 void WriteFile(System::String ^ filename);
public void WriteFile (string filename);
member this.WriteFile : string -> unit
Public Sub WriteFile (filename As String)

Paramètres

filename
String

Nom du fichier à écrire dans la sortie HTTP.

Exceptions

ArgumentNullException

Le paramètre filename a la valeur null.

Exemples

L’exemple suivant écrit tout le contenu d’un fichier texte nommé Login.txt (qui peut contenir du texte HTML littéral et des contrôles d’entrée) directement dans le flux de sortie.

Response.Write("Please Login: <br>");
 Response.WriteFile("login.txt");


Response.Write("Please Login: <br>")
 Response.WriteFile("login.txt")

Remarques

Lorsque cette méthode est utilisée avec des fichiers volumineux, l’appel de la méthode peut lever une exception. La taille du fichier qui peut être utilisé avec cette méthode dépend de la configuration matérielle du serveur web.

S’applique à

WriteFile(String, Boolean)

Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de mémoire.

public:
 void WriteFile(System::String ^ filename, bool readIntoMemory);
public void WriteFile (string filename, bool readIntoMemory);
member this.WriteFile : string * bool -> unit
Public Sub WriteFile (filename As String, readIntoMemory As Boolean)

Paramètres

filename
String

Nom du fichier à écrire dans un bloc de mémoire.

readIntoMemory
Boolean

Indique si le fichier sera écrit dans un bloc de mémoire.

Exceptions

ArgumentNullException

Le paramètre filename a la valeur null.

Exemples

L’exemple suivant écrit un fichier en mémoire.

Response.WriteFile("login.txt", true);


Response.WriteFile("login.txt", True)

Remarques

Lorsque cette méthode est utilisée avec des fichiers volumineux, l’appel de la méthode peut lever une exception. La taille du fichier qui peut être utilisé avec cette méthode dépend de la configuration matérielle du serveur web.

S’applique à