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

适用于

另请参阅