Partager via


StateBag.Add(String, Object) Méthode

Définition

Ajoute un nouvel objet StateItem à l'objet StateBag. Si l'élément existe déjà dans l'objet StateBag, cette méthode met à jour la valeur de l'élément.

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

Paramètres

key
String

Nom d'attribut de l'objet StateItem.

value
Object

La valeur de l'élément à ajouter à StateBag.

Retours

Retourne un objet StateItem qui représente l'objet ajouté à l'état d'affichage.

Exceptions

key a la valeur null.

- ou -

Le nombre de caractères dans key est 0.

Exemples

L’exemple de code suivant illustre l’utilisation de la Add méthode .

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

S’applique à

Voir aussi