Count 
Integer = Application.Count
 
 

Gibt einen Integer zurück, der die Anzahl von Elementen angibt, die momentan in der Sammlung Application enthalten sind. Die Eigenschaft Count wird aus der durch die Klasse HttpApplicationState implementierten ICollection-Schnittstelle abgeleitet.

 
Parameter
  • Integer
      Eine Integervariable, die den Wert der Eigenschaft Count empfängt.
 
Beispiel

Dieses Beispiel fügt der Sammlung Application zwei Werte hinzu, zeigt die Anzahl von Elementen in der Sammlung Application an und verwendet dann die Eigenschaft Count als Schleifenkontrollwert, um jedes Element anzuzeigen:

 
Sub Page_Load(  )
   Application.Clear(  )
   Application("foo") = "Hello, "
   Application("bar") = "World!"
   Message.Text = "The Application collection contains " & _
      Application.Count & " items: "
      Dim I as Integer
      For I = 0 To Application.Count - 1
         Message.Text &= Application(I)
      Next
End Sub
 
Hinweise

Die Eigenschaft Count wurde in ASP.NET neu eingeführt. Sie können diese Eigenschaft nicht nur zum Durchlaufen der Sammlung Application verwenden, sondern damit auch protokollieren, wie viele Elemente eine Anwendung zu einem bestimmten Zeitpunkt enthält. Diese Informationen könnten dann für spätere Kontrollzwecke in ein Protokoll geschrieben werden.

Item 
Object = Application.Item(ByVal name As String)
Application.Item(ByVal name As String) = Object
Object = Application.Item(ByVal index As Integer)
Application.Item(ByVal index As Integer) = Object 
 
 

Gibt ein mit einem bestimmten Namen oder Index verknüpftes Objekt zurück oder legt es fest.

 
Parameter
  • Object
      Eine Variable eines beliebigen Typs (da letztlich alle .NET-Typen von Object abgeleitet werden), die den Wert des Elements empfängt oder festlegt.
  • name
      Ein Stringargument, das den Textschlüssel enthält, der auf das Element angewandt werden soll (oder anhand dessen das Element abgerufen werden soll).
  • index
      Ein Integerargument, das den Index des Elements enthält, dessen Wert abgerufen oder geändert wird.
 
Beispiel

Im folgenden Beispiel wird der Wert von zwei Elementen in der Sammlung Application festgelegt. Sind diese Elemente noch nicht in der Sammlung enthalten, werden sie hinzugefügt. Das Beispiel zeigt dann die beiden Werte an.

 
Sub Page_Load(  )
   Application.Clear(  )
   Application.Item("foo") = "foo"
   Application.Item("foo2") = "foo2"
   Message.Text = Application.Item("foo") & "<br/>"
   Message.Text &= Application.Item(1)
End Sub
 
Hinweise

Auf die Eigenschaft Item kann mit folgender Syntax implizit zugegriffen werden:

Application("foo") = "foo"

Diese Syntax taucht in ASP-Code häufig auf. Explizites Referenzieren der Eigenschaft Item ist nicht erforderlich. Der Code wird u.  U. aber leichter les- und nachvollziehbar, wenn Sie diese Eigenschaft auflisten und nicht nur implizit darauf zugreifen.

Ein Index kann nur als Argument verwendet werden, wenn ein Wert geändert wird, nicht wenn ein neues Element erstellt wird. Außerdem muss der Indexwert kleiner als die Anzahl von Elementen in der Sammlung Application sein, da sonst ein Ausnahmefehler ausgelöst wird.

 
AllKeys 
Dim StateVars(Application.Count) As String
StateVars = Application.AllKeys
 
 

Gibt ein Stringarray mit Schlüsselnamen zurück, die im HttpApplicationState-Objekt gespeichert sind.

 
Parameter
  • StateVars
      Eine Stringarray-Variable, die das Array mit Schlüsselnamen empfängt.
 
Beispiel

Dieses Beispiel zeigt alle Schlüssel der im Objekt Application gespeicherten Daten an:

 
Sub Page_Load(  )
   Dim I as Integer
   Dim StateVars(Application.Count - 1) As String
   StateVars = Application.AllKeys
   For I = 0 to StateVars.Length - 1
      Message.Text = Message.Text + StateVars(I) + "<br/>"
   Next I
End Sub 
 
Hinweise

Diese Eigenschaft liefert eine Liste von Schlüsselnamen, die allen aktuellen Anwendungsvariablen zugewiesen sind.

