SqlConnection Klasa

Definicja

Reprezentuje połączenie z bazą danych SQL Server.Represents a connection to a SQL Server database. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable
public ref class SqlConnection sealed : System::Data::Common::DbConnection
public ref class SqlConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable
public sealed class SqlConnection : System.Data.Common.DbConnection
public sealed class SqlConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
type SqlConnection = class
    inherit DbConnection
    interface ICloneable
type SqlConnection = class
    inherit DbConnection
type SqlConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface ICloneable
type SqlConnection = class
    inherit DbConnection
    interface IDbConnection
    interface ICloneable
    interface IDisposable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Public NotInheritable Class SqlConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Dziedziczenie
SqlConnection
Dziedziczenie
Dziedziczenie
Implementuje

Przykłady

Poniższy przykład tworzy SqlCommand i SqlConnection.The following example creates a SqlCommand and a SqlConnection. SqlConnection jest otwarty i ustawiany jako Connection dla SqlCommand.The SqlConnection is opened and set as the Connection for the SqlCommand. Przykład następnie wywołuje ExecuteNonQuery.The example then calls ExecuteNonQuery. Aby to osiągnąć, ExecuteNonQuery jest przekazywać parametry połączenia i ciąg zapytania, który jest Transact-SQLTransact-SQL instrukcji INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is a Transact-SQLTransact-SQL INSERT statement. Połączenie jest zamykane automatycznie, gdy kod opuszcza blok przy użyciu.The connection is closed automatically when the code exits the using block.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}
Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Uwagi

Obiekt SqlConnection reprezentuje unikatową sesję do SQL Server źródła danych.A SqlConnection object represents a unique session to a SQL Server data source. W przypadku systemu bazy danych klienta/serwera jest on odpowiednikiem połączenia sieciowego z serwerem.With a client/server database system, it is equivalent to a network connection to the server. SqlConnection jest używany razem z SqlDataAdapter i SqlCommand w celu zwiększenia wydajności podczas łączenia się z bazą danych Microsoft SQL Server.SqlConnection is used together with SqlDataAdapter and SqlCommand to increase performance when connecting to a Microsoft SQL Server database. W przypadku wszystkich produktów innych firm SQL Server i innych obsługiwanych przez OLE DB źródeł danych Użyj OleDbConnection.For all third-party SQL Server products and other OLE DB-supported data sources, use OleDbConnection.

Podczas tworzenia wystąpienia SqlConnectionwszystkie właściwości są ustawiane na wartości początkowe.When you create an instance of SqlConnection, all properties are set to their initial values. Aby uzyskać listę tych wartości, zobacz Konstruktor SqlConnection.For a list of these values, see the SqlConnection constructor.

Zobacz ConnectionString, aby uzyskać listę słów kluczowych w parametrach połączenia.See ConnectionString for a list of the keywords in a connection string.

Jeśli SqlConnection wykracza poza zakres, nie zostanie zamknięty.If the SqlConnection goes out of scope, it won't be closed. W związku z tym należy jawnie zamknąć połączenie, wywołując Close lub Dispose.Therefore, you must explicitly close the connection by calling Close or Dispose. Close i Dispose są funkcjonalnie równoważne.Close and Dispose are functionally equivalent. Jeśli wartość puli połączeń Pooling jest ustawiona na true lub yes, połączenie podstawowe zostanie zwrócone z powrotem do puli połączeń.If the connection pooling value Pooling is set to true or yes, the underlying connection is returned back to the connection pool. Z drugiej strony, jeśli Pooling jest ustawiona na false lub no, podstawowe połączenie z serwerem jest w rzeczywistości zamknięte.On the other hand, if Pooling is set to false or no, the underlying connection to the server is actually closed.

Uwaga

Zdarzenia logowania i wylogowywania nie będą zgłaszane na serwerze, gdy połączenie zostanie pobrane z lub zwrócone do puli połączeń, ponieważ połączenie nie jest faktycznie zamknięte, gdy zostanie zwrócone do puli połączeń.Login and logout events will not be raised on the server when a connection is fetched from or returned to the connection pool, because the connection is not actually closed when it is returned to the connection pool. Aby uzyskać więcej informacji, zobacz SQL Servering pooling (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

Aby upewnić się, że połączenia są zawsze zamknięte, otwórz połączenie wewnątrz bloku using, jak pokazano w poniższym fragmencie kodu.To ensure that connections are always closed, open the connection inside of a using block, as shown in the following code fragment. Dzięki temu połączenie jest automatycznie zamykane, gdy kod opuszcza blok.Doing so ensures that the connection is automatically closed when the code exits the block.

Using connection As New SqlConnection(connectionString)
    connection.Open()
    ' Do work here; connection closed on following line.
End Using

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }

