UserControl.Session Property

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Gets the HttpSessionState object for the current Web request.

public:
 property System::Web::SessionState::HttpSessionState ^ Session { System::Web::SessionState::HttpSessionState ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.SessionState.HttpSessionState Session { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Session : System.Web.SessionState.HttpSessionState

Public ReadOnly Property Session As HttpSessionState

Property Value

HttpSessionState

An HttpSessionState object associated with the Page that contains the UserControl instance.

Attributes

BrowsableAttribute

Examples

The following example adds values to the Session property of a user control. The myControl.Session.Add syntax inserts the values of two TextBox Web server controls to the session associated with the user control and the page that contains it.

// Save state information which is used by display handler after the postback has occurred.
void SubmitBtn_Click(Object sender, EventArgs e) 
{
  // Clear all values from session state of 'Page'.
  Session.Clear();

  // Populate Session State of UserControl with the values entered by user.
  myControl.Session.Add("username",myControl.user.Text);
  myControl.Session.Add("password",myControl.password.Text);

  // Add UserControl state to the SessionState object of Page.
  Session[myControl.user.Text]= myControl;
  display.Enabled = true;
}

void Display_Click(Object sender, EventArgs e)
{
  int position = Session.Count - 1;

  // Extract stored UserControl from the session state of page.
  LogOnControl tempControl = (LogOnControl)Session[Session.Keys[position]];

  // Use SessionState of UserControl to display previously typed information.
  txtSession.Text = "<br /><br />User:" + tempControl.Session["username"] + "<br />Password : " + tempControl.Session["password"];
  display.Enabled = false;
}

' Saves state information which is used by display handler after the postback has occurred.

Sub SubmitBtn_Click(Sender As Object, e As EventArgs) 

    ' Clear all values from session state of 'Page'.
    Session.Clear()

    ' Populate Session State of UserControl with the values entered by user.
    myControl.Session.Add("username",myControl.user.Text)
    myControl.Session.Add("password",myControl.password.Text)

    ' Add UserControl state to the SessionState object of Page.
    Session(myControl.user.Text)= myControl
    Display.Enabled = true
End Sub

Sub Display_Click(Sender As Object,e As EventArgs)

    Dim position As Integer = Session.Count - 1

    ' Extract stored UserControl from the session state of page.
    Dim tempControl As LogOnControl = CType(Session(Session.Keys(position)),LogOnControl)

    ' Use SessionState of UserControl to display previously typed information.
    txtSession.Text = "<br /><br />User:" + tempControl.Session("username") + "<br />Password : " + tempControl.Session("password")
    Display.Enabled = false
End Sub

See also

• Session
• HttpSessionState
• Page and Application Context in ASP.NET Web Applications