StateBag.Add(String, Object) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá do objektu StateBag nový StateItem objekt. Pokud položka již existuje v objektu StateBag , 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 StateItempro .

value: Object

Hodnota položky, která se má přidat do StateBag.

Návraty

StateItem

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

Výjimky

ArgumentException

key je null.

-nebo-

Počet znaků v key souboru je 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

Sdílet prostřednictvím