State Property (SqlConnection)

On this page

Gets the current state of the connection.

Syntax

Visual Basic
C#


'Declaration Public Shadows Property State As ConnectionState


public new ConnectionState State {get; set;}

Property Value

A bitwise combination of the System.Data.ConnectionState values. The default value is Closed.

Remarks

The allowed state changes are:

From Closed to Open, using the Open method of the SqlConnection object.
From Open to Closed, using either the Close method or the Dispose() method of the SqlConnection object.

Example

The following example creates an instance of a derived class, SqlConnection, sets its ConnectionString, and displays its State.

csharp


public void CreateSqlConnection() { SqlConnection myConnection = new SqlConnection(); myConnection.ConnectionString = "User Id=sa;Server=localhost;Initial Catalog=Test;"; myConnection.Open(); MessageBox.Show("Connection State: " + myConnection.State.ToString()); myConnection.Close(); }

public void CreateSqlConnection()
{
  SqlConnection myConnection = new SqlConnection();
  myConnection.ConnectionString = 
      "User Id=sa;Server=localhost;Initial Catalog=Test;";
  myConnection.Open();
  MessageBox.Show("Connection State: " + myConnection.State.ToString());
  myConnection.Close();
}

Visual Basic


Public Sub CreateSqlConnection() Dim myConnection As New SqlConnection() myConnection.ConnectionString = _ "User Id=sa;Server=localhost;Initial Catalog=Test;" myConnection.Open() MessageBox.Show("Connection State: " + myConnection.State.ToString()) myConnection.Close() End Sub

Public Sub CreateSqlConnection()
  Dim myConnection As New SqlConnection()
  myConnection.ConnectionString = _
      "User Id=sa;Server=localhost;Initial Catalog=Test;"
  myConnection.Open()
  MessageBox.Show("Connection State: " + myConnection.State.ToString())
  myConnection.Close()
End Sub

Reference

SqlConnection Class
SqlConnection Members
ConnectionString Property

Send Feedback