Contents 
HttpApplicationState = Application.Contents
 
 

Gibt eine Referenz zur aktuellen Instanz von HttpApplicationState zurück.

 
Parameter
  • HttpApplicationState
      Eine Variable des Typs HttpApplicationState, die die Contents-Referenz empfängt.
 
Beispiel

Dieses Beispiel ruft die Methode RemoveAll durch Referenz auf die Sammlung Contents auf und schreibt dann eine Meldung:

 
Sub Page_Load(  )
Application.Contents.RemoveAll(  )
Message.Text = "Removed all items from current Application."
End Sub
 
Hinweise

Diese Eigenschaft gewährleistet die Rückwärtskompatibilität mit ASP. Auf Eigenschaften wie Item und Methoden wie Remove und RemoveAll wird in ASP über die Eigenschaft Contents zugegriffen. In neuen ASP.NET-Entwicklungen sollten Sie auf diese Elemente direkt zugreifen. Anstatt z.  B. die Methode RemoveAll über die Eigenschaft Contents aufzurufen, können Sie die Methode RemoveAll direkt aufrufen:

Application.RemoveAll(  )
Keys 
KeysCollection = Application.Keys
 
 

Gibt eine NameObjectCollectionBase.KeysCollection mit den Stringschlüsseln zurück, die allen in der Sammlung Application enthaltenen Werten zugeordnet sind.

 
Parameter
  • KeysCollection
      Eine Variable des Typs NameObjectCollectionBase.KeysCollection, die den Wert der Eigenschaft Keys empfängt.
 
Beispiel

Mit diesem Beispiel wird die Sammlung der Schlüssel in der Sammlung Application durchlaufen und anschließend werden durch die Eigenschaft Text des Steuerelements Message der Name und der zugehörige Wert des Schlüssels angezeigt:

 
Sub Page_Load(  )
   Dim Key As String
   Message.Text = "Application Keys:"
   For Each Key in Application.Keys
      Message.Text &= "<br/>Key:&;&;&;" & Key
      Message.Text &= "<br/>Value:&;&;&;" & Application(Key)
   Next
End Sub
 
Hinweise

Die Eigenschaft Keys stellt eine der vielen Möglichkeiten dar, den Inhalt der Sammlung Application zu durchlaufen.

StaticObjects 
HttpStaticObjectsCollection = Application.StaticObjects 
 
 

Gibt eine HttpStaticObjectsCollection zurück, die alle in global.asax instanziierten Objekte enthält. Dazu wird die Syntax <object runat="server"> verwendet, wobei das Attribut scope auf Application gesetzt ist.

 
Parameter
  • HttpStaticObjectsCollection
      Eine Variable des Typs HttpStaticObjectsCollection, die den Wert der Eigenschaft StaticObjects empfängt.
 
Beispiel

Dieses Beispiel zeigt mithilfe der Eigenschaft Count der Klasse HttpStaticObjectsCollection die Anzahl von Objekten in der aktuellen Anwendung an, die mit der Syntax <object scope="Application" runat="server"/> in global.asax deklariert werden. Anschließend wird der Typ jedes Objekts ermittelt. Handelt es sich um ein Websteuerelement vom Typ TextBox, wird es zur Sammlung Controls der aktuellen Seite hinzugefügt.

 
Sub Page_Load(  )
   Message.Text = "There are " & Application.StaticObjects.Count & _
      " objects declared with the " & _
      "&lt;object runat=&quot;server&quot;&gt; syntax " & _
      "in Application scope."
   Dim myobj As Object
   For Each myObj in Application.StaticObjects
      If myObj.Value.GetType.ToString(  ) = _
         "System.Web.UI.WebControls.TextBox" Then
         Page.Controls.Add(myObj.Value)
      End If
   Next
End Sub
 
Hinweise

Diese Eigenschaft gewährleistet die Rückwärtskompatibilität mit ASP. Bedenken Sie vor der Instanziierung von Objekten auf Sitzungs- oder Anwendungsebene die Auswirkungen, die solche Objekte auf Ressourcen und die Skalierbarkeit von Anwendungen haben. In den meisten Fällen ist es ratsam, die Gültigkeit von Objekten auf einzelne Seiten zu beschränken. Jedes Objekt in der Sammlung wird durch die DictionaryEntry-Struktur repräsentiert. Auf den Schlüssel und den Wert kann nicht direkt zugegriffen werden. Verwenden Sie zum Zugriff auf den Schlüssel und/oder den Wert die Schlüssel- und/oder Wertelemente der DictionaryEntry-Struktur.

