ViewStateException ViewStateException ViewStateException ViewStateException Class

Definition

Stellt die Ausnahme dar, die ausgelöst wird, wenn der Ansichtszustand nicht geladen oder validiert werden kann.Represents the exception that is thrown when the view state cannot be loaded or validated. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class ViewStateException sealed : Exception
[System.Serializable]
public sealed class ViewStateException : Exception
type ViewStateException = class
    inherit Exception
    interface ISerializable
Public NotInheritable Class ViewStateException
Inherits Exception
Vererbung
ViewStateExceptionViewStateExceptionViewStateExceptionViewStateException
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Methode implementieren, die eine Base64-codierte Zeichenfolge deserialisiert und eine ICollection Auflistung von Eigenschafts Einstellungen zurückgibt.The following code example demonstrates how to implement a method that deserializes a base64-encoded string and returns an ICollection collection of property settings. Die Deserialize -Methode kann eine HttpException Ausnahme auslösen, die ViewStateException ein-Objekt als innere Ausnahme enthält.The Deserialize method can throw an HttpException exception that contains a ViewStateException object as an inner exception. Das Beispiel zeigt, wie Sie eine HttpException Ausnahme abfangen und die Eigenschaften aus dem ViewStateException -Objekt abrufen können.The example shows how you can catch an HttpException exception and retrieve the properties from the ViewStateException object.

private ICollection LoadControlProperties(string serializedProperties)
{

    ICollection controlProperties = null;

    // Create an ObjectStateFormatter to deserialize the properties.
    ObjectStateFormatter formatter = new ObjectStateFormatter();

    try
    {
        // Call the Deserialize method.
        controlProperties = (ArrayList)formatter.Deserialize(serializedProperties);
    }
    catch (HttpException e)
    {
        ViewStateException vse = (ViewStateException)e.InnerException;
        String logMessage;

        logMessage = "ViewStateException. Path: " + vse.Path + Environment.NewLine;
        logMessage += "PersistedState: " + vse.PersistedState + Environment.NewLine;
        logMessage += "Referer: " + vse.Referer + Environment.NewLine;
        logMessage += "UserAgent: " + vse.UserAgent + Environment.NewLine;

        LogEvent(logMessage);

        if (vse.IsConnected)
        {
            HttpContext.Current.Response.Redirect("ErrorPage.aspx");
        }
        else
        {
            throw e;
        }
    }
    return controlProperties;
}
Private Function LoadControlProperties(ByVal serializedProperties As String) As ICollection

    Dim controlProperties As ICollection = Nothing

    ' Create an ObjectStateFormatter to deserialize the properties.
    Dim formatter As New ObjectStateFormatter()

    Try
        ' Call the Deserialize method.
        controlProperties = CType(formatter.Deserialize(serializedProperties), ArrayList)
    Catch e As HttpException
        Dim vse As ViewStateException
        Dim logMessage As String

        vse = e.InnerException

        logMessage = "ViewStateException. Path: " + vse.Path + Environment.NewLine
        logMessage += "PersistedState: " + vse.PersistedState + Environment.NewLine
        logMessage += "Referer: " + vse.Referer + Environment.NewLine
        logMessage += "UserAgent: " + vse.UserAgent + Environment.NewLine

        LogEvent(logMessage)

        If (vse.IsConnected) Then
            HttpContext.Current.Response.Redirect("ErrorPage.aspx")
        Else
            Throw e
        End If
    End Try
    Return controlProperties
End Function 'LoadControlProperties   

Hinweise

Wenn eine Ausnahme auftritt, wenn die Seite die Ansichts Zustandsinformationen lädt, erstellt die Seite ViewStateException ein-Objekt und übergibt es HttpException in einer Ausnahme als innere Ausnahme.If an exception occurs when the page loads the view-state information, the page creates a ViewStateException object and passes it as an inner exception within an HttpException exception. Die HttpException Ausnahme wird erneut ausgelöst, damit Sie von der Anwendung behandelt wird.The HttpException exception is re-thrown to be handled by the application.

