ServerConnection Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Management.Common

Rakitan:

Microsoft.SqlServer.ConnectionInfo.dll

Paket:

Microsoft.SqlServer.SqlManagementObjects v172.64.0

public sealed class ServerConnection : Microsoft.SqlServer.Management.Common.ConnectionManager, Microsoft.SqlServer.Management.Common.ISfcConnection

type ServerConnection = class
    inherit ConnectionManager
    interface ISfcConnection

Public NotInheritable Class ServerConnection
Inherits ConnectionManager
Implements ISfcConnection

Warisan

Object

ConnectionSettings

ConnectionManager

ServerConnection

Penerapan

ISfcConnection

Konstruktor

Nama	Deskripsi
ServerConnection()
ServerConnection(IRenewableToken)	Membuat objek ServerConnection yang mengambil token. Boolean tambahan digunakan untuk membebani konstruktor ini sebagai konstruktor lain dengan string ada.
ServerConnection(SqlConnection, IRenewableToken)	Membuat objek ServerConnection baru
ServerConnection(SqlConnection)	Membuat objek ServerConnection baru dari SqlConnection yang diberikan
ServerConnection(SqlConnectionInfo)
ServerConnection(String, String, SecureString)
ServerConnection(String, String, String)
ServerConnection(String)

Bidang

Nama	Deskripsi
NoConnectionTimeout	Tunggu tak terbatas (Diperoleh dari ConnectionSettings)

Properti