Add 
Application.Add(ByVal name As String, ByVal value As Object) 
 
 

Fügt der Sammlung Application einen Wert hinzu.

 
Parameter
  • Name
      Eine Variable des Typs String, die den Namen des Elements festlegt, das der Sammlung Application hinzugefügt werden soll.
  • Value
      Eine Variable des Typs Object, die den Namen des Elements enthält, das der Sammlung Application hinzugefügt werden soll.
 
Beispiel

Das folgende Beispiel fügt der Sammlung Application ein Element hinzu und zeigt es an:

 
Sub Page_Load(  )
   Application.Add("Added", "AddedValue")
   Message.Text = Application("Added")
End Sub
 
Hinweise

Die in ASP.NET neu hinzugekommene Methode Add bietet ein Verfahren, um Elemente der Sammlung Application hinzuzufügen, das mit dem Verfahren zum Hinzufügen von Elementen zu anderen .NET-Sammlungen konsistent ist. Natürlich können Sie weiterhin die herkömmliche ASP-Syntax zum direkten Indizieren des Application-Objekts über den Schlüsselnamen oder -index verwenden.

Clear 
Application.Clear(  )
 
 

Löscht den Inhalt der Sammlung Application.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel löscht den Inhalt der Sammlung Application und schreibt eine Meldung mit der aktuellen Anzahl der in der Sammlung enthaltenen Elemente an die Eigenschaft Text des Steuerelements Message. Die Anzahl sollte 0 sein.

 
Sub Page_Load(  )
   Application.Clear(  )
   Message.Text = "There are " & Application.Count & _
      " items in the Application collection."
End Sub
 
Hinweise

Die in ASP.NET neu hinzugekommene Methode Clear löscht nur den Inhalt der Sammlung Application selbst. Der Inhalt der Sammlung StaticObjects wird nicht gelöscht.

Get 
Application.Get(ByVal name As String)
Application.Get(ByVal Index As Integer)
 
 

Ruft ein Element der Sammlung Application nach seinem Namen oder nach seiner Positionsnummer (Index) in der Sammlung Application ab. Normalerweise wird der Name für Get-Aufrufe verwendet, es sei denn, Sie müssen Elemente der Sammlung in einer Schleife abrufen.

 
Parameter
  • name
      Eine Variable des Typs String, die den Namen des Elements angibt, das aus der Sammlung Application abgerufen werden soll.
  • Index
      Eine Variable des Typs Integer, die den Index des Elements angibt, das aus der Sammlung Application abgerufen werden soll.
 
Beispiel

Dieses Beispiel legt einen Wert fest und ruft ihn aus der Sammlung Application ab. Außerdem wird mit der Methode Get eine Meldung an die Eigenschaft Text des Steuerelements Message geschrieben, die den aktuellen Wert des der Sammlung Application neu hinzugefügten Werts enthält.

 
Sub Page_Load(  )
   Application("GetTest") = "Got it!"
   Message.Text = "GetTest = " & Application.Get("GetTest")
End Sub
 
Hinweise

Um zu ermitteln, ob ein Namenswert in der Sammlung Application gespeichert wird, müssen Sie sicherstellen, dass sein Wert nicht null ist, wie in folgendem Codebeispiel gezeigt:

If Not Application("Foo") is Nothing then
   Message.Text = "Foo is set to " & Application.Get("Foo")
End If
GetKey 
Application.GetKey(ByVal Index As Integer)
 
 

Ruft den Schlüsselnamen ab, der dem Index eines im Objekt Application gespeicherten Datenelements entspricht.

 
Parameter
  • Index
      Eine Variable des Typs Integer, die den Index des Schlüssels angibt, der aus der Sammlung Application abgerufen werden soll.
 
Beispiel

Dieses Beispiel entfernt alle Werte aus der Sammlung Application, um von einem bekannten Zustand aus zu beginnen. Anschließend wird ein einzelner Wert in die Sammlung Application geschrieben. Zum Schluss wird der Schlüssel des ersten Elements (Index 0) durch Aufruf von GetKey in das Steuerelement Message geschrieben.

 
Sub Page_Load(  )
   Application.RemoveAll(  )
   Application("GetKeyTest") = "Got it!"
   Message.Text = "Key of Application(0) = " & _
                   Application.GetKey(0) & _
                   "<br/>(Should be GetKeyTest)"
End Sub
 
Hinweise

