System.Data.SqlClient Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Der System.Data.SqlClient Namespace ist der .NET-Datenanbieter für SQL Server.
Important
Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Dieser Namespace dokumentiert den Legacyanbieter für vorhandene Anwendungen und .NET Framework-spezifische Szenarien, für die er erforderlich ist.
Klassen
| Name | Beschreibung |
|---|---|
| SqlAuthenticationInitializer |
Definiert das Kernverhalten von Authentifizierungsinitialisierern, die in der app.config-Datei registriert werden können, und stellt eine Basis für abgeleitete Klassen bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlAuthenticationParameters |
Stellt AD-Authentifizierungsparameter dar, die von einem Treiber an Authentifizierungsanbieter übergeben werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlAuthenticationProvider |
Definiert das Kernverhalten von Authentifizierungsanbietern und stellt eine Basisklasse für abgeleitete Klassen bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlAuthenticationToken |
Stellt ein AD-Authentifizierungstoken dar. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlBulkCopy |
Hiermit können Sie eine SQL Server Tabelle effizient mit Daten aus einer anderen Quelle laden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlBulkCopyColumnMapping |
Definiert die Zuordnung zwischen einer Spalte in der Datenquelle einer SqlBulkCopy Instanz und einer Spalte in der Zieltabelle der Instanz. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlBulkCopyColumnMappingCollection |
Auflistung von SqlBulkCopyColumnMapping Objekten, die von CollectionBase. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlClientFactory |
Stellt eine Reihe von Methoden zum Erstellen von Instanzen der System.Data.SqlClient Anbieterimplementierung der Datenquellenklassen dar. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlClientLogger |
Stellt einen SQL-Clientprotokollierer dar. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlClientMetaDataCollectionNames |
Stellt eine Liste der Konstanten für die Verwendung mit der GetSchema-Methode zum Abrufen von Metadatensammlungen bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlClientPermission |
Aktiviert den .NET Framework-Datenanbieter für SQL Server, um sicherzustellen, dass ein Benutzer über eine Sicherheitsstufe verfügt, die für den Zugriff auf eine Datenquelle ausreicht. Diese API unterstützt .NET Framework-Codezugriffssicherheit. Verwenden Sie für die neue Datenbankentwicklung Microsoft. Data.SqlClient; diese API für Anwendungen beibehalten, die .NET Framework-Codezugriffssicherheit erfordern. |
| SqlClientPermissionAttribute |
Ordnet eine Sicherheitsaktion einem benutzerdefinierten Sicherheitsattribute zu. Diese API unterstützt .NET Framework-Codezugriffssicherheit. Verwenden Sie für die neue Datenbankentwicklung Microsoft. Data.SqlClient; diese API für Anwendungen beibehalten, die .NET Framework-Codezugriffssicherheit erfordern. |
| SqlColumnEncryptionCertificateStoreProvider |
Die Implementierung des Schlüsselspeicheranbieters für Windows Zertifikatspeicher. Diese Klasse ermöglicht die Verwendung von Zertifikaten, die im Windows Zertifikatspeicher als Spaltenmasterschlüssel gespeichert sind. Ausführliche Informationen finden Sie unter Always Encrypted. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlColumnEncryptionCngProvider |
Die CMK Store-Anbieterimplementierung für die Verwendung der Microsoft Kryptografie-API: Next Generation (CNG) mit Always Encrypted. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlColumnEncryptionCspProvider |
Die CMK Store-Anbieterimplementierung für die Verwendung Microsoft CAPI-basierten Kryptografiedienstanbieter (CSP) mit Always Encrypted. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlColumnEncryptionEnclaveProvider |
Die Basisklasse, die die Schnittstelle für Enklavenanbieter für Always Encrypted definiert. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlColumnEncryptionKeyStoreProvider |
Die Basisklasse für alle Schlüsselspeicheranbieter. Ein benutzerdefinierter Anbieter muss von dieser Klasse abgeleitet und seine Memberfunktionen überschreiben und dann mithilfe von SqlConnection.RegisterColumnEncryptionKeyStoreProviders() registrieren. Ausführliche Informationen finden Sie unter "Always Encrypted". Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlCommand |
Stellt eine Transact-SQL -Anweisung oder gespeicherte Prozedur dar, die für eine SQL Server-Datenbank ausgeführt werden soll. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlCommandBuilder |
Generiert automatisch Einzeltabellenbefehle, die verwendet werden, um an einer DataSet vorgenommene Änderungen mit der zugeordneten SQL Server-Datenbank abzugleichen. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlConnection |
Stellt eine Verbindung mit einer SQL Server-Datenbank dar. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlConnectionStringBuilder |
Bietet eine einfache Möglichkeit zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen, die von der SqlConnection Klasse verwendet werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlCredential |
SqlCredential bietet eine sicherere Möglichkeit, das Kennwort für einen Anmeldeversuch mithilfe SQL Server Authentifizierung anzugeben. SqlCredential besteht aus einer Benutzer-ID und einem Kennwort, das für SQL Server Authentifizierung verwendet wird. Das Kennwort in einem SqlCredential Objekt ist vom Typ SecureString. SqlCredential kann nicht geerbt werden. Windows Authentifizierung ( Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlDataAdapter |
Stellt eine Reihe von Datenbefehlen und eine Datenbankverbindung dar, die verwendet wird, um die DataSet auszufüllen und eine SQL Server Datenbank zu aktualisieren. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlDataReader |
Bietet eine Möglichkeit zum Lesen eines Vorwärtsdatenstroms von Zeilen aus einer SQL Server-Datenbank. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SQLDebugging |
Zur Unterstützung von Debugginganwendungen enthalten. Nicht für die direkte Verwendung vorgesehen. Diese API unterstützt das Ältere .NET Framework-Debugging und ist nicht für die direkte Verwendung vorgesehen. Verwenden Sie für die neue Datenbankentwicklung Microsoft. Data.SqlClient. |
| SqlDependency |
Das objekt SqlDependency stellt eine Abfragebenachrichtigungsabhängigkeit zwischen einer Anwendung und einer Instanz von SQL Server dar. Eine Anwendung kann ein SqlDependency Objekt erstellen und registrieren, um Benachrichtigungen über den OnChangeEventHandler Ereignishandler zu empfangen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlEnclaveAttestationParameters |
Kapselt die Informationen, die SqlClient an SQL Server sendet, um den Prozess des Nachweiss und erstellen einer sicheren Sitzung mit der Enklave zu initiieren, SQL Server für Berechnungen auf Spalten verwendet wird, die mit Always Encrypted geschützt sind. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlEnclaveSession |
Kapselt den Zustand einer sicheren Sitzung zwischen SqlClient und einer Enklave in SQL Server, die für Berechnungen für verschlüsselte Spalten verwendet werden kann, die mit Always Encrypted geschützt sind. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlError |
Sammelt Informationen, die für eine Warnung oder einen Fehler relevant sind, die von SQL Server zurückgegeben werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlErrorCollection |
Sammelt alle Fehler, die vom .NET Framework-Datenanbieter für SQL Server generiert wurden. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlException |
Die Ausnahme, die ausgelöst wird, wenn SQL Server eine Warnung oder einen Fehler zurückgibt. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlInfoMessageEventArgs |
Stellt Daten für das InfoMessage-Ereignis bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlNotificationEventArgs |
Stellt den Satz von Argumenten dar, die an den Benachrichtigungsereignishandler übergeben werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlParameter |
Stellt einen Parameter zu einem SqlCommand und optional dessen Zuordnung zu Spalten dar DataSet . Diese Klasse kann nicht vererbt werden. Weitere Informationen zu Parametern finden Sie unter Konfigurieren von Parametern und Parameterdatentypen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlParameterCollection |
Stellt eine Auflistung von Parametern dar, die einer SqlCommand und ihren jeweiligen Zuordnungen zu Spalten in einer .DataSet Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlProviderServices |
Die DbProviderServices-Implementierung für den SqlClient-Anbieter für SQL Server. Behalten Sie diese API für den integrierten .NET Framework Entity Framework-Anbieter bei. Informationen zur neuen Datenbankentwicklung finden Sie unter Microsoft. Data.SqlClient. |
| SqlRowsCopiedEventArgs |
Stellt den Satz von Argumenten dar, die an die SqlRowsCopiedEventHandler. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlRowUpdatedEventArgs |
Stellt Daten für das RowUpdated-Ereignis bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlRowUpdatingEventArgs |
Stellt Daten für das RowUpdating-Ereignis bereit. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlTransaction |
Stellt eine Transact-SQL Transaktion dar, die in einer SQL Server Datenbank erfolgen soll. Diese Klasse kann nicht vererbt werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
Enumerationen
| Name | Beschreibung |
|---|---|
| ApplicationIntent |
Gibt einen Wert für ApplicationIntentan. Mögliche Werte sind Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| PoolBlockingPeriod |
Gibt einen Wert für die eigenschaft PoolBlockingPeriod an. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SortOrder |
Gibt an, wie Datenzeilen sortiert werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlAuthenticationMethod |
Beschreibt die verschiedenen SQL-Authentifizierungsmethoden, die von einem Client verwendet werden können, der eine Verbindung mit Azure SQL-Datenbank herstellt. Ausführliche Informationen finden Sie unter Connecting to SQL Database By Using Azure Active Directory Authentication. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlBulkCopyOptions |
Bitweise Kennzeichnung, die eine oder mehrere Optionen angibt, die mit einer Instanz von SqlBulkCopyverwendet werden sollen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlCommandColumnEncryptionSetting |
Gibt an, wie Daten gesendet und empfangen werden, wenn verschlüsselte Spalten gelesen und geschrieben werden. Je nach Ihrer spezifischen Abfrage kann die Leistung beeinträchtigt werden, indem die Verarbeitung des Always Encrypted-Treibers umgangen wird, wenn nicht verschlüsselte Spalten verwendet werden. Beachten Sie, dass diese Einstellungen nicht verwendet werden können, um Verschlüsselung zu umgehen und Zugriff auf Nur-Text-Daten zu erhalten. Ausführliche Informationen finden Sie unter Always Encrypted (Datenbank-Engine). Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlConnectionColumnEncryptionSetting |
Gibt an, dass die Always Encrypted-Funktion in einer Verbindung aktiviert ist. Beachten Sie, dass diese Einstellungen nicht verwendet werden können, um Verschlüsselung zu umgehen und Zugriff auf Nur-Text-Daten zu erhalten. Ausführliche Informationen finden Sie unter Always Encrypted (Datenbank-Engine). Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlNotificationInfo |
Diese Enumeration enthält zusätzliche Informationen zu den verschiedenen Benachrichtigungen, die vom Abhängigkeitsereignishandler empfangen werden können. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlNotificationSource |
Gibt die Quelle der Benachrichtigung an, die vom Abhängigkeitsereignishandler empfangen wurde. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlNotificationType |
Beschreibt die verschiedenen Benachrichtigungstypen, die von einem OnChangeEventHandler Ereignishandler über den SqlNotificationEventArgs-Parameter empfangen werden können. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
Delegaten
| Name | Beschreibung |
|---|---|
| OnChangeEventHandler |
Behandelt das OnChange Ereignis, das ausgelöst wird, wenn eine Benachrichtigung für einen der einem Objekt zugeordneten SqlDependency Befehle empfangen wird. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlInfoMessageEventHandler |
Stellt die Methode dar, die das InfoMessage Ereignis eines .SqlConnection Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlRowsCopiedEventHandler |
Stellt die Methode dar, die das SqlRowsCopied Ereignis eines .SqlBulkCopy Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlRowUpdatedEventHandler |
Stellt die Methode dar, die das RowUpdated Ereignis eines .SqlDataAdapter Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
| SqlRowUpdatingEventHandler |
Stellt die Methode dar, die das RowUpdating Ereignis eines .SqlDataAdapter Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient. |
Hinweise
Note
Die System.Data.SqlClient APIs sind veraltet. Verwenden Sie für die neue Entwicklung die APIs Microsoft.Data.SqlClient.
Die .NET Datenanbieter für SQL Server beschreibt eine Auflistung von Klassen, die für den Zugriff auf eine SQL Server-Datenbank im verwalteten Bereich verwendet werden. Mithilfe des Typs SqlDataAdapter", können Sie einen speicherresidenten DataSet Speicher ausfüllen, den Sie zum Abfragen und Aktualisieren der Datenbank verwenden können.
Note
Konzeptionelle Informationen zur Verwendung dieses Namespace bei der Programmierung mit .NET finden Sie unter SQL Server und ADO.NET.