Die ViewStateException -Klasse speichert Informationen über die Ausnahme in Message der-Eigenschaft.The ViewStateException class stores information about the exception in the Message property. Wenn die Anforderung über die Berechtigung zum zugreifen ServerVariables auf die-Eigenschaft Message verfügt, enthält die-Eigenschaft RemoteAddressdie Werte RemotePort, die PersistedStatevon Referer,, Path UserAgent,, und zurückgegeben werden. Eigenschaften Andernfalls enthält die Message -Eigenschaft eine generische Ansichts Zustands-Fehlermeldung.If the request has permission to access the ServerVariables property, then the Message property contains the values returned from the RemoteAddress, RemotePort, UserAgent, PersistedState, Referer, and Path properties; otherwise, the Message property contains a generic view-state error message.

Eine Ausnahme vom Typ "Ansichts Zustand" kann das Ergebnis eines Überprüfungs Fehlers der Message Authentication Codes (Mac) sein.A view-state exception can be the result of a Message Authentication Codes (MAC) validation error. Wenn das Page- enableViewStateMac Attribut auf truefestgelegt ist, werden die Ansichts Zustandsinformationen mit einem Mac-Bezeichner codiert.If the page attribute enableViewStateMac is set to true, view-state information is encoded with a MAC identifier. Wenn die Ansichts Zustandsinformationen an den Server zurückgesendet werden, überprüft die Seite die Codierung, um sicherzustellen, dass Sie nicht vom Benutzer geändert wurde.When the view-state information is posted back to the server, the page verifies the encoding to ensure that it has not been altered by the user. Wenn die Seite die MAC-Codierung für die Ansichts Zustandsinformationen nicht validieren kann, wird HttpException eine Ausnahme mit ViewStateException dem Objekt als innere Ausnahme ausgelöst.If the page cannot validate the MAC encoding on the view-state information, it will throw an HttpException exception with the ViewStateException object as an inner exception.

Damit die Mac-Überprüfung erfolgreich ist, müssen die Ansichts Zustandsinformationen beim Senden und empfangen des gleichen Schlüssels mit einem Hashwert versehen werden.For MAC validation to succeed, the view-state information must be hashed by the same key when it is sent and received. In einer Webfarm sollte der Computer Schlüssel auf jedem Server auf einen gemeinsamen Schlüssel festgelegt werden.Within a Web farm, the machine key on each server should be set to a common key.

Konstruktoren

ViewStateException() ViewStateException() ViewStateException() ViewStateException()

Initialisiert eine neue Instanz der ViewStateException-Klasse.Initializes a new instance of the ViewStateException class.

Eigenschaften

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
IsConnected IsConnected IsConnected IsConnected

Ruft einen Wert ab, der angibt, ob der Client gegenwärtig mit dem Server verbunden ist.Gets a value indicating whether the client is currently connected to the server.

Message Message Message Message

Ruft Debuginformationen zur HTTP-Anforderung ab, die zu einer Ansichtszustandsausnahme geführt hat.Gets debugging information about the HTTP request that resulted in a view-state exception.

Path Path Path Path

Ruft den Pfad der HTTP-Anforderung ab, die zu einer Ansichtszustandsausnahme geführt hat.Gets the path of the HTTP request that resulted in a view-state exception.

PersistedState PersistedState PersistedState PersistedState

Ruft den Inhalt der Zeichenfolge des Ansichtszustands ab, die beim Lesen die Ansichtszustandsausnahme verursacht hat.Gets the contents of the view-state string that, when read, caused the view-state exception.

Referer Referer Referer Referer

Ruft die URL der Seite ab, die mit der Seite verknüpft war, auf der die Ansichtszustandsausnahme aufgetreten ist.Gets the URL of the page that linked to the page where the view-state exception occurred.

RemoteAddress RemoteAddress RemoteAddress RemoteAddress

Ruft die IP-Adresse der HTTP-Anforderung ab, die zu einer Ansichtszustandsausnahme geführt hat.Gets the IP address of the HTTP request that resulted in a view-state exception.

RemotePort RemotePort RemotePort RemotePort

Ruft die Anschlussnummer der HTTP-Anforderung ab, die zu einer Ansichtszustandsausnahme geführt hat.Gets the port number of the HTTP request that resulted in a view-state exception.

Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)
UserAgent UserAgent UserAgent UserAgent

Ruft den Browsertyp der HTTP-Anforderung ab, die zu einer Ansichtszustandsausnahme geführt hat.Gets the browser type of the HTTP request that resulted in a view-state exception.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der ViewStateException-Klasse mit serialisierten Daten.Initializes a new instance of the ViewStateException class with serialized data.

GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für:

Siehe auch