StateBag.Add(String, Object) Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

StateItem

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

Exceptions

ArgumentException

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 à