StateBag.Add(String, Object) StateBag.Add(String, Object) StateBag.Add(String, Object) StateBag.Add(String, Object) Method

Definition

Fügt dem StateItem-Objekt ein neues StateBag-Objekt hinzu.Adds a new StateItem object to the StateBag object. Wenn das Element bereits im StateBag-Objekt vorhanden ist, aktualisiert diese Methode den Wert des Elements.If the item already exists in the StateBag object, this method updates the value of the item.

public:
 System::Web::UI::StateItem ^ Add(System::String ^ key, System::Object ^ value);
public System.Web.UI.StateItem Add (string key, object value);
member this.Add : string * obj -> System.Web.UI.StateItem
Public Function Add (key As String, value As Object) As StateItem

Parameter

key
String String String String

Der Attributname für das StateItem.The attribute name for the StateItem.

value
Object Object Object Object

Der Wert des Elements, das der StateBag hinzugefügt werden soll.The value of the item to add to the StateBag.

Gibt zurück

Gibt ein StateItem zurück, das das dem Ansichtszustand hinzugefügte Objekt darstellt.Returns a StateItem that represents the object added to view state.

Ausnahmen

key ist null.key is null.

- oder --or- Die Anzahl von Zeichen in key ist 0.The number of characters in key is 0.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der Add Methode.The following code example demonstrates using the Add method.

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."); 
   }
}
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

Gilt für:

Siehe auch