StateBag.Add(String, Object) Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Přidá do objektu StateItem nový StateBag objekt. Pokud položka již v objektu StateBag existuje, tato metoda aktualizuje hodnotu položky.

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

Parametry

key
String

Název atributu StateItem.

value
Object

Hodnota položky, kterou chcete přidat do objektu StateBag.

Návraty

StateItem

StateItem Vrátí hodnotu, která představuje objekt přidaný do zobrazení stavu.

Výjimky

ArgumentException

key je null.

nebo

Počet znaků je key 0.

Příklady

Následující příklad kódu ukazuje použití Add metody.

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

Platí pro

Viz také