StateBag.Add(String, Object) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem StateItem-Objekt ein neues StateBag-Objekt hinzu. Wenn das Element bereits im StateBag-Objekt vorhanden ist, aktualisiert diese Methode den Wert des Elements.

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

Parameter

key: String

Der Attributname für das StateItem.

value: Object

Der Wert des Elements, das der StateBag hinzugefügt werden soll.

Gibt zurück

StateItem

Gibt ein StateItem zurück, das das dem Ansichtszustand hinzugefügte Objekt darstellt.

Ausnahmen

ArgumentException

key ist null.

- oder - Die Anzahl von Zeichen in key ist 0.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Add Methode veranschaulicht.

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

Gilt für