StateBag.Add(String, Object) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Hiermee voegt u een nieuw StateItem object toe aan het StateBag object. Als het item al in het StateBag object bestaat, wordt met deze methode de waarde van het item bijgewerkt.

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

Parameters

key
String

De kenmerknaam voor de StateItem.

value
Object

De waarde van het item dat moet worden toegevoegd aan de StateBag.

Retouren

StateItem

Retourneert een StateItem die het object vertegenwoordigt dat is toegevoegd aan de weergavestatus.

Uitzonderingen

ArgumentException

key is null.

– of –

Het aantal tekens in key is 0.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Add methode gebruikt.

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

Van toepassing op

Zie ook