Nama	Deskripsi
AcceptsLogin	Mengembalikan true jika nilai saat ini untuk LoginSecure dan Autentikasi menggunakan properti Masuk (Diperoleh dari ConnectionSettings)
AccessToken	(Diperoleh dari ConnectionSettings)
ApplicationIntent	Niat aplikasi dari nilai Valid koneksi adalah ReadWrite dan ReadOnly (Diperoleh dari ConnectionSettings)
ApplicationName	Nama aplikasi. 'Manajemen SQL' jika tidak ada nama aplikasi yang disediakan. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
Authentication	Jenis autentikasi koneksi (Diperoleh dari ConnectionSettings)
AutoDisconnectMode	(Diperoleh dari ConnectionManager)
BatchSeparator	Menentukan pemisah batch yang digunakan oleh metode ExecuteNonQuery. Defaultnya adalah "GO". Pemisah batch tidak peka huruf besar/kecil.
CachedQueries	Mendapatkan atau menetapkan nilai yang menunjukkan apakah instans ServerConnection harus menyimpan hasil kueri
CapturedSql	(Diperoleh dari ConnectionManager)
ConnectAsUser	Jika diatur ke true, koneksi akan dibuat dengan kredensial pengguna yang ditentukan. Ini akan mengasumsikan peniruan, namun bendera LoginSecure dan bidang Login dan Kata Sandi tidak akan terpengaruh. Pengaturan ini hanya dapat digunakan pada Windows. (Diperoleh dari ConnectionSettings)
ConnectAsUserName	Menentukan pengguna Windows yang digunakan saat membuat koneksi yang ditiru. Pengguna harus memiliki hak masuk interaktif. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Diperoleh dari ConnectionSettings)
ConnectAsUserPassword	Menentukan kata sandi pengguna Windows yang digunakan saat membuat koneksi yang ditiru. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Diperoleh dari ConnectionSettings)
ConnectionProtocol	Protokol koneksi. (Diperoleh dari ConnectionManager)
ConnectionString	Properti akan mengembalikan pengguna yang ditentukan string koneksi atau akan mengembalikan string koneksi komputasi berdasarkan pengaturan objek. Jika diatur secara eksplisit, Semua properti dalam objek ServerConnection akan diisi untuk mencerminkan yang diteruskan dalam string koneksi. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
ConnectionType
ConnectTimeout	Lamanya waktu (dalam detik) untuk menunggu koneksi ke server sebelum mengakhiri upaya dan melemparkan pengecualian. Defaultnya adalah 30 detik (sama dengan Shiloh). Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
CurrentDatabase	Mengembalikan konteks database saat ini. (Diperoleh dari ConnectionManager)
DatabaseEngineEdition	Edisi Database Engine (Diperoleh dari ConnectionManager)
DatabaseEngineType	Mengembalikan jenis mesin database SQL Server. Pengecualian: ConnectionFailureException (Diperoleh dari ConnectionManager)
DatabaseName	TBD (Diperoleh dari ConnectionSettings)
EncryptConnection	apakah "encrypt=true" ditentukan dalam string koneksi (Diperoleh dari ConnectionSettings)
FixedServerRoles	Mengembalikan enum yang menentukan peran server tetap tempat login menjadi anggota.
HostNameInCertificate	Nama host yang disediakan dalam sertifikat yang akan digunakan untuk validasi sertifikat. (Diperoleh dari ConnectionSettings)
HostPlatform	Platform host server (Linux/Windows/dll) (Diperoleh dari ConnectionManager)
InUse	Mengembalikan true jika objek telah tersambung dengan server setidaknya sekali. Jika true, perubahan properti tidak diizinkan lagi dan ConnectionCannotBeChangedException akan dilemparkan ketika properti telah diubah. (Diperoleh dari ConnectionManager)
IsContainedAuthentication	Mengembalikan true jika mesin database mengautentikasi menggunakan autentikasi terkandung. Pengecualian: ConnectionFailureException (Diperoleh dari ConnectionManager)
IsForceDisconnected	Menunjukkan bahwa koneksi telah terputus secara paksa (Diperoleh dari ConnectionManager)
IsOpen	Mengembalikan true jika objek SqlConnection tersambung dengan server. Ini hanya dapat mengembalikan true untuk koneksi yang tidak dikumpulkan karena koneksi terkumpul selalu ditutup langsung setelah operasi. (Diperoleh dari ConnectionManager)
LockTimeout	LockTimeout adalah Batas waktu penguncian dalam hitung detik. -1 default adalah untuk tidak terbatas. InvalidPropertyValueException dilemparkan untuk semua angka negatif lainnya. LockTimeout Positif akan dikalikan dengan 1000 dan kemudian digunakan untuk pengaturan "SET LOCK_TIMEOUT". (Diperoleh dari ConnectionManager)
Login	Nama SQL Server Masuk yang digunakan untuk menyambungkan ke server. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Diperoleh dari ConnectionSettings)
LoginSecure	Jika diatur ke true, keamanan terintegrasi Windows digunakan dan Login dan Kata Sandi diabaikan. Jika tidak diatur, Autentikasi Sql Server digunakan. Pengecualian: ConnectionCannotBeChangedException (Diperoleh dari ConnectionSettings)
MaxPoolSize	Jumlah maksimum koneksi yang diizinkan dalam pool. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
MinPoolSize	Jumlah minimum koneksi yang dipertahankan di kolam. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
MultipleActiveResultSets	Aktifkan MARS dari koneksi. Secara default adalah false. (Diperoleh dari ConnectionSettings)
NetworkProtocol	Mengidentifikasi protokol jaringan klien yang digunakan untuk menyambungkan ke SQL Server. Jika Anda tidak menentukan jaringan dan Anda menggunakan server lokal, memori bersama akan digunakan. Jika Anda tidak menentukan jaringan dan menggunakan server jarak jauh, salah satu protokol klien yang dikonfigurasi akan digunakan. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
NonPooledConnection	Secara default, semua koneksi ke SQL Server diambil dari kumpulan koneksi ADO.NET. Jika diatur ke true, ini memungkinkan pengguna untuk membuat koneksi yang tidak terkumpul (tidak akan digunakan kembali ketika ditutup). Pengecualian: ConnectionCannotBeChangedException (Diperoleh dari ConnectionSettings)
PacketSize	Ukuran dalam byte paket jaringan yang digunakan untuk berkomunikasi dengan instans SQL Server. Defaultnya adalah 8192. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
ParameterizationMode	Mendapatkan atau menetapkan nilai yang menunjukkan QueryParameterizationMode queryParameterizationMode yang digunakan semua instans ServerConnection
Password	Kata sandi yang digunakan dengan Masuk untuk menyambungkan ke server. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Diperoleh dari ConnectionSettings)
PooledConnectionLifetime	Ketika koneksi dikembalikan ke kumpulan, waktu pembuatannya dibandingkan dengan waktu saat ini, dan koneksi dihancurkan jika rentang waktu tersebut (dalam detik) melebihi nilai yang ditentukan oleh masa pakai koneksi. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
ProcessID	Properti ProcessID mengembalikan pengidentifikasi proses SQL Server untuk koneksi yang digunakan oleh objek ServerConnection.
ProductVersion	Mendapatkan properti server ProductVersion dari koneksi ini (Diperoleh dari ConnectionManager)
RequiresLogin	Mengembalikan true jika nilai saat ini untuk LoginSecure dan Autentikasi memerlukan properti Masuk untuk diatur (Diperoleh dari ConnectionSettings)
ResetConnectionString	Memberi tahu kami apakah ConnectionString perlu diatur ulang di properti SqlConnectionObject connectionManager atau tidak. (Diperoleh dari ConnectionSettings)
SecureConnectionString	Properti akan mengembalikan versi SecureString dari pengguna yang ditentukan string koneksi atau akan mengembalikan string koneksi komputasi berdasarkan pengaturan objek. Jika diatur secara eksplisit, Semua properti dalam objek ServerConnection akan diisi untuk mencerminkan yang diteruskan dalam string koneksi. Pengecualian: ConnectionCannotBeChangedException (Diperoleh dari ConnectionSettings)
SecurePassword	Kata sandi yang digunakan dengan Masuk untuk menyambungkan ke server. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (Diperoleh dari ConnectionSettings)
ServerCertificate	Jalur ke sertifikat server yang akan digunakan untuk validasi sertifikat. (Diperoleh dari ConnectionSettings)
ServerInstance	Nama SQL Server objek akan tersambung. Jika tidak diatur, server lokal tersirat. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)
ServerVersion	Mengembalikan nomor versi utama SQL Server. Yaitu 8 untuk SQL Server 2000. Pengecualian: ConnectionFailureException (Diperoleh dari ConnectionManager)
SqlConnectionObject	Mengembalikan referensi ke objek SqlConnection yang digunakan oleh objek ConnectionContext. Ini harus selalu mengembalikan objek sqlConnection yang valid dengan kumpulan ConnectionString terbaru yang valid. Pengecualian: PropertyNotAvailableException (Diperoleh dari ConnectionManager)
SqlExecutionModes	Menentukan apakah pernyataan SQL diambil atau dikirim ke server.
StatementTimeout	Ini adalah jumlah detik bahwa pernyataan dicoba dikirim ke server sebelum gagal. Defaultnya adalah 600 detik (sama dengan Shiloh). Pengecualian: InvalidPropertyValueException
StrictEncryption	Apakah "encrypt=strict" ditentukan dalam string koneksi. Jika true, nilai EncryptConnection diabaikan. (Diperoleh dari ConnectionSettings)
TransactionDepth	Menyediakan kedalaman transaksi sebagaimana dihitung oleh model objek. Ini tidak termasuk transaksi apa pun yang mungkin telah dimulai di server, atau dengan mengeluarkan BEGIN TRAN dengan metode ExecuteNonQuery.
TrueLogin	Properti TrueLogin mengembalikan nama catatan masuk yang digunakan oleh koneksi saat ini.
TrueName	Properti TrueName mengembalikan kumpulan hasil @@INSTANCENAME fungsi global Microsoft ® SQL Server.
TrustServerCertificate	Menunjukkan apakah klien mempercayai sertifikat server (Diperoleh dari ConnectionSettings)
UseMode	Mendapatkan atau mengatur penggunaan semua instans DeferredUseMode ServerConnection UseMode
UserProfile	Properti UserProfile mengembalikan deskripsi peran tingkat tinggi untuk login Microsoft SQL Server yang digunakan oleh koneksi saat ini.
WorkstationId	Nama stasiun kerja yang tersambung ke SQL Server. Pengecualian: ConnectionCannotBeChangedException InvalidPropertyValueException (Diperoleh dari ConnectionSettings)

