SqlConnection Konstruktorok

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.SqlClient.dll
Szerelvény:
System.Data.dll

Inicializálja a SqlConnection osztály új példányát.

Túlterhelések

Name Description
SqlConnection()

Inicializálja a SqlConnection osztály új példányát.
SqlConnection(String)

Inicializálja a SqlConnection osztály új példányát, ha a kapcsolati karakterlánc tartalmazó sztringet ad meg.
SqlConnection(String, SqlCredential)

Inicializálja a SqlConnection osztály új példányát egy kapcsolati karakterlánc, amely nem használja a Integrated Security = true és a felhasználói azonosítót és jelszót tartalmazó SqlCredential objektumot.

SqlConnection()

Forrás:
System.Data.SqlClient.notsupported.cs

Inicializálja a SqlConnection osztály új példányát.

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

Példák

Az alábbi példa létrehoz és megnyit egy 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

Megjegyzések

Új példány létrehozásakor az olvasási/írási SqlConnection tulajdonságok a következő kezdeti értékekre vannak beállítva, kivéve, ha kifejezetten a ConnectionString tulajdonsághoz társított kulcsszavakat használják.

Tulajdonságok Kezdeti érték
ConnectionString üres sztring ("")
ConnectionTimeout 15
Database üres sztring ("")
DataSource üres sztring ("")

Ezeknek a tulajdonságoknak az értékét csak a tulajdonság használatával módosíthatja ConnectionString . Az SqlConnectionStringBuilder osztály a kapcsolati sztringek tartalmának létrehozására és kezelésére szolgál.

Lásd még

A következőre érvényes:

SqlConnection(String)

Forrás:
System.Data.SqlClient.notsupported.cs

Inicializálja a SqlConnection osztály új példányát, ha a kapcsolati karakterlánc tartalmazó sztringet ad meg.

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)

Paraméterek

connectionString
String

A SQL Server adatbázis megnyitásához használt kapcsolat.

Kivételek

ArgumentException

A megadott kapcsolati karakterlánc argumentum nem sikerült ConnectionString érvényesítése.

Példák

Az alábbi példa létrehoz és megnyit egy 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

Megjegyzések

Új példány létrehozásakor az olvasási/írási SqlConnection tulajdonságok a következő kezdeti értékekre vannak beállítva, kivéve, ha kifejezetten a ConnectionString tulajdonsághoz társított kulcsszavakat használják.

Tulajdonságok Kezdeti érték
ConnectionString connectionString
ConnectionTimeout 15
Database üres sztring ("")
DataSource üres sztring ("")

Ezeknek a tulajdonságoknak az értékét csak a tulajdonság használatával módosíthatja ConnectionString . Az SqlConnection osztály a kapcsolati sztringek tartalmának létrehozására és kezelésére szolgál.

Lásd még

A következőre érvényes:

SqlConnection(String, SqlCredential)

Forrás:
System.Data.SqlClient.notsupported.cs

Inicializálja a SqlConnection osztály új példányát egy kapcsolati karakterlánc, amely nem használja a Integrated Security = true és a felhasználói azonosítót és jelszót tartalmazó SqlCredential objektumot.

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)

Paraméterek

connectionString
String

Olyan kapcsolati karakterlánc, amely nem használja a következő kapcsolati karakterlánc kulcsszavak egyikét sem: Integrated Security = true, UserId vagy Password; vagy nem használja ContextConnection = true.

credential
SqlCredential

Egy SqlCredential objektum. Ha credential null, SqlConnection(String, SqlCredential) akkor funkcionálisan egyenértékű a SqlConnection(String).

Kivételek

ArgumentException

A megadott kapcsolati karakterlánc argumentum nem sikerült ConnectionString érvényesítése.

Lásd még

A következőre érvényes: