SqlConnection.PacketSize Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan ukuran (dalam byte) paket jaringan yang digunakan untuk berkomunikasi dengan instans SQL Server.
public:
property int PacketSize { int get(); };
public int PacketSize { get; }
member this.PacketSize : int
Public ReadOnly Property PacketSize As Integer
Nilai Properti
Ukuran (dalam byte) paket jaringan. Nilai defaultnya adalah 8000.
Contoh
Contoh berikut membuat SqlConnection, termasuk mengatur Packet Size
ke 512 dalam string koneksi. Ini menampilkan PacketSize properti dan ServerVersion di jendela konsol.
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
OpenSqlConnection();
Console.ReadLine();
}
private static void OpenSqlConnection()
{
string connectionString = GetConnectionString();
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
Console.WriteLine("PacketSize: {0}", connection.PacketSize);
}
}
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;Packet Size=512";
}
}
Keterangan
Jika aplikasi melakukan operasi penyalinan massal, atau mengirim atau menerima banyak data teks atau gambar, ukuran paket yang lebih besar dari default dapat meningkatkan efisiensi karena menyebabkan lebih sedikit operasi baca dan tulis jaringan. Jika aplikasi mengirim dan menerima sejumlah kecil informasi, Anda dapat mengatur ukuran paket ke 512 byte (menggunakan nilai Ukuran Paket dalam ConnectionString), yang cukup untuk sebagian besar operasi transfer data. Untuk sebagian besar aplikasi, ukuran paket default adalah yang terbaik.
PacketSize mungkin merupakan nilai dalam rentang 512 dan 32767 byte. Pengecualian dihasilkan jika nilai berada di luar rentang ini.
Mengatur nilai default ke angka yang lebih besar dari 8000 akan menyebabkan paket menggunakan alokator MultiPage pada instans SQL Server alih-alih alokator SinglePage yang jauh lebih efisien, mengurangi skalabilitas keseluruhan SQL Server. Untuk informasi selengkapnya tentang cara SQL Server menggunakan memori, lihat Panduan Arsitektur Manajemen Memori.