StateBag.Add(String, Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite