StateBag.Add(String, Object) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將新 StateItem 物件加入至 StateBag 物件。 如果項目已經存在於 StateBag 物件中，則此方法會更新項目的值。

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

參數

key

String

StateItem 的屬性名稱。

value

Object

要加入至 StateBag 的項目值。

傳回

StateItem

傳回 StateItem，表示加入至檢視狀態的物件。

例外狀況

ArgumentException

key 為 null。

-或-

key 中的字元數目為 0。

範例

下列程式代碼範例示範如何使用 Add 方法。

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

另請參閱

• Item[String]
• Clear()
• Remove(String)
• ASP.NET 狀態管理建議