Metode

Nama	Deskripsi
BeginTransaction()	Memulai transaksi baru. Jika CaptureMode benar, pernyataan transaksi akan ditambahkan ke buffer pengambilan. Dimungkinkan untuk menumpuk transaksi. Pengguna bertanggung jawab untuk menerapkan atau memutar kembali setiap transaksi yang dibuka. Tidak dijamin bahwa semua T-SQL yang dipancarkan oleh model objek, dapat dienkapsulasi oleh transaksi. Selain itu, status objek yang telah diubah tidak akan mencerminkan status database aktual sampai transaksi dilakukan atau setelah transaksi digulung balik. Pengguna bertanggung jawab untuk me-refresh objek yang terpengaruh. Gunakan dengan hati-hati.
Cancel()
ChangePassword(SecureString)
ChangePassword(String)
CheckServerVersion(ServerVersion)	Periksa apakah kami menyambungkan ke versi server yang didukung. block off <= 7.0 di ServerConnection. (Diperoleh dari ConnectionManager)
CommitTransaction()	Melakukan transaksi. Jika CaptureMode benar, perintah transaksi akan ditambahkan ke buffer pengambilan. Pengecualian: NotInTransactionException
Connect()	Membuat koneksi aktual ke SQL Server. Diabaikan jika sudah tersambung. Adalah opsional untuk memanggil metode ini, karena koneksi akan dibuka jika diperlukan. Pengecualian: ConnectionFailureException (Diperoleh dari ConnectionManager)
Copy()	Fungsi ini melakukan salinan mendalam
Disconnect()	Menutup koneksi dengan SQL Server. Diabaikan jika sudah terputus. Pengecualian: ConnectionFailureException (Diperoleh dari ConnectionManager)
ExecuteNonQuery(String, ExecutionTypes, Boolean)	Menjalankan pernyataan T-SQL. Termininator perintah ('GO') dikenali oleh ExecuteNonQuery. Batch akan dikirim dan dijalankan satu per satu. Pernyataan direkam dan tidak dijalankan jika CaptureMode telah diatur ke true. Nilai int dikembalikan yang berisi jumlah baris yang terpengaruh. Jika beberapa batch dijalankan, jumlah total baris yang terpengaruh dari semua batch dikembalikan. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String, ExecutionTypes)	Menjalankan pernyataan T-SQL. Termininator perintah ('GO') dikenali oleh ExecuteNonQuery. Batch akan dikirim dan dijalankan satu per satu. Pernyataan direkam dan tidak dijalankan jika CaptureMode telah diatur ke true. Nilai int dikembalikan yang berisi jumlah baris yang terpengaruh. Jika beberapa batch dijalankan, jumlah total baris yang terpengaruh dari semua batch dikembalikan. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String)
ExecuteNonQuery(StringCollection, ExecutionTypes, Boolean)	Menjalankan pernyataan T-SQL dalam StringCollection. Termininator perintah ('GO') dikenali oleh ExecuteNonQuery. Batch yang dipisahkan dengan pernyataan GO akan dikirim dan dijalankan secara individual. Pernyataan direkam dan tidak dijalankan jika CaptureMode telah diatur ke true. Array nilai int dikembalikan yang berisi jumlah baris yang terpengaruh untuk setiap pernyataan dalam StringCollection. Jika beberapa batch dijalankan, jumlah total baris yang terpengaruh dari semua batch dikembalikan. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection, ExecutionTypes)	Menjalankan pernyataan T-SQL dalam StringCollection. Termininator perintah ('GO') dikenali oleh ExecuteNonQuery. Batch yang dipisahkan dengan pernyataan GO akan dikirim dan dijalankan secara individual. Pernyataan direkam dan tidak dijalankan jika CaptureMode telah diatur ke true. Array nilai int dikembalikan yang berisi jumlah baris yang terpengaruh untuk setiap pernyataan dalam StringCollection. Jika beberapa batch dijalankan, jumlah total baris yang terpengaruh dari semua batch dikembalikan. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection)
ExecuteReader(String, SqlCommand)	Menjalankan pernyataan T-SQL. Objek SqlDataReader dikembalikan yang dapat digunakan untuk membaca aliran baris yang dikembalikan oleh SQL Server. Objek SqlCommand juga dikembalikan yang dapat digunakan untuk membatalkan pipa pembaca data jika pembatalan kueri yang berjalan lama diperlukan. tidak secara otomatis memutuskan Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteReader(String)	Menjalankan pernyataan T-SQL. Objek SqlDataReader dikembalikan yang dapat digunakan untuk membaca aliran baris yang dikembalikan oleh SQL Server. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. tidak secara otomatis memutuskan Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(String)	Menjalankan pernyataan T-SQL. Objek dikembalikan yang berisi kolom pertama dari baris pertama dari kumpulan hasil. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(StringCollection)	Menjalankan pernyataan T-SQL dalam StringCollection. Array objek dikembalikan yang masing-masing berisi kolom pertama dari baris pertama dari kumpulan hasil dari setiap pernyataan yang dijalankan. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	Menjalankan T-SQL menggunakan metode yang sesuai tergantung pada informasi tindakan yang diteruskan sebagai parameter . (Diperoleh dari ConnectionManager)
ExecuteWithResults(String, Boolean)	Menjalankan pernyataan T-SQL di sqlCommand. Himpunan Data dikembalikan yang berisi hasilnya. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(String)	Menjalankan pernyataan T-SQL di sqlCommand. Himpunan Data dikembalikan yang berisi hasilnya. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(StringCollection)	Menjalankan pernyataan T-SQL dalam StringCollection. Array Himpunan Data dikembalikan yang berisi hasil untuk setiap pernyataan dalam StringCollection. Metode Connect() akan dipanggil jika koneksi dengan server tidak terbuka. Pengecualian: ConnectionFailureException ExecutionFailureExeception
ForceDisconnected()	Memberlakukan pemutusan sambungan dan memastikan bahwa koneksi tidak dapat dibuka kembali (Diperoleh dari ConnectionManager)
GetDatabaseConnection(String, Boolean, IRenewableToken)	Mengembalikan koneksi yang memiliki nama database yang ditentukan dalam string koneksi Jika koneksi saat ini sudah mereferensikan database yang diberikan, koneksi saat ini dikembalikan.
GetDatabaseConnection(String, Boolean)	Mengembalikan koneksi yang memiliki nama database yang ditentukan dalam string koneksi. Jika koneksi saat ini sudah mereferensikan database yang diberikan, koneksi saat ini dikembalikan.
IsInFixedServerRole(FixedServerRoles)	Pengujian jika login adalah anggota dari salah satu peran server yang ditentukan.
NormalizeQuery(String, Boolean)	Menerjemahkan kueri dengan literal yang disematkan ke formulir yang dinormalisasi (semua literal digantikan oleh token standar)
NormalizeQuery(String)	Kelebihan beban untuk fungsi di atas -- lihat untuk detailnya
RollBackTransaction()	Membatalkan transaksi (semua perubahan yang dilakukan tidak akan disimpan ke database). Jika CaptureMode benar, perintah transaksi akan ditambahkan ke buffer pengambilan. Pengecualian: NotInTransactionException
ThrowIfPropertyNotSet(String, String, Boolean)	(Diperoleh dari ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	(Diperoleh dari ConnectionSettings)
ToString()	(Diperoleh dari ConnectionSettings)

Acara

Nama	Deskripsi
InfoMessage	Terjadi ketika SQL Server mengembalikan pesan peringatan atau informasi. Menggunakan SqlClient.SqlInfoMessageEventHandler. (Diperoleh dari ConnectionManager)
RemoteLoginFailed	Dipanggil ketika server perlu terhubung ke server jarak jauh dan login gagal (Diperoleh dari ConnectionManager)
ServerMessage	Terjadi ketika SQL Server mengembalikan pesan peringatan atau informasi. Menggunakan SqlClient.SqlInfoMessageEventHandler. (Diperoleh dari ConnectionManager)
StateChange	Terjadi ketika status koneksi berubah. Menggunakan System.Data.StateChangeEventHandler. (Diperoleh dari ConnectionManager)
StatementExecuted	(Diperoleh dari ConnectionManager)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ISfcConnection.Connect()
ISfcConnection.Copy()
ISfcConnection.Disconnect()
ISfcConnection.ServerVersion
ISfcConnection.ToEnumeratorObject()