SqlConnection.Open Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll

Otwiera połączenie bazy danych z ustawieniami właściwości określonymi przez ConnectionStringelement .

public:
 override void Open();
public:
 virtual void Open();
public override void Open ();
public void Open ();
override this.Open : unit -> unit
abstract member Open : unit -> unit
override this.Open : unit -> unit
Public Overrides Sub Open ()
Public Sub Open ()

Implementuje

Open()

Wyjątki

InvalidOperationException

Nie można otworzyć połączenia bez określania źródła danych lub serwera.

lub

Połączenie jest już otwarte.

SqlException

Wystąpił błąd na poziomie połączenia podczas otwierania połączenia. Number Jeśli właściwość zawiera wartość 18487 lub 18488, oznacza to, że określone hasło wygasło lub musi zostać zresetowane. Aby uzyskać więcej informacji, zobacz metodę ChangePassword(String, String) .

Tag <system.data.localdb> w pliku app.config ma nieprawidłowe lub nieznane elementy.

ConfigurationErrorsException

W sekcji znajdują się dwa wpisy o tej samej nazwie <localdbinstances> .

Przykłady

Poniższy przykład tworzy obiekt SqlConnection, otwiera go i wyświetla niektóre jego właściwości. Połączenie jest automatycznie zamykane na końcu using bloku.

private static void OpenSqlConnection(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

Private Sub OpenSqlConnection(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Uwagi

Metoda SqlConnection pobiera otwarte połączenie z puli połączeń, jeśli jest dostępna. W przeciwnym razie ustanawia nowe połączenie z wystąpieniem SQL Server.

Uwaga

Jeśli zakres SqlConnection wykracza poza zakres, nie jest zamknięty. W związku z tym należy jawnie zamknąć połączenie, wywołując metodę Close.

Uwaga

W przypadku określenia numeru portu innego niż 1433 podczas próby nawiązania połączenia z wystąpieniem SQL Server i użyciem protokołu innego niż TCP/IP Open metoda kończy się niepowodzeniem. Aby określić numer portu innego niż 1433, dołącz ciąg "server=machinename", numer portu" w parametry połączenia i użyj protokołu TCP/IP.

Uwaga

.NET Framework Dostawca danych dla SQL Server wymaga uprawnień zabezpieczeń z włączonym ustawieniem "Zezwalaj na wywołania niezarządzanych zestawów" (SecurityPermissionz ustawioną wartością UnmanagedCodeSqlConnection ) w celu otwarcia elementu z SecurityPermissionFlag włączonym debugowaniem SQL.

Dotyczy

Zobacz też