SqlConnection.Open Metoda

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Źródło:
System.Data.SqlClient.notsupported.cs

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

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

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

Note

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

Note

Jeśli określisz numer portu inny niż 1433 podczas próby nawiązania połączenia z wystąpieniem SQL Server i przy użyciu protokołu innego niż TCP/IP, metoda Open zakończy się niepowodzeniem. Aby określić numer portu inny niż 1433, dołącz "server=machinename,numer portu" w parametry połączenia i użyj protokołu TCP/IP.

Note

.NET Framework Dostawca danych dla SQL Server wymaga uprawnień zabezpieczeń z włączonym ustawieniem "Zezwalaj na wywołania niezarządzanych zestawów" (SecurityPermission z włączoną SecurityPermissionFlag ustawioną na UnmanagedCode), aby otworzyć SqlConnection z włączonym debugowaniem SQL.

Dotyczy

Zobacz też