DefaultHttpHandler Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar egenskaperna och metoderna för en HTTP-standardhanterare.
public ref class DefaultHttpHandler : System::Web::IHttpAsyncHandler
public class DefaultHttpHandler : System.Web.IHttpAsyncHandler
type DefaultHttpHandler = class
interface IHttpAsyncHandler
interface IHttpHandler
Public Class DefaultHttpHandler
Implements IHttpAsyncHandler
- Arv
-
DefaultHttpHandler
- Implementeringar
Exempel
Följande kodexempel visar hur du implementerar en anpassad HTTP-hanterare genom att härleda från DefaultHttpHandler klassen.
public class AsyncDefaultHttpHandler : DefaultHttpHandler
{
private HttpContext _context;
public override IAsyncResult BeginProcessRequest(
HttpContext context, AsyncCallback callback, object state)
{
AsyncResultSample ar = new AsyncResultSample(callback, state);
_context = context;
return ar;
}
public override void EndProcessRequest(IAsyncResult result)
{
_context.Response.Write("EndProcessRequest called.");
}
// This method should not be called asynchronously.
public override void ProcessRequest(HttpContext context)
{
throw new InvalidOperationException(
"Asynchronous processing failed.");
}
// Enables pooling when set to true
public override bool IsReusable
{
get { return true; }
}
}
// Tracks state between the begin and end calls.
class AsyncResultSample : IAsyncResult
{
private AsyncCallback callback = null;
private Object asyncState;
private Boolean isCompleted;
internal AsyncResultSample(AsyncCallback cb, Object state)
{
this.callback = cb;
asyncState = state;
isCompleted = false;
}
public object AsyncState
{
get
{
return asyncState;
}
}
public bool CompletedSynchronously
{
get
{
return false;
}
}
public WaitHandle AsyncWaitHandle
{
get
{
throw new InvalidOperationException(
"ASP.NET should not use this property .");
}
}
public bool IsCompleted
{
get
{
return isCompleted;
}
}
internal void SetCompleted()
{
isCompleted = true;
if (callback != null)
{
callback(this);
}
}
}
Public Class defaulthttpexampleVB
Inherits DefaultHttpHandler
Private _context As HttpContext
Public Overrides Function BeginProcessRequest _
(ByVal context As HttpContext, _
ByVal callback As AsyncCallback, _
ByVal state As Object) As IAsyncResult
Dim ar As New AsyncResultSample(callback, state)
_context = context
Return (ar)
End Function
Public Overrides Sub EndProcessRequest(ByVal result As IAsyncResult)
_context.Response.Write("EndProcessRequest called.")
End Sub
' This method should not be called asynchronously.
Public Overrides Sub ProcessRequest(ByVal context As HttpContext)
Throw New InvalidOperationException _
("Asynchronous processing failed.")
End Sub
' Enables pooling when set to true
Public Overrides ReadOnly Property IsReusable() As Boolean
Get
Return True
End Get
End Property
End Class
' Tracks state between the begin and end calls.
Class AsyncResultSample
Implements IAsyncResult
Private callback As AsyncCallback = Nothing
Private _asyncState As Object
Private _isCompleted As Boolean
Friend Sub New(ByVal cb As AsyncCallback, ByVal state As Object)
Me.callback = cb
_asyncState = state
_isCompleted = False
End Sub
Public ReadOnly Property AsyncState() As Object _
Implements IAsyncResult.AsyncState
Get
Return _asyncState
End Get
End Property
Public ReadOnly Property CompletedSynchronously() _
As Boolean Implements IAsyncResult.CompletedSynchronously
Get
Return False
End Get
End Property
Public ReadOnly Property AsyncWaitHandle() _
As WaitHandle Implements IAsyncResult.AsyncWaitHandle
Get
Throw New InvalidOperationException _
("ASP.NET should not use this property .")
End Get
End Property
Public ReadOnly Property IsCompleted() _
As Boolean Implements IAsyncResult.IsCompleted
Get
Return IsCompleted
End Get
End Property
Friend Sub SetCompleted()
_isCompleted = True
If (callback <> Nothing) Then
callback(Me)
End If
End Sub
End Class
Kommentarer
Ett DefaultHttpHandler-objekt fångar upp inkommande begäranden i HTTP-pipelinen när båda begärandeavlyssning har konfigurerats via Internet Information Services (IIS) 6.0 och inga explicita bindningar gäller för det begärda tillägget.
Begärandeavlyssning kan konfigureras via funktionen för mappning av jokerteckenprogram som introducerades i IIS 6.0.
Klassen DefaultHttpHandler implementerar IHttpAsyncHandler gränssnittet för att tillhandahålla asynkron bearbetning av begäranden. Allmän information om HTTP-hanterare finns i Översikt över HTTP-hanterare och HTTP-moduler. Mer information finns dessutom i följande:
Information om hur du skapar asynkrona HTTP-hanterare finns i Genomgång: Skapa en asynkron HTTP-hanterare.
Information om hur du registrerar HTTP-hanterare finns i Så här registrerar du HTTP-hanterare.
Klasser kan härledas från DefaultHttpHandler klassen för att tillhandahålla anpassad hantering av begäranden. En asynkron HTTP-hanterare som härleds från DefaultHttpHandler kan åsidosätta BeginProcessRequest metoden för att ändra hur begäranden bearbetas.
En DefaultHttpHandler använder inte ASP.NET fel. Befintligt innehåll som använder IIS-fel eller en anpassad ISAPI-felmekanism för anständighet fungerar inte.
Konstruktorer
| Name | Description |
|---|---|
| DefaultHttpHandler() |
Initierar en ny instans av DefaultHttpHandler klassen. |
Egenskaper
| Name | Description |
|---|---|
| Context |
Hämtar kontexten som är associerad med det aktuella DefaultHttpHandler objektet. |
| ExecuteUrlHeaders |
Hämtar en samling begärandehuvuden och begärandevärden som ska överföras tillsammans med begäran. |
| IsReusable |
Hämtar ett booleskt värde som anger att en annan begäran kan använda den aktuella instansen DefaultHttpHandler av klassen. |
Metoder
| Name | Description |
|---|---|
| BeginProcessRequest(HttpContext, AsyncCallback, Object) |
Initierar ett asynkront anrop till HTTP-hanteraren. |
| EndProcessRequest(IAsyncResult) |
Tillhandahåller en slutmetod för en asynkron process. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnExecuteUrlPreconditionFailure() |
Anropas när förhandsvillkor hindrar objektet DefaultHttpHandler från att bearbeta en begäran. |
| OverrideExecuteUrlPath() |
Åsidosätter mål-URL:en för den aktuella begäran. |
| ProcessRequest(HttpContext) |
Gör att ett DefaultHttpHandler objekt kan bearbeta HTTP-webbbegäranden. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |