HttpResponse Classe

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Incapsula le informazioni sulla risposta HTTP da un'operazione di ASP.NET.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Ereditarietà: Object
HttpResponse

Esempio

Nell'esempio seguente vengono tracciati tre rettangoli sovrapposti quando viene richiesta la pagina. Il codice inizia impostando la ContentType proprietà su image/jpeg, in modo che venga eseguito il rendering dell'intera pagina come immagine JPEG. Il codice chiama quindi il Clear metodo per assicurarsi che non venga inviato alcun contenuto estraneo con questa risposta. Il codice imposta quindi la BufferOutput proprietà su true in modo che la pagina venga elaborata completamente prima che venga inviata al client richiedente. Vengono quindi creati due oggetti utilizzati per disegnare i rettangoli: e Bitmap un Graphics oggetto . Le variabili create nella pagina vengono utilizzate come coordinate per disegnare i rettangoli e una stringa visualizzata all'interno del rettangolo più grande.

Quando vengono disegnati i tre rettangoli e la stringa che viene visualizzata all'interno di essi, l'oggetto Bitmap viene salvato nell'oggetto Stream associato alla OutputStream proprietà e il relativo formato viene impostato su JPEG. Il codice chiama i Dispose metodi e Dispose per rilasciare le risorse usate dai due oggetti di disegno. Infine, il codice chiama il Flush metodo per inviare la risposta memorizzata nel buffer al client richiedente.

Annotazioni

Nel codice, l'oggetto HttpResponse viene indicato dalla parola chiave Response. Ad esempio, Response.Clear() fa riferimento al HttpResponse.Clear metodo . La Page classe ha una proprietà denominata Response che espone l'istanza corrente di HttpResponse.

