StateBag.Add-Methode

Fügt dem StateBag-Objekt ein neues StateItem-Objekt hinzu. Wenn das Element bereits im StateBag-Objekt vorhanden ist, aktualisiert diese Methode den Wert des Elements.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function Add ( _
    key As String, _
    value As Object _
) As StateItem
'Usage
Dim instance As StateBag
Dim key As String
Dim value As Object
Dim returnValue As StateItem

returnValue = instance.Add(key, value)

public StateItem Add (
    string key,
    Object value
)

public:
StateItem^ Add (
    String^ key, 
    Object^ value
)

public StateItem Add (
    String key, 
    Object value
)

public function Add (
    key : String, 
    value : Object
) : StateItem

Parameter

• key
  Der Attributname für das StateItem.

• value
  Der Wert des Elements, das der StateBag hinzugefügt werden soll.

Rückgabewert

Gibt ein StateItem zurück, das das dem Ansichtszustand hinzugefügte Objekt darstellt.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	key ist NULL (Nothing in Visual Basic). - oder - Die Anzahl von Zeichen in key ist 0.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der Add-Methode veranschaulicht.

Sub MovePiece(fromPosition As String, toPosition As String)
   Dim bag As StateBag = ViewState
   Dim piece As Object = bag(fromPosition)
   If Not (piece Is Nothing) Then
      bag.Remove(fromPosition)
      bag.Add(toPosition, piece)
      RenderBoard()
   Else
      Throw New InvalidPositionException("There is no game piece at the ""from"" position.")
   End If
End Sub 'MovePiece

void MovePiece(string fromPosition, string toPosition) {
   StateBag bag = ViewState;
   object piece = bag[fromPosition];
   if (piece != null) {
      bag.Remove(fromPosition);
      bag.Add(toPosition, piece);
      RenderBoard();
   }
   else {
      throw new InvalidPositionException("There is no game piece at the \"from\" position."); 
   }
}

function MovePiece(fromPosition : String, toPosition : String) {
   var bag : StateBag = ViewState;
   var piece = bag[fromPosition];
   if (piece != null) {
      bag.Remove(fromPosition);
      bag.Add(toPosition, piece);
      RenderBoard();
   }
   else {
      throw new InvalidPositionException("There is no game piece at the \"from\" position."); 
   }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

StateBag-Klasse
StateBag-Member
System.Web.UI-Namespace
Item
Clear
Remove

Weitere Ressourcen

Empfehlungen zur ASP.NET-Zustandsverwaltung