Wenn Index kleiner als 0 oder größer als Application.Count - 1 ist, wird eine ArgumentOutOfRangeException ausgelöst.

Lock 
Application.Lock
 
 

Sperrt den Zugriff auf eine Application-Sammlung, um die Zugriffssynchronisation zu erleichtern.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel sperrt die Anwendung, setzt eine Variable zum Zählen der Ladevorgänge der Anwendungsseite, entsperrt die Anwendung und zeigt dann den Wert an:

 
Sub Page_Load(  )
   Application.Lock(  )
   Application("Counter") = Application("Counter") + 1
   Application.UnLock(  )
   Message.Text = "Counter = " & Application("Counter")
End Sub
 
Hinweise

In diesem Beispiel wird die Anwendung gesperrt; danach werden alle Vorgänge, die innerhalb der Sammlung Application Werte ändern, durchgeführt und die Anwendung wird dann so schnell wie möglich wieder entsperrt. Alle Schreibzugriffe auf die Sammlung Application können außerhalb der Aufrufe der Methoden Lock und Unlock problemlos stattfinden.

Remove 
Application.Remove(ByVal name As String)
 
 

Entfernt ein Element nach Namen aus der Sammlung Application.

 
Parameter
  • Name
      Ein Stringargument, das den Namen (Schlüssel) des zu entfernenden Elements enthält.
 
Beispiel

Dieses Beispiel ermittelt, ob die Sammlung Application ein Element mit dem Schlüssel "foo" enthält. Wenn ja, wird dieses Element entfernt und eine entsprechende Meldung angezeigt:

 
Sub Page_Load(  )
   If Not Application("foo") Is Nothing Then
      Application.Remove("foo")
      Message.Text = "Item 'foo' was removed."
   Else
      Message.Text = "Item 'foo' does not exist."
   End If
End Sub
 
Hinweise

Die Eigenschaft Remove gewährleistet die Rückwärtskompatibilität mit ASP. In ASP wird auf diese Methode über die Sammlung Contents zugegriffen. In ASP.NET kann auf diese Methode entweder, wie oben beschrieben, direkt oder über die Sammlung Contents zugegriffen werden.

RemoveAll 
Application.RemoveAll(  )
 
 

Entfernt alle Elemente aus der Sammlung Application.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel prüft, ob mindestens ein Element in der Sammlung Application enthalten ist. Wenn ja, wird die Sammlung über die Methode RemoveAll gelöscht.

 
Sub Page_Load(  )
   If Application.Count > 0 Then
      Application.RemoveAll(  )
      Message.Text = "Application collection cleared."
   Else
      Message.Text = "Application collection is already empty."
   End If
End Sub
 
Hinweise

Die Eigenschaft RemoveAll gewährleistet die Rückwärtskompatibilität mit ASP. In ASP wird auf diese Methode über die Sammlung Contents zugegriffen. In ASP.NET kann auf diese Methode entweder, wie oben beschrieben, direkt oder über die Sammlung Contents zugegriffen werden.

RemoveAt 
Application.RemoveAt(ByVal index As Integer) 
 
 

Entfernt ein Element anhand seines Index aus der Sammlung Application. Diese Methode ergänzt die Methode Remove, die Element anhand seines Schlüssels entfernt.

 
Parameter
  • Index
      Ein Integerargument mit der Indexposition des Elements, das aus der Sammlung Application entfernt werden soll.
 
Beispiel
 
Sub Page_Load(  )
   If Application.Count > 0 Then
      Application.RemoveAt(0)
      Message.Text = "The item at index 0 was removed."
   Else
      Message.Text = "The item at index 0 does not exist."
   End If
End Sub
 
Hinweise

Mit der Methode RemoveAt können Elemente anhand ihres Index (anstatt anhand ihres Schlüssels) aus der Sammlung Application entfernt werden. Wie im Beispiel oben werden alle auf das entfernte Element folgenden Elemente in der Sammlung um eine Position verschoben. Wenn Sie ein Element anhand seines Index entfernen und anschließend RemoveAt erneut mit demselben Index aufrufen, wird das direkt auf das zuvor entfernte Element folgende Element entfernt. Wenn die Sammlung Application nur ein einziges Element enthält und Sie RemoveAt zweimal aufrufen, wird eine ArgumentOutOfRangeException ausgelöst.

Set 
Application.Set(ByVal name As String, ByVal value As Object) 
 
 

