StateBag.Add(String, Object) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Aggiunge un nuovo oggetto StateItem all'oggetto StateBag. Se l'elemento è già presente nell'oggetto StateBag, questo metodo aggiorna il valore dell'elemento.

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

Parametri

key
String

Nome dell'attributo per l'oggetto StateItem.

value
Object

Valore dell'elemento da aggiungere all'oggetto StateBag.

Restituisce

StateItem

Restituisce un oggetto StateItem che rappresenta l'oggetto aggiunto allo stato di visualizzazione.

Eccezioni

ArgumentException

key è null.

-oppure-

Il numero di caratteri in key è 0.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del Add metodo .

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

Si applica a

Vedi anche