Uwaga

Aby wdrożyć aplikacje o wysokiej wydajności, należy użyć puli połączeń.To deploy high-performance applications, you must use connection pooling. W przypadku korzystania z .NET Framework Dostawca danych do SQL Server nie ma potrzeby włączania puli połączeń, ponieważ dostawca ten zarządza automatycznie, chociaż można modyfikować niektóre ustawienia.When you use the .NET Framework Data Provider for SQL Server, you do not have to enable connection pooling because the provider manages this automatically, although you can modify some settings. Aby uzyskać więcej informacji, zobacz SQL Servering pooling (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

Jeśli SqlException jest generowana przez metodę wykonującą SqlCommand, SqlConnection pozostaje otwarta, gdy poziom ważności wynosi 19 lub mniej.If a SqlException is generated by the method executing a SqlCommand, the SqlConnection remains open when the severity level is 19 or less. Gdy poziom ważności wynosi 20 lub więcej, serwer zazwyczaj zamyka SqlConnection.When the severity level is 20 or greater, the server ordinarily closes the SqlConnection. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować pracę.However, the user can reopen the connection and continue.

Aplikacja, która tworzy wystąpienie obiektu SqlConnection może wymagać, aby wszyscy niebezpośrednie i pośrednie wywołujące mieli wystarczające uprawnienia do kodu przez ustawienie deklaratywnych lub bezwzględnych wymagań w zakresie zabezpieczeń.An application that creates an instance of the SqlConnection object can require all direct and indirect callers to have sufficient permission to the code by setting declarative or imperative security demands. SqlConnection wykonuje wymagania dotyczące zabezpieczeń przy użyciu obiektu SqlClientPermission.SqlConnection makes security demands using the SqlClientPermission object. Użytkownicy mogą sprawdzić, czy ich kod ma wystarczające uprawnienia przy użyciu obiektu SqlClientPermissionAttribute.Users can verify that their code has sufficient permissions by using the SqlClientPermissionAttribute object. Użytkownicy i Administratorzy mogą również używać Caspol. exe (Narzędzie zasad zabezpieczeń dostępu kodu) do modyfikowania zasad zabezpieczeń na poziomie komputera, użytkownika i przedsiębiorstwa.Users and administrators can also use the Caspol.exe (Code Access Security Policy Tool) to modify security policy at the machine, user, and enterprise levels. Aby uzyskać więcej informacji, zobacz zabezpieczenia w programie .NET.For more information, see Security in .NET. Aby zapoznać się z przykładem dotyczącym sposobu korzystania z wymagań dotyczących zabezpieczeń, zobacz zabezpieczenia dostępu kodu i ADO.NET.For an example demonstrating how to use security demands, see Code Access Security and ADO.NET.

Aby uzyskać więcej informacji na temat obsługi ostrzeżeń i komunikatów informacyjnych z serwera, zobacz zdarzenia połączenia.For more information about handling warning and informational messages from the server, see Connection Events. Aby uzyskać więcej informacji na temat błędów aparatu SQL Server i komunikatów o błędach, zobacz zdarzenia i błędy aparatu bazy danych.For more information about SQL Server engine errors and error messages, see Database Engine Events and Errors.

Przestroga

Zamiast pamięci współdzielonej można wymusić protokół TCP.You can force TCP instead of shared memory. Można to zrobić przez prefiks protokołu TCP: do nazwy serwera w parametrach połączenia lub można użyć localhost.You can do that by prefixing tcp: to the server name in the connection string or you can use localhost.

Konstruktory

SqlConnection()

Inicjuje nowe wystąpienie klasy SqlConnection.Initializes a new instance of the SqlConnection class.

SqlConnection(String)

Inicjuje nowe wystąpienie klasy SqlConnection, gdy podano ciąg, który zawiera ciąg połączenia.Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

SqlConnection(String, SqlCredential)

Inicjuje nowe wystąpienie klasy SqlConnection przy użyciu parametrów połączenia, które nie używają Integrated Security = true i obiektu SqlCredential zawierającego identyfikator użytkownika i hasło.Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

Właściwości

AccessToken

Pobiera lub ustawia token dostępu dla połączenia.Gets or sets the access token for the connection.

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
ClientConnectionId

Identyfikator połączenia ostatniej próby połączenia, niezależnie od tego, czy próba zakończyła się powodzeniem, czy niepowodzeniem.The connection ID of the most recent connection attempt, regardless of whether the attempt succeeded or failed.

ColumnEncryptionKeyCacheTtl

Pobiera lub ustawia wartość czasu wygaśnięcia dla wpisów klucza szyfrowania kolumny w pamięci podręcznej kluczy szyfrowania kolumn dla funkcji Always Encrypted .Gets or sets the time-to-live for column encryption key entries in the column encryption key cache for the Always Encrypted feature. Wartość domyślna to 2 godziny.The default value is 2 hours. 0 oznacza brak buforowania.0 means no caching at all.

ColumnEncryptionQueryMetadataCacheEnabled

Pobiera lub ustawia wartość wskazującą, czy buforowanie metadanych zapytania jest włączone (true) czy nie (false) dla zapytań parametrycznych uruchomionych dla Always Encrypted włączonych baz danych.Gets or sets a value that indicates whether query metadata caching is enabled (true) or not (false) for parameterized queries running against Always Encrypted enabled databases. Wartością domyślną jest true.The default value is true.

ColumnEncryptionTrustedMasterKeyPaths

Umożliwia ustawienie listy zaufanych ścieżek kluczy dla serwera bazy danych.Allows you to set a list of trusted key paths for a database server. Jeśli podczas przetwarzania zapytania aplikacji sterownik otrzymuje ścieżkę klucza, która nie znajduje się na liście, zapytanie zakończy się niepowodzeniem.If while processing an application query the driver receives a key path that is not on the list, the query will fail. Ta właściwość zapewnia dodatkową ochronę przed atakami na zabezpieczenia, które obejmują złamane SQL Server zapewniające fałszywe ścieżki kluczy, co może prowadzić do przecieku poświadczeń magazynu kluczy.This property provides additional protection against security attacks that involve a compromised SQL Server providing fake key paths, which may lead to leaking key store credentials.

ConnectionString

Pobiera lub ustawia ciąg używany do otwierania bazy danych SQL Server.Gets or sets the string used to open a SQL Server database.

ConnectionTimeout

Pobiera czas oczekiwania (w sekundach) podczas próby nawiązania połączenia przed zakończeniem próby i wygenerowaniem błędu.Gets the time to wait (in seconds) while trying to establish a connection before terminating the attempt and generating an error.

Container

Pobiera IContainer, który zawiera Component.Gets the IContainer that contains the Component.

(Odziedziczone po Component)
Credential

Pobiera lub ustawia obiekt SqlCredential dla tego połączenia.Gets or sets the SqlCredential object for this connection.

Credentials
Database

Pobiera nazwę bieżącej bazy danych lub bazę danych, która ma zostać użyta po otwarciu połączenia.Gets the name of the current database or the database to be used after a connection is opened.

DataSource

Pobiera nazwę wystąpienia SQL Server, z którym ma zostać nawiązane połączenie.Gets the name of the instance of SQL Server to which to connect.

DbProviderFactory

Pobiera DbProviderFactory dla tego DbConnection.Gets the DbProviderFactory for this DbConnection.

(Odziedziczone po DbConnection)
DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Component.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
FireInfoMessageEventOnUserErrors

Pobiera lub ustawia właściwość FireInfoMessageEventOnUserErrors.Gets or sets the FireInfoMessageEventOnUserErrors property.

PacketSize

Pobiera rozmiar (w bajtach) pakietów sieciowych używanych do komunikowania się z wystąpieniem SQL Server.Gets the size (in bytes) of network packets used to communicate with an instance of SQL Server.

ServerVersion

Pobiera ciąg zawierający wersję wystąpienia SQL Server, do którego jest podłączony klient.Gets a string that contains the version of the instance of SQL Server to which the client is connected.

Site

Pobiera lub ustawia ISite Component.Gets or sets the ISite of the Component.

(Odziedziczone po Component)
State

Wskazuje stan SqlConnection podczas ostatniej operacji sieciowej wykonanej w ramach połączenia.Indicates the state of the SqlConnection during the most recent network operation performed on the connection.

StatisticsEnabled

Po ustawieniu na true, program włącza zbieranie statystyk dla bieżącego połączenia.When set to true, enables statistics gathering for the current connection.

WorkstationId

Pobiera ciąg identyfikujący klienta bazy danych.Gets a string that identifies the database client.

Metody

BeginDbTransaction(IsolationLevel)

Gdy jest zastępowany w klasie pochodnej, uruchamia transakcję bazy danych.When overridden in a derived class, starts a database transaction.

(Odziedziczone po DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie uruchamia transakcję bazy danych.Asynchronously starts a database transaction.

(Odziedziczone po DbConnection)
BeginTransaction()

Uruchamia transakcję bazy danych.Starts a database transaction.

BeginTransaction(IsolationLevel)

Uruchamia transakcję bazy danych o określonym poziomie izolacji.Starts a database transaction with the specified isolation level.

BeginTransaction(IsolationLevel, String)

Uruchamia transakcję bazy danych z określonym poziomem izolacji i nazwą transakcji.Starts a database transaction with the specified isolation level and transaction name.

BeginTransaction(String)

Uruchamia transakcję bazy danych o określonej nazwie transakcji.Starts a database transaction with the specified transaction name.

BeginTransactionAsync(CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

(Odziedziczone po DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

(Odziedziczone po DbConnection)
ChangeDatabase(String)

Zmienia bieżącą bazę danych otwartej SqlConnection.Changes the current database for an open SqlConnection.

ChangeDatabaseAsync(String, CancellationToken)

Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia.Asynchronously changes the current database for an open connection.

(Odziedziczone po DbConnection)
ChangePassword(String, SqlCredential, SecureString)

Zmienia SQL Server hasło dla użytkownika wskazanego w obiekcie SqlCredential.Changes the SQL Server password for the user indicated in the SqlCredential object.

ChangePassword(String, String)

Zmienia SQL Server hasło dla użytkownika wskazanego w parametrach połączenia na dostarczone nowe hasło.Changes the SQL Server password for the user indicated in the connection string to the supplied new password.

ClearAllPools()

Opróżnia pulę połączeń.Empties the connection pool.

ClearPool(SqlConnection)

Opróżnia pulę połączeń skojarzoną z określonym połączeniem.Empties the connection pool associated with the specified connection.

Close()

Zamyka połączenie z bazą danych.Closes the connection to the database. Jest to preferowana metoda zamykania dowolnego otwartego połączenia.This is the preferred method of closing any open connection.

CloseAsync()

Asynchronicznie zamyka połączenie z bazą danych.Asynchronously closes the connection to the database.

(Odziedziczone po DbConnection)
CreateCommand()

Tworzy i zwraca obiekt SqlCommand skojarzony z SqlConnection.Creates and returns a SqlCommand object associated with the SqlConnection.

CreateDbCommand()

Gdy jest zastępowany w klasie pochodnej, tworzy i zwraca obiekt DbCommand skojarzony z bieżącym połączeniem.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

(Odziedziczone po DbConnection)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose() (Odziedziczone po DbConnection)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean) (Odziedziczone po DbConnection)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie nakłada obiekt połączenia.Asynchronously diposes the connection object.

(Odziedziczone po DbConnection)
EnlistDistributedTransaction(ITransaction)

Rejestrowanie w określonej transakcji jako transakcja rozproszona.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

Rejestrowanie w określonej transakcji jako transakcja rozproszona.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

Rejestracja w określonej transakcji.Enlists in the specified transaction.

(Odziedziczone po DbConnection)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetSchema()

Zwraca informacje o schemacie dla źródła danych tego SqlConnection.Returns schema information for the data source of this SqlConnection. Aby uzyskać więcej informacji na temat schematu, zobacz SQL Server kolekcje schematów.For more information about scheme, see SQL Server Schema Collections.

GetSchema()

Zwraca informacje o schemacie dla źródła danych tego DbConnection.Returns schema information for the data source of this DbConnection.

(Odziedziczone po DbConnection)
GetSchema(String)

Zwraca informacje o schemacie dla źródła danych tego SqlConnection przy użyciu określonego ciągu dla nazwy schematu.Returns schema information for the data source of this SqlConnection using the specified string for the schema name.

GetSchema(String)

Zwraca informacje o schemacie dla źródła danych tego DbConnection przy użyciu określonego ciągu dla nazwy schematu.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

(Odziedziczone po DbConnection)
GetSchema(String, String[])

Zwraca informacje o schemacie dla źródła danych tego SqlConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.Returns schema information for the data source of this SqlConnection using the specified string for the schema name and the specified string array for the restriction values.

GetSchema(String, String[])

Zwraca informacje o schemacie dla źródła danych tego DbConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

(Odziedziczone po DbConnection)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Container.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Podnosi zdarzenie StateChange.Raises the StateChange event.

(Odziedziczone po DbConnection)
Open()

Otwiera połączenie z bazą danych z ustawieniami właściwości określonymi przez ConnectionString.Opens a database connection with the property settings specified by the ConnectionString.

OpenAsync()

Asynchroniczna wersja Open(), która otwiera połączenie z bazą danych z ustawieniami określonymi przez ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Ta metoda wywołuje metodę wirtualną OpenAsync(CancellationToken) z CancellationToken. None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbConnection)
OpenAsync(CancellationToken)

Asynchroniczna wersja Open(), która otwiera połączenie z bazą danych z ustawieniami właściwości określonymi przez ConnectionString.An asynchronous version of Open(), which opens a database connection with the property settings specified by the ConnectionString. Tokenu anulowania można użyć do żądania, aby operacja została porzucona przed upływem limitu czasu połączenia.The cancellation token can be used to request that the operation be abandoned before the connection timeout elapses. Wyjątki będą propagowane za pośrednictwem zwracanego zadania.Exceptions will be propagated via the returned Task. Jeśli upłynie limit czasu połączenia bez pomyślnego połączenia, zwrócone zadanie zostanie oznaczone jako błędne z wyjątkiem.If the connection timeout time elapses without successfully connecting, the returned Task will be marked as faulted with an Exception. Implementacja zwraca zadanie bez blokowania wątku wywołującego dla połączeń w puli i nienależących do puli.The implementation returns a Task without blocking the calling thread for both pooled and non-pooled connections.

OpenAsync(CancellationToken)

Jest to asynchroniczna wersja Open().This is the asynchronous version of Open(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania można opcjonalnie przyjąć.The cancellation token can optionally be honored.

Implementacja domyślna wywołuje synchroniczne wywołanie Open() i zwraca ukończone zadanie.The default implementation invokes the synchronous Open() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone już anulowane cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez otwarcie będą przekazywane za pośrednictwem Właściwości zwróconego wyjątku zadania.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbConnection, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Odziedziczone po DbConnection)
RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>)

Rejestruje dostawców magazynu kluczy szyfrowania kolumn.Registers the column encryption key store providers.

ResetStatistics()

Jeśli zbieranie danych statystycznych jest włączone, wszystkie wartości są resetowane do zera.If statistics gathering is enabled, all values are reset to zero.

RetrieveStatistics()

Zwraca kolekcję par wartości nazw statystyk w punkcie w czasie, gdy metoda jest wywoływana.Returns a name value pair collection of statistics at the point in time the method is called.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
ToString()

Zwraca String zawierający nazwę Component, jeśli istnieje.Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie metody Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)
InfoMessage

Występuje, gdy SQL Server zwraca komunikat ostrzegawczy lub informacyjny.Occurs when SQL Server returns a warning or informational message.

StateChange

Występuje, gdy zmienia się stan połączenia.Occurs when the state of the connection changes.

StateChange

Występuje, gdy zmienia się stan połączenia.Occurs when the state of the connection changes.

(Odziedziczone po DbConnection)

Jawne implementacje interfejsu

ICloneable.Clone()

Tworzy nowy obiekt, który jest kopią bieżącego wystąpienia.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.Begins a database transaction.

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.Begins a database transaction.

(Odziedziczone po DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych o określonej wartości IsolationLevel.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych o określonym poziomie izolacji.Begins a database transaction with the specified isolation level.

(Odziedziczone po DbConnection)
IDbConnection.CreateCommand()

Tworzy i zwraca obiekt polecenia, który jest skojarzony z połączeniem.Creates and returns a Command object that is associated with the connection.

IDbConnection.CreateCommand()

Tworzy i zwraca obiekt DbCommand, który jest skojarzony z bieżącym połączeniem.Creates and returns a DbCommand object that is associated with the current connection.

(Odziedziczone po DbConnection)

Dotyczy

Zobacz też