Udostępnij za pośrednictwem

SqlConnection Konstruktory

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Zestawy:
netstandard.dll, System.Data.SqlClient.dll
Pakiet:
System.Data.SqlClient v4.8.6

Inicjuje nowe wystąpienie klasy SqlConnection.

Przeciążenia

SqlConnection()

Inicjuje nowe wystąpienie klasy SqlConnection.
SqlConnection(String)

Inicjuje SqlConnection nowe wystąpienie klasy, gdy zostanie podany ciąg zawierający parametry połączenia.
SqlConnection(String, SqlCredential)

Inicjuje nowe wystąpienie SqlConnection klasy, biorąc pod uwagę parametry połączenia, które nie jest używane Integrated Security = true i SqlCredential obiekt, który zawiera identyfikator użytkownika i hasło.

SqlConnection()

Inicjuje nowe wystąpienie klasy SqlConnection.

public:
 SqlConnection();
public SqlConnection ();
Public Sub New ()

Przykłady

Poniższy przykład tworzy i otwiera obiekt SqlConnection.

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

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file, using the
    // System.Configuration.ConfigurationManager.ConnectionStrings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

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

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationManager.ConnectionStrings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Uwagi

Po utworzeniu nowego wystąpienia obiektu SqlConnection właściwości odczytu/zapisu są ustawione na następujące wartości początkowe, chyba że zostały one specjalnie ustawione przy użyciu skojarzonych słów kluczowych we ConnectionString właściwości .

Właściwości Wartość początkowa
ConnectionString pusty ciąg ("")
ConnectionTimeout 15
Database pusty ciąg ("")
DataSource pusty ciąg ("")

Wartość tych właściwości można zmienić tylko przy użyciu ConnectionString właściwości . Klasa SqlConnectionStringBuilder udostępnia funkcje tworzenia zawartości parametrów połączenia i zarządzania nimi.

Zobacz też

Dotyczy

SqlConnection(String)

Inicjuje SqlConnection nowe wystąpienie klasy, gdy zostanie podany ciąg zawierający parametry połączenia.

public:
 SqlConnection(System::String ^ connectionString);
public SqlConnection (string connectionString);
new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String)

Parametry

connectionString
String

Połączenie użyte do otwarcia bazy danych SQL Server.

Wyjątki

ArgumentException

Podana parametry połączenia argument nie powiodła się ConnectionString walidacji.

Przykłady

Poniższy przykład tworzy i otwiera obiekt SqlConnection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file, using the
    // System.Configuration.ConfigurationSettings.AppSettings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection(connectionString)

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Uwagi

Po utworzeniu nowego wystąpienia obiektu SqlConnection właściwości odczytu/zapisu są ustawione na następujące wartości początkowe, chyba że zostały one specjalnie ustawione przy użyciu skojarzonych słów kluczowych we ConnectionString właściwości .

Właściwości Wartość początkowa
ConnectionString connectionString
ConnectionTimeout 15
Database pusty ciąg ("")
DataSource pusty ciąg ("")

Wartość tych właściwości można zmienić tylko przy użyciu ConnectionString właściwości . Klasa SqlConnection udostępnia funkcje tworzenia zawartości parametrów połączenia i zarządzania nimi.

Zobacz też

Dotyczy

SqlConnection(String, SqlCredential)

Inicjuje nowe wystąpienie SqlConnection klasy, biorąc pod uwagę parametry połączenia, które nie jest używane Integrated Security = true i SqlCredential obiekt, który zawiera identyfikator użytkownika i hasło.

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String, credential As SqlCredential)

Parametry

connectionString
String

Parametry połączenia, które nie używają żadnego z następujących słów kluczowych parametry połączenia: Integrated Security = true, UserIdlub Password, lub, które nie używają .ContextConnection = true

credential
SqlCredential

Obiekt SqlCredential. Jeśli credential parametr ma wartość null, SqlConnection(String, SqlCredential) jest funkcjonalnie równoważny z parametrem SqlConnection(String).

Wyjątki

ArgumentException

Podana parametry połączenia argument nie powiodła się ConnectionString walidacji.

Zobacz też

Dotyczy