<%@ Page Language="C#" %>
<%@ import Namespace="System.Drawing" %>
<%@ import Namespace="System.Drawing.Imaging" %>
<%@ import Namespace="System.Drawing.Drawing2D" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {
// <snippet2>
        // Set the page's content type to JPEG files
        // and clears all content output from the buffer stream.
        Response.ContentType = "image/jpeg";
        Response.Clear();
    
        // Buffer response so that page is sent
        // after processing is complete.
        Response.BufferOutput = true;
// </snippet2>
    
        // Create a font style.
        Font rectangleFont = new Font(
            "Arial", 10, FontStyle.Bold);
    
        // Create integer variables.
        int height = 100;
        int width = 200;
    
        // Create a random number generator and create
        // variable values based on it.
        Random r = new Random();
        int x = r.Next(75);
        int a = r.Next(155);
        int x1 = r.Next(100);
    
        // Create a bitmap and use it to create a
        // Graphics object.
        Bitmap bmp = new Bitmap(
            width, height, PixelFormat.Format24bppRgb);
        Graphics g = Graphics.FromImage(bmp);
    
        g.SmoothingMode = SmoothingMode.AntiAlias;
        g.Clear(Color.LightGray);
    
        // Use the Graphics object to draw three rectangles.
        g.DrawRectangle(Pens.White, 1, 1, width-3, height-3);
        g.DrawRectangle(Pens.Aquamarine, 2, 2, width-3, height-3);
        g.DrawRectangle(Pens.Black, 0, 0, width, height);
    
        // Use the Graphics object to write a string
        // on the rectangles.
        g.DrawString(
            "ASP.NET Samples", rectangleFont,
            SystemBrushes.WindowText, new PointF(10, 40));
    
        // Apply color to two of the rectangles.
        g.FillRectangle(
            new SolidBrush(
                Color.FromArgb(a, 255, 128, 255)),
            x, 20, 100, 50);
    
        g.FillRectangle(
            new LinearGradientBrush(
                new Point(x, 10),
                new Point(x1 + 75, 50 + 30),
                Color.FromArgb(128, 0, 0, 128),
                Color.FromArgb(255, 255, 255, 240)),
            x1, 50, 75, 30);

// <snippet3>    
        // Save the bitmap to the response stream and
        // convert it to JPEG format.
        bmp.Save(Response.OutputStream, ImageFormat.Jpeg);
    
        // Release memory used by the Graphics object
        // and the bitmap.
        g.Dispose();
        bmp.Dispose();
    
        // Send the output to the client.
        Response.Flush();
// </snippet3>
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ import Namespace="System.Drawing" %>
<%@ import Namespace="System.Drawing.Imaging" %>
<%@ import Namespace="System.Drawing.Drawing2D" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

   Private Sub Page_Load(sender As Object, e As EventArgs)
' <snippet2>
      ' Set the page's content type to JPEG files
      ' and clears all content output from the buffer stream.
      Response.ContentType = "image/jpeg"
      Response.Clear()
      
      ' Buffer response so that page is sent
      ' after processing is complete.
      Response.BufferOutput = True
' </snippet2>
      
      ' Create a font style.
      Dim rectangleFont As New Font( _
          "Arial", 10, FontStyle.Bold)
      
      ' Create integer variables.
      Dim height As Integer = 100
      Dim width As Integer = 200
      
      ' Create a random number generator and create
      ' variable values based on it.
      Dim r As New Random()
      Dim x As Integer = r.Next(75)
      Dim a As Integer = r.Next(155)
      Dim x1 As Integer = r.Next(100)
      
      ' Create a bitmap and use it to create a
      ' Graphics object.
      Dim bmp As New Bitmap( _
          width, height, PixelFormat.Format24bppRgb)
      Dim g As Graphics = Graphics.FromImage(bmp)
      
      g.SmoothingMode = SmoothingMode.AntiAlias
      g.Clear(Color.LightGray)
      
      ' Use the Graphics object to draw three rectangles.
      g.DrawRectangle(Pens.White, 1, 1, width - 3, height - 3)
      g.DrawRectangle(Pens.Aquamarine, 2, 2, width - 3, height - 3)
      g.DrawRectangle(Pens.Black, 0, 0, width, height)
      
      ' Use the Graphics object to write a string
      ' on the rectangles.
      g.DrawString("ASP.NET Samples", rectangleFont, SystemBrushes.WindowText, New PointF(10, 40))
      
      ' Apply color to two of the rectangles.
      g.FillRectangle( _
          New SolidBrush( _
              Color.FromArgb(a, 255, 128, 255)), _
          x, 20, 100, 50)
      
      g.FillRectangle( _
          New LinearGradientBrush( _
              New Point(x, 10), _
              New Point(x1 + 75, 50 + 30), _
              Color.FromArgb(128, 0, 0, 128), _
              Color.FromArgb(255, 255, 255, 240)), _
          x1, 50, 75, 30)

' <snippet3>      
      ' Save the bitmap to the response stream and
      ' convert it to JPEG format.
      bmp.Save(Response.OutputStream, ImageFormat.Jpeg)
      
      ' Release memory used by the Graphics object
      ' and the bitmap.
      g.Dispose()
      bmp.Dispose()
      
      ' Send the output to the client.
      Response.Flush()
' </snippet3>
   End Sub 'Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

Commenti

I metodi e le proprietà della HttpResponse classe vengono esposti tramite la Response proprietà delle HttpApplicationclassi , HttpContext Page, e UserControl .

I metodi seguenti della HttpResponse classe sono supportati solo in scenari di postback e non in scenari postback asincroni:

Gli aggiornamenti delle pagine parziali vengono abilitati quando si usano UpdatePanel i controlli per aggiornare le aree selezionate di una pagina invece di aggiornare l'intera pagina con un postback. Per altre informazioni, vedere Cenni preliminari sul controllo UpdatePanel e panoramica del rendering diPartial-Page.

Costruttori

Nome	Descrizione
HttpResponse(TextWriter)	Inizializza una nuova istanza della classe HttpResponse.

Proprietà

Nome	Descrizione
Buffer	Ottiene o imposta un valore che indica se memorizzare nel buffer l'output e inviarlo al termine dell'elaborazione della risposta completa.
BufferOutput	Ottiene o imposta un valore che indica se memorizzare nel buffer l'output e inviarlo al termine dell'elaborazione della pagina completa.
Cache	Ottiene i criteri di memorizzazione nella cache, ad esempio l'ora di scadenza, le impostazioni di privacy e le clausole di variazione, di una pagina Web.
CacheControl	Ottiene o imposta l'intestazione `Cache-Control` HTTP che corrisponde a uno dei HttpCacheability valori di enumerazione.
Charset	Ottiene o imposta il set di caratteri HTTP del flusso di output.
ClientDisconnectedToken	Ottiene un CancellationToken oggetto che viene ritagliato quando il client si disconnette.
ContentEncoding	Ottiene o imposta il set di caratteri HTTP del flusso di output.
ContentType	Ottiene o imposta il tipo MIME HTTP del flusso di output.
Cookies	Ottiene la raccolta di cookie di risposta.
Expires	Ottiene o imposta il numero di minuti prima della scadenza di una pagina memorizzata nella cache in un browser. Se l'utente torna alla stessa pagina prima della scadenza, viene visualizzata la versione memorizzata nella cache. Expires viene fornito per la compatibilità con le versioni precedenti di ASP.
ExpiresAbsolute	Ottiene o imposta la data e l'ora assoluti in cui rimuovere le informazioni memorizzate nella cache. ExpiresAbsolute viene fornito per la compatibilità con le versioni precedenti di ASP.
Filter	Ottiene o imposta un oggetto filtro di wrapping utilizzato per modificare il corpo dell'entità HTTP prima della trasmissione.
HeaderEncoding	Ottiene o imposta un Encoding oggetto che rappresenta la codifica per il flusso di output dell'intestazione corrente.
Headers	Ottiene la raccolta di intestazioni di risposta.
HeadersWritten	Ottiene un valore che indica se le intestazioni della risposta sono state scritte.
IsClientConnected	Ottiene un valore che indica se il client è ancora connesso al server.
IsRequestBeingRedirected	Ottiene un valore booleano che indica se il client viene trasferito in una nuova posizione.
Output	Abilita l'output del testo nel flusso di risposta HTTP in uscita.
OutputStream	Abilita l'output binario nel corpo del contenuto HTTP in uscita.
RedirectLocation	Ottiene o imposta il valore dell'intestazione HTTP `Location` .
Status	Imposta la `Status` riga restituita al client.
StatusCode	Ottiene o imposta il codice di stato HTTP dell'output restituito al client.
StatusDescription	Ottiene o imposta la stringa di stato HTTP dell'output restituito al client.
SubStatusCode	Ottiene o imposta un valore che qualifica il codice di stato della risposta.
SupportsAsyncFlush	Ottiene un valore che indica se la connessione supporta operazioni di scaricamento asincrone.
SuppressContent	Ottiene o imposta un valore che indica se inviare contenuto HTTP al client.
SuppressDefaultCacheControlHeader	Ottiene o imposta un valore che indica se eliminare l'intestazione predefinita `Cache Control: private` per la risposta HTTP corrente.
SuppressFormsAuthenticationRedirect	Ottiene o imposta un valore che specifica se il reindirizzamento dell'autenticazione basata su form alla pagina di accesso deve essere eliminato.
TrySkipIisCustomErrors	Ottiene o imposta un valore che specifica se gli errori personalizzati di IIS 7.0 sono disabilitati.

Metodi

Nome	Descrizione
AddCacheDependency(CacheDependency[])	Associa un set di dipendenze della cache alla risposta per facilitare l'invalidazione della risposta se è archiviata nella cache di output e le dipendenze specificate cambiano.
AddCacheItemDependencies(ArrayList)	Rende la validità di una risposta memorizzata nella cache dipendente da altri elementi nella cache.
AddCacheItemDependencies(String[])	Rende la validità di un elemento memorizzato nella cache dipendente da un altro elemento nella cache.
AddCacheItemDependency(String)	Rende la validità di una risposta memorizzata nella cache dipendente da un altro elemento nella cache.
AddFileDependencies(ArrayList)	Aggiunge un gruppo di nomi di file alla raccolta di nomi di file su cui dipende la risposta corrente.
AddFileDependencies(String[])	Aggiunge una matrice di nomi di file alla raccolta di nomi di file su cui dipende la risposta corrente.
AddFileDependency(String)	Aggiunge un singolo nome file alla raccolta di nomi di file su cui dipende la risposta corrente.
AddHeader(String, String)	Aggiunge un'intestazione HTTP al flusso di output. AddHeader(String, String) viene fornito per la compatibilità con le versioni precedenti di ASP.
AddOnSendingHeaders(Action<HttpContext>)	Registra un callback che il runtime di ASP.NET richiamerà immediatamente prima dell'invio delle intestazioni di risposta per questa richiesta.
AppendCookie(HttpCookie)	Aggiunge un cookie HTTP alla raccolta di cookie intrinseci.
AppendHeader(String, String)	Aggiunge un'intestazione HTTP al flusso di output.
AppendToLog(String)	Aggiunge informazioni di log personalizzate al file di log di Internet Information Services (IIS).
ApplyAppPathModifier(String)	Aggiunge un ID sessione al percorso virtuale se la sessione usa Cookieless lo stato della sessione e restituisce il percorso combinato. Se Cookieless lo stato della sessione non viene utilizzato, ApplyAppPathModifier(String) restituisce il percorso virtuale originale.
BeginFlush(AsyncCallback, Object)	Invia la risposta attualmente memorizzata nel buffer al client.
BinaryWrite(Byte[])	Scrive una stringa di caratteri binari nel flusso di output HTTP.
Clear()	Cancella tutto l'output del contenuto dal flusso di buffer.
ClearContent()	Cancella tutto l'output del contenuto dal flusso di buffer.
ClearHeaders()	Cancella tutte le intestazioni dal flusso di buffer.
Close()	Chiude la connessione socket a un client.
DisableKernelCache()	Disabilita la memorizzazione nella cache del kernel per la risposta corrente.
DisableUserCache()	Disabilita la memorizzazione nella cache in modalità utente IIS per questa risposta.
End()	Invia tutto l'output attualmente memorizzato nel buffer al client, arresta l'esecuzione della pagina e genera l'evento EndRequest .
EndFlush(IAsyncResult)	Completa un'operazione di scaricamento asincrona.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Flush()	Invia tutto l'output attualmente memorizzato nel buffer al client.
FlushAsync()	Invia in modo asincrono tutto l'output attualmente memorizzato nel buffer al client.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Pics(String)	Aggiunge un'intestazione HTTP `PICS-Label` al flusso di output.
PushPromise(String, String, NameValueCollection)	Supporta le applicazioni che inviano promesse push ai client HTTP 2.0. Per altre informazioni, vedere La sezione specifica HTTP/2 8.2: Push server.
PushPromise(String)	Supporta le applicazioni che inviano promesse push ai client HTTP 2.0. Per altre informazioni, vedere La sezione specifica HTTP/2 8.2: Push server.
Redirect(String, Boolean)	Reindirizza un client a un nuovo URL. Specifica il nuovo URL e se l'esecuzione della pagina corrente deve terminare.
Redirect(String)	Reindirizza una richiesta a un nuovo URL e specifica il nuovo URL.
RedirectPermanent(String, Boolean)	Esegue un reindirizzamento permanente dall'URL richiesto all'URL specificato e fornisce l'opzione per completare la risposta.
RedirectPermanent(String)	Esegue un reindirizzamento permanente dall'URL richiesto all'URL specificato.
RedirectToRoute(Object)	Reindirizza una richiesta a un nuovo URL usando i valori dei parametri di route.
RedirectToRoute(RouteValueDictionary)	Reindirizza una richiesta a un nuovo URL usando i valori dei parametri di route.
RedirectToRoute(String, Object)	Reindirizza una richiesta a un nuovo URL usando i valori dei parametri di route e un nome di route.
RedirectToRoute(String, RouteValueDictionary)	Reindirizza una richiesta a un nuovo URL usando i valori dei parametri di route e un nome di route.
RedirectToRoute(String)	Reindirizza una richiesta a un nuovo URL usando un nome di route.
RedirectToRoutePermanent(Object)	Esegue un reindirizzamento permanente da un URL richiesto a un nuovo URL usando i valori dei parametri di route.
RedirectToRoutePermanent(RouteValueDictionary)	Esegue un reindirizzamento permanente da un URL richiesto a un nuovo URL usando i valori dei parametri di route.
RedirectToRoutePermanent(String, Object)	Esegue un reindirizzamento permanente da un URL richiesto a un nuovo URL usando i valori dei parametri di route e il nome della route che corrispondono al nuovo URL.
RedirectToRoutePermanent(String, RouteValueDictionary)	Esegue un reindirizzamento permanente da un URL richiesto a un nuovo URL usando i valori dei parametri di route e un nome di route.
RedirectToRoutePermanent(String)	Esegue un reindirizzamento permanente da un URL richiesto a un nuovo URL usando un nome di route.
RemoveOutputCacheItem(String, String)	Usa il provider di cache di output specificato per rimuovere tutti gli elementi della cache di output associati al percorso specificato.
RemoveOutputCacheItem(String)	Rimuove dalla cache tutti gli elementi memorizzati nella cache associati al provider di cache di output predefinito. Questo metodo è statico.
SetCookie(HttpCookie)	Poiché il metodo HttpResponse.SetCookie è destinato solo all'uso interno, non è consigliabile chiamarlo nel codice. È invece possibile chiamare il metodo HttpResponse.Cookies.Set , come illustrato nell'esempio seguente. Aggiorna un cookie esistente nella raccolta di cookie.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TransmitFile(String, Int64, Int64)	Scrive la parte specificata di un file direttamente in un flusso di output della risposta HTTP senza memorizzarla nel buffer in memoria.
TransmitFile(String)	Scrive il file specificato direttamente in un flusso di output della risposta HTTP, senza memorizzarlo nel buffer in memoria.
Write(Char)	Scrive un carattere in un flusso di output della risposta HTTP.
Write(Char[], Int32, Int32)	Scrive una matrice di caratteri in un flusso di output della risposta HTTP.
Write(Object)	Scrive un oggetto Object in un flusso di risposta HTTP.
Write(String)	Scrive una stringa in un flusso di output della risposta HTTP.
WriteFile(IntPtr, Int64, Int64)	Scrive il file specificato direttamente in un flusso di output della risposta HTTP.
WriteFile(String, Boolean)	Scrive il contenuto del file specificato direttamente in un flusso di output della risposta HTTP come blocco di memoria.
WriteFile(String, Int64, Int64)	Scrive il file specificato direttamente in un flusso di output della risposta HTTP.
WriteFile(String)	Scrive il contenuto del file specificato direttamente in un flusso di output della risposta HTTP come blocco di file.
WriteSubstitution(HttpResponseSubstitutionCallback)	Consente l'inserimento di blocchi di sostituzione delle risposte nella risposta, che consente la generazione dinamica di aree di risposta specificate per le risposte memorizzate nella cache di output.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?