Aktualisiert den Wert eines Objekts in der Sammlung Application. Mit dieser Methode können Sie Objekte in der Sammlung Application festlegen.

 
Parameter
  • Name
      Ein Stringargument mit dem Namen des Objekts, das in der Sammlung Application aktualisiert werden soll.
  • Value
      Ein Objektargument mit dem neuen Wert des zu aktualisierenden Objekts aus der Sammlung Application.
 
Beispiel

In diesem Beispiel wird Set zweimal verwendet: einmal, um ein neues Element in der Sammlung Application festzulegen und ein weiteres Mal, um seinen Wert zu ändern.

 
Sub Page_Load(  )
   Application.RemoveAll(  )
   Application.Set("TotallyNewVariable","Test!")
   Message.Text = "First: " + Application("TotallyNewVariable") + "<br/>"
   Application.Set("TotallyNewVariable","Test again!")
   Message.Text = Message.Text & "First after Set: " +
   Application("TotallyNewVariable") + "<br/>"
End Sub
 
Hinweise

Sie können mit Set der Sammlung Application Werte hinzufügen. In der Regel werden Sie dafür aber sicherlich die einfache Syntax verwenden, die Sie aus ASP kennen:

Application("TotallyNewVariable") = "Test!"
UnLock 
Application.UnLock
 
 

Hebt die Zugriffssperre für eine Application-Sammlung auf, um die Zugriffssynchronisation zu erleichtern.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel sperrt die Anwendung, setzt eine Variable zum Zählen der Ladevorgänge der Anwendungsseite, entsperrt die Anwendung und zeigt dann den Wert an:

 
Sub Page_Load(  )
   Application.Lock(  )
   Application("Counter") = Application("Counter") + 1
   Application.UnLock(  )
   Message.Text = "Counter = " & Application("Counter")
End Sub
 
Hinweise

In diesem Beispiel wird die Anwendung gesperrt; danach werden alle Vorgänge, die innerhalb der Sammlung Application Werte ändern, durchgeführt und die Anwendung wird dann so schnell wie möglich wieder entsperrt. Alle Schreibzugriffe auf die Sammlung Application können außerhalb der Aufrufe der Methoden Lock und Unlock problemlos stattfinden.

Start 
Sub Application_OnStart( )    'Event handler logic
End Sub
 
 

Wird ausgelöst, wenn die Anwendung erstellt wird. Die Ereignisbehandlungsroutine für dieses Ereignis sollte in der Anwendungsdatei global.asax definiert werden.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel schreibt einen Eintrag in das Ereignisprotokoll und das IIS-Protokoll der Anwendung, um anzuzeigen, dass das Ereignis Application_OnStart ausgelöst wurde:

 
<Script language="VB" runat="server">
   Sub Application_OnStart(  )
      Dim EventLog1 As New System.Diagnostics.EventLog ("Application", _
         ".", "mySource")
      EventLog1.WriteEntry("Application_OnStart fired!")
      Context.Response.AppendToLog("Application_OnStart fired!")
   End Sub
</script>

In diesem Codebeispiel verbirgt sich ein Problem. Da die Sicherheitsvorkehrungen in der Release-Version des .NET-Frameworks verschärft wurden, funktioniert das Schreiben in das Ereignisprotokoll in ASP.NET-Anwendungen standardmäßig nicht.

 
Hinweise

Das Ereignis Application_OnStart ist für Initialisierungsaufgaben beim Initialisieren der Anwendung nützlich. Sie können Anwendungsvariablen initialisieren, die hauptsächlich statisch sind.

End 
Sub Application_OnEnd(  )'Event handler logic
End Sub
 
 

Wird ausgelöst, wenn die Anwendung nicht mehr besteht, weil der Webserver angehalten oder die Datei global.asax geändert wurde. Die Ereignisbehandlungsroutine für dieses Ereignis sollte in der Anwendungsdatei global.asax definiert werden.

 
Parameter
Keine
 
Beispiel

Dieses Beispiel schreibt einen Eintag in das Ereignisprotokoll der Anwendung, um anzuzeigen, dass das Ereignis Application_OnEnd ausgelöst wurde.

 
<Script language="VB" runat="server">
   Sub Application_OnEnd(  )
      Dim EventLog1 As New System.Diagnostics.EventLog ("Application", _
         ".", "mySource")
      EventLog1.WriteEntry("Application_OnEnd fired!")
   End Sub
</script>
 
Hinweise

Das Ereignis End eignet sich für Löschvorgänge, wenn eine Anwendung beendet wird, weil der Webservice angehalten oder die Datei global.asax geändert wird.