RelationalOptionsExtension Kelas

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore.Infrastructure

Rakitan:

Microsoft.EntityFrameworkCore.Relational.dll

Paket:

Microsoft.EntityFrameworkCore.Relational v8.0.0

Mewakili opsi yang dikelola oleh penyedia database relasional. Opsi ini diatur menggunakan DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension

Warisan

Object

RelationalOptionsExtension

Penerapan

IDbContextOptionsExtension

Keterangan

Instans kelas ini dirancang agar tidak dapat diubah. Untuk mengubah opsi, panggil salah satu dari 'With...' metode untuk mendapatkan instans baru dengan opsi diubah.

Lihat Implementasi penyedia dan ekstensi database untuk informasi dan contoh selengkapnya.

Konstruktor

RelationalOptionsExtension()	Membuat sekumpulan opsi baru dengan semuanya diatur ke nilai default.
RelationalOptionsExtension(RelationalOptionsExtension)	Dipanggil oleh konstruktor kelas turunan saat menerapkan Clone() metode .

Properti

CommandTimeout	Batas waktu perintah, atau null jika tidak ada yang ditetapkan.
Connection	DbConnection, atau null jika string koneksi digunakan alih-alih objek koneksi penuh.
ConnectionString	string koneksi, atau null jika DbConnection digunakan alih-alih string koneksi.
ExecutionStrategyFactory	Pabrik untuk membuat default IExecutionStrategy, atau null jika tidak ada yang dikonfigurasi.
Info	Informasi/metadata tentang ekstensi.
IsConnectionOwned	trueConnection jika dimiliki oleh konteks dan harus dibuang dengan tepat.
MaxBatchSize	Jumlah maksimum pernyataan yang akan disertakan dalam perintah yang dikirim ke database selama SaveChanges() atau null jika tidak ada yang ditetapkan.
MigrationsAssembly	Nama rakitan yang berisi migrasi, atau null jika tidak ada yang ditetapkan.
MigrationsHistoryTableName	Nama tabel yang digunakan untuk tabel riwayat migrasi, atau null jika tidak ada yang ditetapkan.
MigrationsHistoryTableSchema	Skema yang digunakan untuk tabel riwayat migrasi, atau null jika tidak ada yang ditetapkan.
MinBatchSize	Jumlah minimum pernyataan yang diperlukan untuk perintah multi-pernyataan yang dikirim ke database selama SaveChanges() atau null jika tidak ada yang ditetapkan.
QuerySplittingBehavior	yang QuerySplittingBehavior digunakan saat memuat koleksi terkait dalam kueri.
UseRelationalNulls	Menunjukkan apakah akan menggunakan semantik database relasional atau tidak saat membandingkan nilai null. Secara default, Entity Framework akan menggunakan semantik C# untuk nilai null, dan menghasilkan SQL untuk mengimbangi perbedaan dalam cara database menangani null.

Metode

ApplyServices(IServiceCollection)	Menambahkan layanan yang diperlukan untuk membuat opsi yang dipilih berfungsi. Ini digunakan ketika tidak ada eksternal IServiceProvider dan EF mempertahankan penyedia layanannya sendiri secara internal. Ini memungkinkan penyedia database (dan ekstensi lain) untuk mendaftarkan layanan yang diperlukan ketika EF membuat penyedia layanan.
Clone()	Ambil alih metode ini dalam kelas turunan untuk memastikan bahwa setiap kloning yang dibuat juga dari kelas tersebut.
Extract(IDbContextOptions)	Menemukan yang sudah ada RelationalOptionsExtension yang terdaftar pada opsi yang diberikan atau melempar jika belum ada yang terdaftar. Ini biasanya digunakan untuk menemukan beberapa konfigurasi relasional ketika diketahui bahwa penyedia relasional sedang digunakan.
Validate(IDbContextOptions)	Memberi ekstensi kesempatan untuk memvalidasi bahwa semua opsi dalam ekstensi valid. Sebagian besar ekstensi tidak memiliki kombinasi yang tidak valid sehingga ini akan menjadi no-op. Jika opsi tidak valid, maka pengecualian harus dilemparkan.
WithCommandTimeout(Nullable<Int32>)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithConnection(DbConnection)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithConnection(DbConnection, Boolean)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithConnectionString(String)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithDefaultWarningConfiguration(CoreOptionsExtension)	Menambahkan default WarningBehavior untuk peristiwa relasional.
WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithMaxBatchSize(Nullable<Int32>)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithMigrationsAssembly(String)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithMigrationsHistoryTableName(String)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithMigrationsHistoryTableSchema(String)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithMinBatchSize(Nullable<Int32>)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithUseQuerySplittingBehavior(QuerySplittingBehavior)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.
WithUseRelationalNulls(Boolean)	Membuat instans baru dengan semua opsi yang sama seperti untuk instans ini, tetapi dengan opsi yang diberikan berubah. Tidak biasa untuk memanggil metode ini secara langsung. Alih-alih gunakan DbContextOptionsBuilder.